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

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. informações

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

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

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

Novos recursos e melhorias

Veja a seguir os novos recursos e melhorias desta versão. Além das melhorias a seguir, esta versão também contém 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 on-line

Acesse 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 é obrigatório no ambiente.
    Como parte da atualização para o Java 8, algumas criptografias TLS não estão mais disponíveis no Oracle JDK 1.8. Para ver a lista completa, consulte a seção "Pacotes de criptografia padrão desativados" 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

Veja a seguir uma lista de mudanças na instalação, no upgrade e nos scripts 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.
  • Inicialização
    • bootstrap.sh (a versão 4.16.01) agora é bootstrap_4.16.05.sh na 4.16.05.
    • Não é mais necessário especificar uname:pword para fazer o download de bootstrap_4.16.05.sh.
  • Rollback: 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 reversão.
  • 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 executa o utilitário não tiver acesso a esse diretório, ele vai gravar o registro no diretório /tmp. Se o usuário não tiver acesso ao /tmp, o utilitário falhará.
  • Procedimento de atualização do BaaS da API: na versão 4.16.01, foi necessário reinstalar o BaaS da API para migrá-la. 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 a seguir os novos recursos para administração e configuração de nuvem privada.

  • Validação da instalação: o utilitário apigee-validate usado para testar a instalação da nuvem privada do Edge 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 estava no formato "dc-#", em que # era um valor inteiro.
  • Pods de gateway: os pods de gateway podem ter qualquer nome. Nas versões anteriores, o pod precisava ser nomeado como "gateway".
  • Administração baseada em script: um novo utilitário de linha de comando apigee-adminapi.sh permite que você execute as mesmas tarefas de configuração do Edge fazendo chamadas para a API de gerenciamento de borda. Consulte Como usar o utilitário apigee-adminapi.sh.
  • Configuração silenciosa de SSL do host virtual: ao criar uma organização ou um ambiente, agora é possível transmitir propriedades para configurar o SSL em um host virtual. Consulte Integrar uma organização.

Serviços da API

Confira a seguir os novos recursos para os serviços da API Edge, que foram entregues nas versões anteriores do produto na nuvem.

Prefixo de tamanho fixo para registro de mensagens syslog (Cloud 16.03.30)

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

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

A IU de gerenciamento é compatível com o uso de um ou mais caracteres curinga /*/ nos caminhos 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ê tenha que criar um novo proxy para oferecer suporte a novas equipes. Observe que /**/ 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 de proxy de API local, o que permite que um proxy de API chame outro proxy de API implantado na organização do Edge sem sobrecarga extra na rede. Antes, o encadeamento do proxy de API exigia uma chamada http(s) para outro proxy de API, que encaminhava a solicitação por meio de 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 quando você adiciona ou atualiza um TargetEndpoint.

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

Para mais informações, consulte Como encadear 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 verificam se os tíquetes de suporte foram corrigidos. Ela não foi projetada 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 falha ao registrar o servidor em espera do Postgres no axgroup.
PRC-758 O usuário com função do usuário pode editar relatórios personalizados
PRC-883 A atualização do servidor Postgres com a configuração mestre em espera está falhando

Nuvem 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 termina em "keys"
MGMT-3214 Conflitos de classe podem ocorrer durante JavaFrases de destaque fazendo com que o código Java de um cliente falhe
MGMT-3185 Erro ao adicionar administradores da organização a uma organização
EDGEUI-127 Recebendo permissões insuficientes com o novo editor de proxy
EDGEUI-119 Problema de tempo limite da sessão de interface
CORESERV-671 Exibição de 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 cps
AXAPP-2302 O resumo diário das análises da Apigee mostra que não há adesão dos desenvolvedores
APIRT-2750 Falhas de tráfego altas em uma organização específica
APIRT-2516 Os erros de tempo de execução em frases de destaque JavaScript especificam números de linha incorretos
APIRT-2508 Erro de saída ao chamar a detecção expressa em um callback do Vault
APIRT-2336 Problema do Gzip com o 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 estão carregando no painel do Error Analysis (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 estão carregando no painel do Error Analysis
MGMT-3118 A interface mostra uma configuração incorreta do host virtual SSL para o parâmetro "clientAuthEnabled"
DEVRT-2344 As definições de relatório 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 cinco atributos em vez dos 10 permitidos
DEVRT-1275 Nem todos os desenvolvedores são exibidos no menu suspenso do plano de tarifa.
DEVRT-1074 O desenvolvedor de planos pré-pagos com saldo zero gera uma NullpointerException quando o crédito é aplicado

Nuvem 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 a partir de um WSDL que usa o namespace padrão
MGMT-1642 A função do usuário personalizada não tem a permissão "get" para apps do desenvolvedor

Problemas conhecidos

Esta versão tem os problemas conhecidos a seguir.

Id do problema Descrição
APIRT-2978

O roteador falha ao iniciar o Nginx ou o roteador não inicia

Se o roteador de borda falhar ou não iniciar o Nginx, 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 processador de mensagens faz buscas DNS no IPv4 e IPv6

Se você instalou e ativou o NSCD (Name Service Cache Daemon), os processadores de mensagens fazem duas buscas DNS: uma para IPv4 e outra para IPv6.

Para desativar a busca DNS no IPv6:

  1. Em cada nó 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 vir um erro no formato:

ERRO: precisa ser o 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 de dependências de pacote conhecido, o agente do Katello usado no Satellite Server 6 não será instalado corretamente nos hosts do Apigee Edge que executam o daemon Qpid.

Payloads do JSON em políticas "Atribuir mensagem", "Frase de destaque Java" e "Aumentar falha"

As políticas "Atribuir mensagem", "Frase de destaque Java" e "Aumentar falha" permitem gerar conteúdo de mensagem usando o elemento <Set><Payload>. Como parte dessas mensagens, é possível incluir variáveis com valores preenchidos automaticamente no ambiente de execução. Por exemplo, para gerar a data do cabeçalho HTTP, insira {message.header.date} na mensagem.

Se o formato da mensagem for JSON, ela será parecida com esta:

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

No entanto, ele é um JSON incorreto. Para contornar esse problema, você tem duas opções:

  • Escape da chave de abertura com uma barra invertida: 
    \{"The date is: " : "{message.header.date}"}
  • Na configuração do elemento de 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 do recurso Edge para nuvem privada, será possível usar chaves para variáveis em mensagens JSON sem problemas. APIRT-1160

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

Se o roteador de borda não iniciar o Nginx ou falhar, 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
4.16.05.01
Próxima
4.16.01.08