4.51.00.12 - Notas da versão do Edge para nuvem privada

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

Em 30 de março de 2023, lançamos uma nova versão do Apigee Edge para nuvem privada.

Observação:essa versão terá suporte até 30 de março de 2024.

Procedimento de atualização

Esta seção descreve como instalar essa versão se você estiver atualizando da versão de patch anterior, 4.51.00.11. Se você precisar atualizar de uma versão anterior, consulte Como aplicar várias versões de patch.

A instalação dessa versão vai atualizar os componentes na lista de RPMs a seguir:

  • edge-gateway-4.51.00-0.0.60186.noarch.rpm
  • edge-management-server-4.51.00-0.0.60186.noarch.rpm
  • edge-postgres-server-4.51.00-0.0.60186.noarch.rpm
  • edge-qpid-server-4.51.00-0.0.60186.noarch.rpm
  • edge-router-4.51.00-0.0.60186.noarch.rpm
  • apigee-postgresql-10.17-0.0.2535.noarch.rpm
  • edge-mint-gateway-4.51.00-0.0.40322.noarch.rpm
  • edge-mint-management-server-4.51.00-0.0.40322.noarch.rpm
  • edge-mint-message-processor-4.51.00-0.0.40322.noarch.rpm
  • apigee-sso-4.51.00-0.0.21244.noarch.rpm
  • apigee-attribution-4.51.00-0.0.723.noarch.rpm
  • apigee-sosreport-5.0-0.0.2508.noarch.rpm

Para verificar se as versões do RPM instaladas precisam ser atualizadas, insira:

apigee-all version

Para atualizar a instalação, siga este procedimento nos nós do Edge:

  1. Em todos os nós do Edge:

    1. Limpe os repositórios do Yum:
      sudo yum clean all
    2. Faça o download do arquivo mais recente do Edge 4.51.00 bootstrap_4.51.00.sh para /tmp/bootstrap_4.51.00.sh:
      curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
    3. Instale o utilitário apigee-service do Edge 4.51.00 e as dependências:
      sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

      em que uName e pWord são o nome de usuário e a senha que você recebeu da Apigee. Se você omitir pWord, será solicitado que o insira.

    4. Use o comando source para executar o script apigee-service.sh:
      source /etc/profile.d/apigee-service.sh
  2. Atualize os nós do Postgres (principal e em espera):
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Em todos os nós do Edge, execute o script update.sh para o processo do Edge:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. Execute o script update.sh para SSO em todos os nós:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile

Novos recursos

Esta versão apresenta o novo recurso a seguir:

TLS 1.3 para tráfego de saída

Esta versão adiciona suporte ao TLS 1.3 para tráfego de saída (tráfego entre um processador de mensagens e o servidor de back-end). Consulte Como configurar o TLS 1.3 para tráfego de saída para mais informações.

Problemas de segurança corrigidos

Não há problemas de segurança corrigidos nesta versão.

Mudanças no software com suporte

Não há mudanças no software com suporte nesta versão.

Descontinuações e desativações

Não há novas descontinuações ou desativações nesta versão.

Correções de bugs

Esta seção lista os bugs da nuvem privada que foram corrigidos nesta versão.

ID do problema Descrição
197529839

A falta de espaços à direita após os operadores de condição estava causando falhas de implantação.

Isso foi corrigido com o tratamento aprimorado de novas linhas em instruções de condição de proxies.
269545512

Versão atualizada do driver do Postgres no gateway e na monetização para 42.5.4.

193007714

Algumas propriedades estavam ausentes quando os detalhes de destino de um proxy eram buscados como JSON.

Isso foi corrigido.
245387101

Dados de auditoria modificados de APIs relacionadas a apps de desenvolvedor.

O secret de cliente agora é registrado de maneira consistente de forma mascarada. Você pode definir CWC conf_keymanagement_app.auditlog.mask.secret como "false" no servidor de gerenciamento para evitar que o secret seja mascarado, caso queira registrar o secret de texto simples na auditoria.
260013493

Adicionamos correções para otimizar o carregamento de recursos de especificação da API aberta como parte da política OASValidation.

Isso acelera o tempo de inicialização do processador de mensagens se o MP precisar carregar muitos recursos do OAS. Isso também evita que erros desnecessários e registros de aviso sejam gerados ao carregar os proxies que contêm recursos do OAS.
274587823

As entidades externas não podem ser carregadas por padrão na política XSLTransform.

Isso pode ser ativado definindo a flag conf_feature-flags_xsl.allow.external.entities=true no processador de mensagens.
260714664

Algumas tabelas do Cassandra ainda estavam usando SizeTieredCompactionStrategy por padrão.

Isso foi alterado para LeveledCompactionStrategy. Essa mudança só é aplicável a novas instalações do Apigee Edge para nuvem privada.
261631942

Corrigimos uma pequena regressão em um script de pré-instalação de apigee-postgresql em que o backup de arquivos de configuração falhava em algumas condições.

258898812

Removemos o parâmetro inesperado credentialsLoaded da resposta da API de busca de apps.

272136041

Os campos de API a seguir, que foram adicionados recentemente à Apigee, estão visíveis no Edge para nuvem privada. No entanto, eles não têm efeito no Edge para nuvem privada, portanto, você pode ignorá-los com segurança se os encontrar.

  • proxy_deployment_type
  • sense_action_id
  • sense_flag_headers
  • x_apigee_grpc_status
  • x_apigee_grpc_service_name
  • x_apigee_grpc_rpc_name

Problemas conhecidos

Consulte Problemas conhecidos com o Edge para nuvem privada para conferir uma lista completa de problemas conhecidos.

Como aplicar várias versões de patch

Esta seção descreve como aplicar várias versões de patch, caso você esteja atualizando de uma versão do Edge para nuvem privada anterior à versão de lançamento patch anterior.

Cada versão de patch contém atualizações para componentes específicos do Edge para nuvem privada, como edge-management-server. Para aplicar várias versões de patch, é necessário atualizar cada componente do Edge incluído em uma versão de patch posterior à versão instalada. Para encontrar esses componentes, consulte as notas de lançamento do Edge para nuvem privada de todas as versões posteriores à sua e verifique a lista de RPMs dessas versões. Consulte as Notas de lançamento da Apigee para conferir links para todas as notas de lançamento do Edge para nuvem privada.

Observação: só é necessário atualizar cada componente uma vez, instalando o RPM da versão mais recente do componente incluído nas versões de patch. Siga as instruções nas notas de lançamento dessa versão para atualizar o componente.

Observação: o upgrade de um componente instala automaticamente a versão de patch mais recente de um componente. Se você quiser fazer upgrade para uma versão de patch que não seja a mais recente, será necessário manter sua própria cópia do tarball do repositório da Apigee usando o espelho da Apigee e usar esse espelho para instalações da Apigee. Para mais informações, consulte Usar um repositório local do Edge para manter a versão do Edge.