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

Esta é a documentação do Apigee Edge.
Acesse Documentação da Apigee X.
informações

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

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)

O Apigee Connect Alfa permite que o serviço MART híbrido da Apigee se conecte ao plano de gerenciamento sem que você precise expor 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 base permite configurar e gerenciar como as chamadas de proxy da API de rotas híbridas da Apigee são direcionadas 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 a versão 1.4.2 porque a versão 1.2.x não é mais compatível.

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íbridas é compatível apenas com HTTP1, você pode ver o seguinte erro quando um proxy da 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 da 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 As notificações de registros híbridos da Apigee "Como criar cache ausente" indicam uma possível degradação de desempenho. Essas mensagens são normais e podem ser ignoradas.
144321144 Proxies com hosts virtuais seguros não podem ser recarregados.
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).