Notas de lançamento do Edge para nuvem privada 4.50.00

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

Esta seção descreve a versão 4.50.00 do lançamento de recursos do Edge para nuvem privada.

Resumo da versão

A tabela a seguir resume as mudanças nesta versão:

Novos recursos

Esta versão inclui os novos recursos a seguir:

○ Informações de conexão TLS agora disponíveis em proxies de API
○ Upgrade do Zookeeper
○ Disponibilidade do portal Drupal 8 e fim da vida útil do Drupal 7

Para mais informações sobre cada um desses novos recursos, consulte Novos recursos.

Compatibilidade com versões anteriores Os seguintes problemas que afetam a compatibilidade com versões anteriores foram introduzidos nesta versão do Apigee Edge para nuvem privada:
     
  • Devido à correção do problema 132443137 (conforme descrito nas notas da versão 19.03.01 do Cloud público), os processadores de mensagens agora ignoram cabeçalhos que começam com X-Apigee-*. Como resultado, você precisa refatorar qualquer código que use cabeçalhos X-Apigee-* e substituir esses cabeçalhos por cabeçalhos compatíveis.
  • O nome dos arquivos de registro do Cassandra mudou. Agora é:

    /opt/apigee/var/log/apigee-cassandra/system.log
Versões incluídas

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

○ Edge:
   06/04/2020 (tempo de execução, gerenciamento de APIs, gerenciamento de monetização)
   27/03/2020 (interface)
   16/03/2020 (Edge Analytics)
   11/03/2020 (interface)
   27/02/2020 (monitoramento de APIs)
   24/02/2020 (interface)
   03/02/2020 (monitoramento de APIs)
   29/01/2020 (interface)
   22/01/2020 (interface)
   06/01/2020 (gerenciamento de APIs/tempo de execução)
○ Edge (continuação):
   20.01.06 (interface)
   19.11.13 (relatórios de segurança da API)
   19.10.01 (interface)
   19.09.26 (interface/portal do Edge)
   19.08.27 (interface)
   19.08.15 (relatórios de segurança da API)
   19.07.29 (interface)
○ Portal:
   20.05.27.00
   20.04.13.00
   20.03.20.00
   19.12.20.00
   19.11.21.00
   19.09.25.00
Desativações Nenhum
Suspensões de uso

Com o lançamento da versão 4.50.00:

  • 4.18.05::a versão 4.18.05 do Apigee Edge para nuvem privada foi descontinuada.

Os recursos descontinuados nesta versão incluem:

  • Suporte para proxies do Node.js e Secure Vaults
  • Suporte para políticas do OAuth v1
  • Suporte para a política de limite de taxa simultânea
  • Suporte para o adaptador da Apigee para Istio
  • Suporte para o recurso de acesso antecipado do Teams

Para mais informações sobre as descontinuações, incluindo cronogramas de remoção, consulte Descontinuações e desativações da Apigee.

Correções de bugs

Esta versão inclui as seguintes correções de bugs:

○ O processador de mensagens não carrega ambientes quando os keystores são configurados com nomes ou aliases semelhantes. (154428338)
○ Conflito de dependência do QPid ao instalar o patch (152574421)
○ O limitador de memória de cache não respeita o tamanho máximo do cache L1 (151449163)
○ Falha nos scripts de backup (150710952)
○ O servidor QPid envia mensagens de registro extras (148231209)
○ O backup do Postgresql não armazena informações de SSO (147458330)
○ A versão do apigee-nginx não foi atualizada. (146872858)
○ A mensagem "Teste a nova interface" não aparece mais (145419621)
○ Vulnerabilidade da API Apigee SmartDocs (145340106)
○ Falha no script de backup do Postgres (145254693)
○ Várias correções de segurança (142150706)
○ Alta taxa de tempos limite do roteador para o processador de mensagens (138107618)
○ Falha no script de configuração do SSO (135616498)
○ Portas JMX (132044907)
○ Erros 404 intermitentes para tráfego de tempo de execução devido a uma disputa (130653816)
○ Corrupção do OpenLDAP durante o upgrade (120799182)
○ DataAccessException em várias configurações de data center (76087166)
○ FormatMessage definido como "false" na política MessageLogging não funciona (68722102)

Para mais informações sobre cada uma dessas correções, consulte Correções de bugs.

Problemas conhecidos

Esta versão inclui os seguintes problemas conhecidos:

○ Falha na validação do JWT (159788170)
○ Vazamento de memória dos servidores de classificação do Mint (137865184)
apigee-monit não é compatível com o Amazon Linux 1 (122370980)
○ O backup do processador de mensagens não faz backup do conjunto correto de arquivos (121095148)
○ Aumento da proporção de erros de cache após o upgrade (160109014)
○ Resposta HTTP 408 para solicitação GET com corpo vazio e Content-Encoding: gzip. (159858015)

Para mais informações sobre cada um desses problemas conhecidos, incluindo soluções alternativas, consulte Problemas conhecidos.

Caminhos de upgrade

O

A tabela a seguir mostra os caminhos de upgrade para esta versão:

De 4.19.01 ou 4.19.06 Faça o upgrade direto da versão 4.19.01/4.19.06 para a 4.50.00
A partir da versão 4.18.05 Fazer upgrade direto da versão 4.18.05 para a 4.50.00

Novos recursos

Esta seção lista os novos recursos desta versão. Além disso, esta versão inclui todos os recursos das versões da interface do Edge, do gerenciamento do Edge e do portal listados em Versões incluídas.

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

Informações de conexão TLS agora disponíveis em proxies de API

Durante uma solicitação para um proxy de API por um host virtual compatível com TLS, o Edge pode capturar informações sobre a conexão TLS. O proxy de API agora pode acessar essas informações por variáveis de fluxo para realizar análises e validações adicionais. Consulte Como acessar informações de conexão TLS em um proxy de API para mais detalhes.

Upgrade do Zookeeper

Esta versão contém o Zookeeper 3.4.14.

Disponibilidade do portal Drupal 8 e fim da vida útil do Drupal 7

O Drupal 8 sucedeu o Drupal 7 como o portal do desenvolvedor recomendado pela Apigee para a nuvem privada. Como o Drupal 7 vai chegar ao fim do suporte de longo prazo em novembro de 2021, os módulos do Apigee para Drupal 7 não serão mais compatíveis a partir de novembro de 2021. Embora ainda estejam disponíveis, os scripts de instalação/upgrade do Drupal 7 não devem mais ser usados e serão removidos em uma versão futura.

Para saber mais sobre os módulos do Drupal 8 que se integram à Apigee, consulte: Criar seu portal usando o Drupal 8.

Software compatível

Esta versão inclui as seguintes mudanças no software compatível:

Suporte adicionado Não há mais suporte

Esta versão adiciona suporte às seguintes plataformas:

  • Red Hat Enterprise Linux (RHEL) 7.8
  • CentOS 7.8
  • Oracle Linux 7.8

As seguintes plataformas não são mais compatíveis com esta versão:

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

Para conferir uma lista completa de plataformas compatíveis, consulte Software compatível e versões compatíveis.

Correções de bugs

Esta seção lista os bugs do Private Cloud corrigidos nesta versão. Além disso, esta versão inclui todas as correções de bugs nas versões da interface do Edge, do gerenciamento do Edge e do portal mostradas em Versões incluídas.

ID do problema Descrição
154428338

O processador de mensagens não carrega ambientes quando os keystores são configurados com nomes ou aliases semelhantes.

Corrigimos um conflito de pesquisa de regex ao carregar keystores com convenções de nomenclatura semelhantes. Isso fazia com que o processador de mensagens não carregasse ambientes associados ao keystore ou não fosse iniciado quando vários keystores conflitantes eram retornados durante a pesquisa.
152574421

Conflito de dependência do QPid ao instalar o patch

A versão correta do QPid agora está instalada.
151449163

O limitador de memória em cache não respeita o tamanho máximo do cache L1

O limitador de memória do cache agora respeita o tamanho máximo do cache L1.
150710952

Falha nos scripts de backup

O procedimento de backup foi atualizado com base nos scripts de backup atualizados.
148231209

Servidor QPid enviando mensagens de registro extras

O servidor QPid não envia mais mensagens de registro extras.
147458330

O backup do Postgresql não armazena informações de SSO

O backup do PostgreSQL agora armazena informações de SSO.
146872858

A versão do apigee-nginx não foi atualizada.

A versão do apigee-nginx agora é atualizada corretamente.
145419621

A mensagem "Testar a nova interface" não aparece mais

A mensagem "Testar a nova interface" não aparece mais na interface.
145340106

Vulnerabilidade da API SmartDocs do Apigee

Atualizamos o proxy do Apigee SmartDocs para resolver uma vulnerabilidade de segurança. Consulte o procedimento de instalação do SmartDocs para mais informações e etapas necessárias.
145254693

Falha no script de backup do Postgres

O script de backup do Postgres agora funciona corretamente.
142150706

Várias correções de segurança

Correções de problemas de segurança, incluindo #111390246.
138107618

Alta taxa de tempos limite do roteador para o processador de mensagens

O problema já foi resolvido.
135616498

Falha no script de configuração do SSO

Foi corrigido um problema em que o uso de URLs de esquema de arquivo causava falha no script de configuração do SSO.
132044907

Portas JMX

As portas JMX não devem estar abertas para acesso externo, apenas para servidores internos.
130653816

Erros 404 intermitentes para tráfego de tempo de execução devido a uma condição de disputa

Correção de uma condição de disputa durante a inicialização do MP, que fazia com que alguns proxies não fossem implantados corretamente.
120799182

Corrupção do OpenLDAP durante o upgrade

O problema já foi resolvido.
76087166

DataAccessException em várias configurações de data center

Em configurações de vários data centers, se um repositório de dados ficar indisponível, o erro DataAccessException não vai mais aparecer.
68722102

O FormatMessage definido como "false" na política MessageLogging não está funcionando

Agora é possível definir "FormatMessage" como "false" na política MessageLogging.

Problemas conhecidos

A tabela a seguir lista os problemas conhecidos nesta versão:

ID do problema Descrição
159788170

Falha na validação do JWT

A validação de JWT falha para chaves RSA menores que 2.048 bits.

Alternativa:

Verifique se as chaves são de 2.048 bits ou maiores.
137865184

Vazamento de memória nos servidores de classificação do Mint

Quando uma nova instância do Qpid é registrada em um mxgroup, as filas são criadas sem consumidores, o que resulta no aumento da profundidade da fila até que ela use todos os recursos disponíveis.

Alternativa:

Nenhum.
122370980

apigee-monit não é compatível com o Amazon Linux 1

Alternativa:

Nenhum.
121095148

O backup do processador de mensagens não faz backup do conjunto correto de arquivos

Alternativa:

Execute o backup uma segunda vez para fazer backup do conjunto correto de arquivos.

160109014

Aumento da proporção de ausências no cache após o upgrade

Depois do upgrade para a versão 4.50.00, os proxies podem apresentar uma taxa de falha de cache maior. Essas falhas podem ser acompanhadas de um aumento nas mensagens de erro nos registros da MP, semelhantes a:

InvalidClassException when fetching cps cache entry from second level - com.apigee.jsonparser.LinkedJSONObject; local class incompatible: stream classdesc serialVersionUID = -8575741446425131573, local class serialVersionUID = 752634431212433936. Considering it as cache miss.

Alternativa:

Nenhum. A proporção de ocorrência em cache deve se estabilizar com o tempo.

159858015

Resposta HTTP 408 para solicitação GET com corpo vazio e Content-Encoding: gzip.

Um cliente da API vai receber uma resposta de tempo limite 408 quando fizer uma solicitação GET com o cabeçalho Content-Encoding: gzip e um corpo de solicitação vazio.

Alternativa:

Omita o cabeçalho Content-Encoding ao fazer solicitações GET com um corpo vazio.

Próxima etapa

Para começar a usar o Edge para nuvem privada 4.50.00, use os seguintes links:

Novas instalações:
Nova visão geral da instalação
Instalações existentes:
Fazer upgrade dos caminhos