1.1.0 - Notas de lançamento do ambiente de execução híbrido da Apigee

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

Em 27 de janeiro de 2020, o Google lançou a versão 1.1.0 do ambiente de execução do Apigee híbrida. Esta seção descreve novos recursos e alterações lançadas na versão 1.1.0.

Fazendo upgrade

Não é possível fazer upgrade da versão 1.0.0 para a 1.1.0, e a nova versão não é compatível com a versão 1.0.0. A versão 1.1.0 requer uma nova instalação.

Novos recursos e melhorias

Apigee Connect (versão Alfa)

A versão Alfa do Apigee Connect permite que o serviço MART do Apigee híbrida se conecte ao plano de gerenciamento sem exigir que você exponha o endpoint MART. Se você usa o Apigee Connect, não precisa configurar o gateway de entrada MART com um alias de host e um certificado de DNS autorizado. Para saber mais detalhes, entre em contato com seu representante da Apigee.

Roteamento de caminho base

O roteamento de caminho de base permite configurar e gerenciar como a Apigee híbrida roteia chamadas de proxy de API para ambientes específicos. Para detalhes, consulte Configurar o roteamento de caminho base.

Alterações

As alterações a seguir foram feitas na versão 1.1.0 do ambiente de execução híbrido. Algumas dessas alterações, conforme observado, não são compatíveis com a versão 1.0.0.

  • A CLI apigeectl agora instala o Istio no namespace istio-system. Esse é o namespace padrão do Istio. Essa alteração é incompatível com versão híbrida 1.0.0.
  • A CLI apigeectl agora instala o CertManager no namespace cert-manager. Essa alteração é incompatível com versão híbrida 1.0.0.
  • A versão compatível do Istio implantada com o ambiente de execução híbrido da Apigee foi migrada para 1.4.2 porque a versão 1.2.x não tem mais suporte.

Bugs corrigidos

Os seguintes problemas listados nAs notas de lançamento da Apigee híbrida 1.0.0 foram corrigidos:

Problema Descrição
144886537 O roteamento de caminho base não está funcionando na Apigee híbrida v1.0.0. Quando as modificações são configuradas para fazer a rota em diferentes ambientes com o mesmo hostAlias, a entrada não é roteada para o ambiente com base no caminho.
143774187 A IU híbrida exibe o rótulo "Empresa" na visualização de apps.

Problemas conhecidos

A tabela a seguir descreve os problemas conhecidos desta versão:

Problema Descrição
N/D Não é possível usar um "*" para a propriedade hostAlias nas configurações mart e envs. A prática recomendada é usar um nome de host específico para a configuração mart.
N/D A configuração das variáveis HTTP_PROXY, HTTPS_PROXY e NO_PROXY não é compatível com a versão Alfa da Apigee Connect.
N/D

Erro de cabeçalho HTTP inválido: a entrada do Istio alterna todas as respostas de destino recebidas para o protocolo HTTP2. Como o processador de mensagens híbrido é compatível apenas com HTTP1, você pode ver o seguinte erro quando um proxy de API é chamado:

http2 error: Invalid HTTP header field was received: frame type: 1, stream: 1,
   name: [:authority], value: [domain_name]

Se você vir esse erro, execute uma das seguintes ações para corrigir o problema:

  • Modifique o serviço de destino para omitir o cabeçalho Host na resposta.
  • Remova o cabeçalho Host usando a política AssignMessage no proxy de API, se necessário.
144584813 Se você criar uma sessão de depuração, mas não tiver transações nela, a API List Debug Sessions não incluirá a sessão nessa lista. A API só incluirá sessões na resposta se a sessão contiver pelo menos uma transação.
144436206 Na visualização Desempenho do cache, o cálculo da proporção de ocorrência em cache está incorreto.
144321491 A Apigee híbrida registra notificações de "Criação de cache ausente" que indicam uma possível degradação de performance. Essas mensagens são normais e podem ser ignoradas.
144321144 Não é possível recarregar proxies com hosts virtuais seguros.
144286363

A máscara de depuração no env.json não oculta dados de resposta.

A API a seguir para atualizar a máscara de depuração de env.json com um campo responseJSONPaths não funciona:

PATCH /v1/organizations/org/environments/env/debugmask?replaceRepeatedFields=true
{
  "responseJSONPaths": ["$.maskedDataEnv"]
}

Para contornar esse problema com o trace, exclua uma sessão de trace inteira na IU ou use as APIs trace para excluir transações individuais em uma sessão.
143659917

A configuração de expiração da política PopulateCache precisa ser definida como um valor explícito entre 1 e 30. Exemplo: 

<ExpirySettings>
  <TimeoutInSec>30</TimeoutInSec>
</ExpirySettings>
133192879

Resumo: há uma latência muito alta ao usar a API ou a IU para receber o status de implantação da organização. Essa latência pode resultar em uma resposta HTTP 204 (No Content) ou HTTP 400 (Bad Request).

Solução alternativa: atualize seu navegador (ou reenvie a solicitação).