4.16.05 - Notas da versão do Edge for Private Cloud

Você está lendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. info

Na terça-feira, 31 de maio de 2016, lançamos uma nova versão do Apigee Edge para nuvem privada.

Desde a versão de recursos anterior do Edge para nuvem privada (4.16.01), as seguintes versões foram lançadas e estão incluídas nesta versão de recursos:

Consulte Sobre a numeração de versões para entender como descobrir se uma versão específica da nuvem está incluída na sua versão do Edge para nuvem privada.

Novos recursos e melhorias

Confira a seguir os novos recursos e melhorias desta versão. Além das melhorias a seguir, esta versão também inclui várias melhorias de usabilidade, desempenho, segurança e estabilidade.

Para mais detalhes e instruções, consulte a documentação do Edge para nuvem privada.

Guias de instalação e operações movidos para a Web

Agora você pode acessar o guia de instalação e operações do Edge para nuvem privada na versão 4.18.01.

Atualizações de software

As seguintes atualizações de software estão incluídas na versão:

  • Java JDK 1.8: para aproveitar os recursos mais recentes do Java, esta versão é compatível com o Java 1.8. O Oracle JDK 1.8 ou o OpenJDK 8 são necessários no seu ambiente.
    Como parte da atualização para o Java 8, algumas cifras TLS não estão mais disponíveis no Oracle JDK 1.8. Para conferir a lista completa, consulte a seção "Default Disabled Cipher Suites" http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
  • Cassandra 2.1.13: atualizado do Cassandra 2.0.15.

Instalação, upgrade, reversão

Confira a seguir uma lista de mudanças nos scripts de instalação, upgrade e relacionados. Para informações sobre o uso, consulte a documentação do Edge para nuvem privada.

  • Novo processo para atualizar da versão 4.16.01: esta versão substitui o utilitário apigee-migrate pelo utilitário update.sh para atualizar sua instalação da versão 4.16.01 para a 4.16.05. Consulte Atualizar o Apigee Edge 4.16.01 para 4.16.05.
  • Bootstrap
    • bootstrap.sh (versão 4.16.01) agora é bootstrap_4.16.05.sh na versão 4.16.05.
    • Não é mais necessário especificar uname:pword para baixar bootstrap_4.16.05.sh.
  • Reversão: para reverter uma atualização para a versão 4.16.05, desinstale a versão 4.16.05 do componente e reinstale a versão anterior. O utilitário rollback.sh anterior foi removido. Consulte 4.16.05 Processo de rollback.
  • setup.sh e update.sh podem gravar o arquivo de registros em /tmp: por padrão, os utilitários setup.sh e update.sh gravam informações de registro em /opt/apigee/var/log/apigee-setup. Se o usuário que estiver executando o utilitário não tiver acesso a esse diretório, o registro será gravado no diretório /tmp. Se o usuário não tiver acesso a /tmp, o utilitário vai falhar.
  • Procedimento de atualização do API BaaS: na versão 4.16.01, era necessário reinstalar o API BaaS para migrar. O novo utilitário update.sh oferece suporte à atualização do BaaS da API no local. Consulte Atualizar o Apigee Edge 4.16.01 para 4.16.05.

Administração

Confira abaixo os novos recursos para administração e configuração da nuvem privada.

  • Validação da instalação - O utilitário apigee-validate usado para testar a instalação do Edge Private Cloud agora pode ser executado no servidor de gerenciamento. Antes, o script precisava ser executado no processador de mensagens. Consulte Testar a instalação.
  • Nome da região: pode ser qualquer nome. Nas versões anteriores, o nome era no formato "dc-#", em que # era um valor inteiro.
  • Pods do gateway: podem ter qualquer nome. Em versões anteriores, o pod precisava ser chamado de "gateway".
  • Administração baseada em script: um novo utilitário de linha de comando apigee-adminapi.sh permite realizar as mesmas tarefas de configuração do Edge que você faz ao chamar a API de gerenciamento do Edge. Consulte Como usar o utilitário apigee-adminapi.sh.
  • Configuração silenciosa de SSL de host virtual: ao criar uma organização ou ambiente, agora é possível transmitir propriedades para configurar o SSL em um host virtual. Consulte Integrar uma organização.

Serviços da API

Confira abaixo os novos recursos dos serviços de API do Edge, que foram disponibilizados em versões anteriores do produto na nuvem.

Prefixo de comprimento fixo para o registro de mensagens do syslog (Cloud 16.03.30)

A política de registro de mensagens tem um novo elemento <FormatMessage> na configuração do Syslog. Ao definir <FormatMessage>true</FormatMessage>, as mensagens do Syslog começam com um número fixo de caracteres, o que permite filtrar os dados inseridos pela Apigee. Para mais informações, consulte a política de geração de registros de mensagens. (APIRT-1398)

Caractere curinga no caminho base do proxy de API (interface do Cloud 16.03.09)

A interface de gerenciamento aceita o uso de um ou mais caracteres curinga /*/ nos caminhos de base do proxy de API. Por exemplo, um caminho base de /team/*/members permite que os clientes chamem seu proxy com https://[host]/team/blue/members ou https://[host]/team/green/members sem que você precise criar um novo proxy para dar suporte a novas equipes. /**/ não é permitido. (MGMT-3154)

Encadeamento de proxy de API (Cloud 16.03.02, interface do Cloud 16.03.09)

O Edge oferece suporte ao encadeamento local de proxies de API, o que permite que um proxy de API chame outro proxy de API implantado na sua organização do Edge sem sobrecarga de rede adicional. Antes, o encadeamento de proxy de API exigia uma chamada http(s) para outro proxy de API, que encaminhava a solicitação por um balanceador de carga, um roteador e um processador de mensagens.

Novos elementos LocalTargetConnection estão disponíveis no TargetEndpoint de um proxy de API, permitindo especificar um nome de proxy de API, o nome de um ProxyEndpoint específico em um proxy de API ou simplesmente o caminho base para um recurso de proxy de API local (como /v1/myresource). A interface do editor de proxy também oferece essas opções ao adicionar ou atualizar um TargetEndpoint.

O encadeamento de proxy também está disponível nas políticas de destaque de serviço.

Para mais informações, consulte Como unir proxies de API. Os novos elementos LocalTargetConnection também estão listados no esquema XML aqui: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd. (MGMT-3049, MGMT-3050)

Bugs corrigidos

Os bugs abaixo foram corrigidos nesta versão. Esta lista serve principalmente para usuários que querem verificar se os tíquetes de suporte foram corrigidos. Ela não foi criada para fornecer informações detalhadas a todos os usuários.

Edge para nuvem privada 4.16.05

ID do problema Descrição
PRC-770 O instalador 16.01 não registra o servidor de espera do Postgres em axgroup
PRC-758 Usuários com a função "Usuário" podem editar relatórios personalizados
PRC-883 A atualização no servidor Postgres com configuração principal-standby está falhando

Cloud 16.03.30

ID do problema Descrição
SECENG-584 A verificação de validação para nova linha entre certificados em uma cadeia de certificados causa problemas com alguns certificados em produção
MGMT-3217 As chamadas da API Management falham se o nome do KVMap terminar em "keys"
MGMT-3214 Conflitos de classe podem ocorrer durante as chamadas Java, fazendo com que o código Java de um cliente falhe
MGMT-3185 Erro ao adicionar administradores a uma organização
EDGEUI-127 Receber permissões insuficientes com o novo editor de proxy
EDGEUI-119 Problema de tempo limite da sessão da interface
CORESERV-671 Recebendo erros "Nenhum toque configurado; não é possível inicializar o serviço cps"
AXAPP-2345 Problema ao listar relatórios personalizados do AX para clientes que não são do CPS
AXAPP-2302 O resumo diário do Apigee Analytics mostra zero em "Adoção por desenvolvedores"
APIRT-2750 Muitas falhas de tráfego em uma organização específica
APIRT-2516 Erros de ambiente de execução em callouts do JavaScript especificam números de linha incorretos
APIRT-2508 Erro de saída ao chamar o listener do Express em um callback do cofre
APIRT-2336 Problema do Gzip com Node.js
APIRT-1975 As configurações de máscara não estão funcionando para "message.content"

Interface do Cloud 16.03.16

ID do problema Descrição
MGMT-3142 Os gráficos não carregam no painel de análise de erros (correção atualizada)

Interface do Cloud 16.03.09

ID do problema Descrição
MGMT-3158 Permissões insuficientes na interface quando o RBAC em proxies individuais é definido pela API
MGMT-3142 Os gráficos não carregam no painel de análise de erros
MGMT-3118 A interface mostra uma configuração incorreta de host virtual SSL para o parâmetro "clientAuthEnabled"
DEVRT-2344 As definições de relatórios de um único dia não carregam transações na interface

Cloud 16.03.02

ID do problema Descrição
MGMT-3083 A atualização automática de registros do Node.js é muito detalhada com mensagens de registro
DEVRT-2275 Os planos de tarifas de atributos personalizados mostram apenas 5 atributos em vez dos 10 permitidos
DEVRT-1275 Nem todos os desenvolvedores aparecem no menu suspenso "Plano de tarifas"
DEVRT-1074 O desenvolvedor pré-pago com saldo zero gera NullpointerException quando o crédito é aplicado

Cloud 16.02.17

ID do problema Descrição
MGMT-3083 A atualização automática de registros do Node.js é muito detalhada com mensagens de registro
MGMT-3077 A interface gera um pacote de proxy inválido de um WSDL que usa o namespace padrão
MGMT-1642 A função de usuário personalizada não tem a permissão "get" para apps de desenvolvedores

Problemas conhecidos

Esta versão tem os seguintes problemas conhecidos.

ID do problema Descrição
APIRT-2978

Falha ao iniciar o Nginx ou o roteador

Se o roteador de borda não iniciar o Nginx ou não iniciar de forma alguma, conforme mostrado no arquivo /opt/apigee/var/log/edge-router/logs/system.log, exclua todos os arquivos no diretório /opt/nginx/conf.d e reinicie o roteador:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
APIRT-3364

O Message Processor faz pesquisas de DNS em IPv4 e IPv6

Se você instalou e ativou o NSCD (daemon de cache de serviço de nomes), talvez perceba que os processadores de mensagens fazem duas pesquisas de DNS: uma para IPv4 e outra para IPv6.

Para desativar a busca DNS no IPv6:

  1. Em todos os nós do processador de mensagens, edite /etc/nscd.conf.
  2. Defina a seguinte propriedade:

    enable-cache hosts no
PRC-1118

Erro ao executar o comando "apigee-service apigee-postgresql pg-data-purge"

Se você executar o comando "apigee-service apigee-postgresql pg-data-purge" e encontrar um erro no formato:

ERRO: é necessário ser proprietário da relação

Edite /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge e defina a seguinte propriedade como "apigee":

POSTGRES_USER=apigee
DOC-1687 Devido a um conflito conhecido de dependência de pacote, o agente do Katello usado no Satellite Server 6 não será instalado corretamente em hosts do Apigee Edge que executam o daemon Qpid.

Payloads JSON nas políticas Assign Message, Java Callout e Raise Fault

As políticas "Atribuir mensagem", "Chamada Java" e "Gere falha" permitem gerar conteúdo de mensagem usando o elemento <Set><Payload>. Como parte dessas mensagens, você pode incluir variáveis cujos valores são preenchidos automaticamente no ambiente de execução. Por exemplo, se você quiser mostrar a data do cabeçalho HTTP, insira {message.header.date} na sua mensagem.

Se o formato da mensagem for JSON, ela terá esta aparência:

{"The date is: " : "{message.header.date}"}

No entanto, é possível ver que esse JSON está malformado. Para contornar esse problema, você tem duas opções:

  • Faça o escape da chave de abertura com uma barra invertida: 
    \{"The date is: " : "{message.header.date}"}
  • Na configuração do elemento "Payload", use os atributos variablePrefix e variableSuffix para indicar uma variável em um payload JSON. Por exemplo:
    <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>

Na próxima versão de recursos do Edge para Private Cloud, você poderá usar chaves para variáveis em mensagens JSON sem problemas. (APIRT-1160)

O roteador não inicia o Nginx ou o roteador não inicia

Se o roteador de borda não iniciar o Nginx ou não iniciar de forma alguma, conforme mostrado no arquivo /opt/apigee/var/log/edge-router/logs/system.log, exclua todos os arquivos no diretório /opt/nginx/conf.d e reinicie o roteador:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
Anterior
16/04/2001
Avançar
16/04/2008