4.52.02.04 - 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 25 de julho de 2025, lançamos uma nova versão do Apigee Edge para nuvem privada.

Procedimento de atualização

Esta seção descreve como instalar esta versão se você estiver atualizando da versão anterior do Edge para nuvem privada. Se você precisar atualizar de uma versão anterior, consulte Como aplicar várias versões de patch.

Ao atualizar esta versão, os componentes listados abaixo também serão atualizados:

• edge-gateway-4.52.02-0.0.60308.noarch.rpm
• edge-management-server-4.52.02-0.0.60308.noarch.rpm
• edge-message-processor-4.52.02-0.0.60308.noarch.rpm
• edge-postgres-server-4.52.02-0.0.60308.noarch.rpm
• edge-qpid-server-4.52.02-0.0.60308.noarch.rpm
• edge-router-4.52.02-0.0.60308.noarch.rpm
• apigee-cassandra-3.11.16-0.0.2596.noarch.rpm
• apigee-cassandra-client-3.11.16-0.0.2544.noarch.rpm
• apigee-lib-4.52.02-0.0.1028.noarch.rpm
• apigee-setup-4.52.02-0.0.1150.noarch.rpm
• apigee-qpidd-8.0.6-0.0.2537.noarch.rpm

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

apigee-all version

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

1. Em todos os nós de borda:

   1. Limpe os repositórios do Yum:

      sudo yum clean all

   2. Faça o download do arquivo bootstrap_4.52.02.sh mais recente do Edge 4.52.02 em /tmp/bootstrap_4.52.02.sh:

      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

   3. Instale o utilitário apigee-service e as dependências do Edge 4.52.02:

      sudo bash /tmp/bootstrap_4.52.02.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 você o insira.

   4. Use o comando source para executar o script apigee-service.sh:

      source /etc/profile.d/apigee-service.sh

   5. Atualize o utilitário apigee-setup:

      apigee-service apigee-setup update

2. Em todos os nós do Cassandra, execute o script update.sh:

   /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

3. Em todos os nós de borda, execute o script update.sh para o processo de borda:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

4. Em todos os nós do Qpid, execute o script update.sh:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

Correções de bugs

Esta seção lista os bugs do Private Cloud corrigidos nesta versão.

Problemas de segurança corrigidos

Nenhum novo problema de segurança foi adicionado nesta versão.

Mudanças no software compatível

Foi adicionada compatibilidade com o Amazon-Linux-2023.7(AL2023.7).

Consulte Software compatível com o Edge para nuvem privada para uma lista completa.

Descontinuações e desativações

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

Novos recursos

Esta seção lista os novos recursos desta versão.

Integração do conector do hub de APIs do Edge para nuvem privada

Esta versão inclui suporte ao conector do hub de APIs da Apigee para integração da nuvem privada, permitindo que as organizações sincronizem metadados de API e análises de ambiente de execução com o hub de APIs do Google Cloud. A integração inclui um novo conector binário do hub de APIs da Apigee e melhorias no processador de mensagens, que exporta dados de tempo de execução para um sistema de arquivos de rede (NFS). O conector do hub de APIs para nuvem privada consome esses dados e os publica no hub de APIs. Não há correções de bugs nem mudanças no comportamento atual do Apigee Edge para nuvem privada. Para mais informações sobre a integração do conector do hub de APIs do Edge para nuvem privada, consulte Visão geral e fluxo da integração do conector do hub de APIs.

Principais destaques:

• Novo binário do conector do hub de APIs da Apigee
• Melhorias no processador de mensagens para exportar dados de tempo de execução para NFS
• Suporte completo para publicação de metadados de API e dados de ambiente de execução no hub de APIs
• Ativação com base em aceitação usando o conector padrão do hub de APIs da Apigee para o fluxo de API da nuvem privada
• Nova integração de API com o conector para oferecer suporte ao upload de ambientes e pacotes de proxy
• Agora, uma nova permissão do IAM (roles/apihub.admin) é necessária para que a conta de serviço do conector ative a nova funcionalidade da API.

Mascaramento de informações de identificação pessoal (PII)

Esse recurso garante a privacidade e a conformidade dos dados, permitindo mascarar dados sensíveis em pacotes de fluxo compartilhado e proxy de API antes da sincronização com o Hub de API.

• Máscaras padrão:o conector aplica automaticamente uma lista integrada de expressões XPath (máscaras padrão) para mascarar fontes de PII conhecidas em configurações de política (como senhas de autenticação básica codificadas, chaves privadas em políticas JWT/JWS).
• Máscaras personalizadas:é possível configurar outras máscaras personalizadas definindo a propriedade conf_uapim_connector.uapim.mask.xpaths no arquivo /opt/apigee/customer/application/uapim-connector.properties, o que permite segmentar campos sensíveis específicos do cliente.

Reconciliação da organização

O conector agora oferece um processo definido para reconciliar (ou preencher) todo o conjunto de metadados de API de uma organização da Apigee com o hub de APIs.

• Processo:a conciliação é feita desativando temporariamente uma organização da configuração do conector (limpando os valores das propriedades runtimeDataPubsub e metadataPubsub) e ativando-a imediatamente (restaurando os valores).
• Função:essa ação força o conector a realizar uma busca completa e uma ressincronização total de todos os metadados da organização especificada, resolvendo possíveis inconsistências de dados.

Problemas conhecidos

Consulte Problemas conhecidos com o Edge para nuvem privada para 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 no momento. Para encontrar esses componentes, consulte as notas da versão do Edge para nuvem privada de todas as versões posteriores à sua versão atual e verifique a lista de RPMs dessas versões. Consulte as notas de lançamento da Apigee para links de 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 da versão para atualizar o componente.

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