4.19.06 Notas de lançamento do Edge para nuvem privada

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
informações

Esta seção descreve a versão 4.19.06 do lançamento do recurso Edge para nuvem privada.

Resumo da versão

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

Novos recursos

Esta versão inclui os novos recursos a seguir:

○ Suporte LDAP para SSO
○ Suporte à implantação HTTP
○ Análise plugável
○ Suporte a rack do Cassandra
○ Suporte a IPv6
○ Instalação simplificada da nova experiência de borda
○ Excluir INVALID_TSC transações (monetização)

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 da nuvem pública), os processadores de mensagens agora ignoram cabeçalhos que começam com X-Apigee-*. Dessa forma, é necessário refatorar qualquer código que use cabeçalhos X-Apigee-* e substituí-los por outros compatíveis.

  • O nome dos arquivos de registro do Cassandra foi alterado. Agora ele é:

    /opt/apigee/var/log/apigee-cassandra/system.log
Lançamentos incluídos

Desde o lançamento anterior do recurso Edge para nuvem privada, as seguintes versões ocorreram e estão incluídas nesta:

○ Edge:
   19.07.23 (UI)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
{11.19.
{/1.
19.19.19.19
○ Portal:
   08/07/19
   19/05.23
   19/05/08
   19/04/2018
   19/03/20
   19.02.

19.02.02.02.02.
Aposentadorias Nenhum
Descontinuações

Com o lançamento da versão 4.19.06, os seguintes recursos foram descontinuados:

  • 4.18.01:a versão 4.18.01 do Apigee Edge para nuvem privada agora está obsoleta.

Para mais informações, consulte Suspensões de uso, suspensões e mudanças na CPS da Apigee.

Correções de bugs

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

○ UseStringDeDuplicação não definido (140270474)
○ Erro MP (111445518)
.








HEAD

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:

7






apigee-monit

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

Caminhos de upgrade

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

A partir de 19/04/01 Diretamente da versão 4.19.01 → 4.19.06
A partir de 18/04/05 Diretamente do upgrade da versão 4.18.05 → 4.19.06
A partir de 18/04/01 Diretamente da versão 4.18.01 → 4.19.06

Novos recursos

Esta seção lista novos recursos nesta versão. Além disso, ela inclui todos os recursos das versões de IU de borda, gerenciamento de borda e portal listadas 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.

Suporte a implantação HTTP

Por padrão, o Edge usa a RPC para implantar proxies de API. Esse modo funciona muito bem na maioria das instalações, mas topologias maiores com muitos MPs podem sofrer tempos limite quando um grande número de chamadas simultâneas é feita via RPC.

Por esse motivo, a Apigee recomenda que implantações maiores usem HTTP em vez de RPC para implantação. A ativação de implantações HTTP agora é compatível.

Para mais informações, consulte Ativar implantação HTTP.

Suporte ao rack do Cassandra

A Apigee agora fornece orientação geral para operações de escalonamento do Cassandra fazendo com que o Cassandra no Apigee Edge para nuvem privada reconheça o rack.

Para mais informações, consulte Suporte a rack do Cassandra.

Análise conectável

Por padrão, os dados de análise coletados pelo processador de mensagens são enviados ao Qpid e Postgres para processamento. Você vai ver os dados de análise na IU do Edge.

Com esta versão do recurso, você pode configurar o processador de mensagens para gravar dados de análise no disco ou optar por usar as duas opções.

Para mais informações, consulte Como gravar dados de análise em um arquivo.

Instalação simplificada da nova experiência do Edge

A instalação da nova experiência do Edge foi simplificada com um novo script.

Para mais informações, consulte Instalar a nova experiência do Edge.

Suporte ao IdP LDAP

A autenticação de usuários com chamadas da API Edge Management e da IU do Edge agora é compatível com LDAP e SAML. O suporte ao LDAP inclui métodos de vinculação direta e indireta.

Para mais informações, consulte Visão geral da autenticação do IdP externo.

Suporte ao IPv6

Por padrão, todas as chamadas de API do ambiente de execução para o Apigee Edge para nuvem privada usam IPv4. É possível adicionar suporte IPv6 ao roteador com uma nova propriedade.

Para mais informações, consulte Usar IPv6 no roteador.

Excluir INVALID_TSC transações (monetização)

Agora, ao usar a monetização, é possível impedir que transações INVALID_TSC sejam adicionadas ao banco de dados do Postgres.

Para mais informações, consulte Propriedades do servidor de monetização.

Softwares compatíveis

Esta versão inclui as seguintes alterações no software compatível:

Suporte adicionado Não há mais suporte

Adicionamos suporte às seguintes plataformas:

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

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

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

Para ver uma lista completa das plataformas compatíveis, consulte Software e versões compatíveis.

Correções de bugs

Nesta seção, listamos os bugs da nuvem privada que foram corrigidos nesta versão. Além disso, inclui todas as correções de bugs nas versões de IU do Edge, gerenciamento de borda e portal mostradas em Versões incluídas.

Id do problema Descrição
140270474

UseStringDeDuplicação não definido

UseStringDeduplication não estava sendo definido para os componentes edge-message-processor nos ambientes de produção.
111445518

Erros de MP

Os processadores de mensagens registravam continuamente a seguinte mensagem de erro a cada cinco minutos:
2019-06-29 00:02:05,775 Apigee-Timer-6 ERROR CMgmt -
  ConnectorServiceImpl.refreshToken() : Connector Management API auth token
  generation failed: 0 null
113342838

Falhas do Cassandra com o JMX

As operações do Cassandra não funcionavam quando a autenticação JMX estava ativada
138931337

Upgrades de 13 nós

Os upgrades das instalações de 13 nós das versões 17.09, 18.01 e 18.05 falharam.
119802562

Proxies com o mesmo nome

Se dois usuários na mesma organização criarem proxies com os mesmos nomes, o segundo criado substituirá o primeiro. Isso só ocorria quando usuários diferentes não conseguiam ver o outro proxy.
118851790

Os keystores não estão carregando

Quando havia mais de 100 keystores para uma organização/ambiente, a seção de keystore e de referência na IU do Edge não estava carregando. Em vez disso, a IU exibiu um erro Internal Error (Error Fetching Keystores).
110988191

Falha na análise

A análise falhou para um ambiente quando fornecido com dados do Microgateway que foram definidos para uma data no futuro.
110785400

Falhas no backup

ZooKeeper, Cassandra e OpenLDAP falham intermitentemente ao fazer backup dos dados com o seguinte erro: File changed as we read it.
79993247

Solicitações HEAD para Node.js

As solicitações HEAD para um destino Node.js podiam travar, o que deixava as conexões pendentes.
70291825

backup/restauração do apigee-postgres

A execução de um backup/restauração do apigee-postgres agora faz backup dos dados de todos os componentes.
65737520

Como redefinir a senha do sysadmin

Redefinir a senha de administrador do sistema do servidor de gerenciamento que continha caracteres especiais falharia.

Problemas conhecidos

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

Id do problema Descrição
141628497

Mint não avaliam as transações inicialmente

O Edge para a nuvem privada não classifica as transações inicialmente quando você ativa a monetização de uma organização pela primeira vez. Isso é válido para organizações novas e existentes.

A API de ativação de monetização responde com o ID da tarefa e, após a conclusão, o status da tarefa indicará que ela foi bem-sucedida. No entanto, as chamadas de API monetizadas feitas inicialmente não serão processadas pela monetização nem classificadas. Essas transações só vão aparecer em análises regulares.

Alternativa:

Reinicie os processadores de mensagens (MPs, na sigla em inglês), o que pode ser feito da seguinte maneira:
apigee-service edge-message-processor restart

Depois que a monetização for ativada, reiniciar os MPs faz com que o Edge carregue a configuração do ZooKeeper na inicialização. Isso acontece a cada reinicialização, o que significa que o problema se aplica apenas inicialmente.

137865184

Vazamento de memória de servidores com classificação de entalhe

Quando uma nova instância do Qpid é registrada em um mxgroup, as filas são criadas sem consumidores, o que aumenta a profundidade da fila até que todos os recursos disponíveis sejam usados.

Alternativa:

Nenhuma.
135616498

Formato do arquivo de metadados para apigee-sso install

Ao instalar o apigee-sso e usar um arquivo metadata.xml em vez de um URL, se o arquivo metadata.xml não tiver uma nova linha (CRLF) no final, o arquivo metadata.xml não será lido totalmente.

Alternativa:

Para contornar esse problema, siga um destes procedimentos:

  • Adicione um CRLF ao final do arquivo metadata.xml

    OU

  • Usar um local com base em URL para os metadados
122370980

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

Alternativa:

Nenhuma.
121095148

O backup do processador de mensagens não está fazendo backup do conjunto correto de arquivos

Alternativa:

Faça o backup uma segunda vez para ter o conjunto de arquivos correto.

76087166

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

Em várias configurações de data center, se um repositório de dados ficar indisponível, você poderá ver o seguinte erro:

DataAccessException: Error while accessing datastore;
Please retry later

Como resultado, o servidor de gerenciamento pode não iniciar porque está tentando se conectar aos nós do Cassandra em dc-1 e dc-2. A DataAccessExceptions ocorre se um nó do Cassandra estiver inativo. Isso também pode resultar na interrupção do tráfego da API, em que os processadores de mensagens relatam DataAccessExceptions ao tentar recuperar KVMs.

Observe que o estado esperado é que o servidor de gerenciamento não se conecte a componentes do armazenamento de dados entre regiões.

Alternativa

A solução alternativa é cancelar o registro dos seguintes tipos de nó do Cassandra no data center indisponível e registrá-los novamente quando eles estiverem disponíveis novamente:

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

Para cancelar e registrar novamente esses tipos de nó do Cassandra:

  1. Consiga os UUIDs dos nós do Cassandra usando o seguinte comando curl:
    curl -u ADMIN_EMAIL:ADMIN_PW \
      "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
      &type=CASSANDRA_NODE_TYPE"

    Em que:

    • ADMIN_EMAIL e ADMIN_PW são as credenciais da sua conta da Apigee.
    • MS_IP e MS_PORT são o endereço IP e o número da porta do servidor de gerenciamento.
    • REGION é o nome do data center em que o servidor de gerenciamento está localizado.
    • GATEWAY_POD é o nome do pod, que é, por padrão, "gateway". Talvez você tenha renomeado como outra coisa, então verifique sua implementação.
    • CASSANDRA_NODE_TYPE é uma destas opções: kms-datastore, dc-datastore ou keyvaluemap-datastore.

    Por exemplo:

    curl -u nickdanger@google.com:myP@$$w0rD
      "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

    A resposta usa o seguinte formato:

    {
      "internalIP" : "POD_IP_ADDRESS",
      "isUp" : [true|false],
      "pod" : "GATEWAY_POD",
      "reachable" : [true|false],
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
        "uUID" : "POD_UUID"
    }

    Por exemplo:

    {
      "internalIP" : "192.168.1.11",
      "isUp" : false,
      "pod" : "gateway",
      "reachable" : false,
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : "dc-datastore",
      "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
    }

    Observe os valores do campo uUID na resposta. Você as usará para cancelar o registro dos nós.

  2. Repita a primeira etapa para cada tipo de nó do Cassandra: kms-datastore, dc-datastore e keyvaluemap-datastore. Anote os UUIDs retornados.
  3. Cancele o registro dos nós usando o seguinte comando:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    Em que UUID é o UUID retornado na resposta do comando anterior.

  4. Repita a etapa 3 para cada UUID que você coletou nas etapas 1 e 2.
  5. Registre novamente os nós usando o seguinte comando:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
      "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
      Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
      region=REGION&pod=GATEWAY_POD" -H \
      'content-type: application/x-www-form-urlencoded' -X POST

Essas operações registram e cancelam o registro de nós do Zookeeper e não têm nenhum impacto no cluster do Cassandra. Para mais informações sobre esses comandos, consulte Atualizar registros do repositório de dados.

68722102

Política MessageLogging, incluindo informações extras na mensagem de registro

O elemento FormatMessage da política MessageLogging controla o formato da mensagem registrada. Quando FormatMessage=false, a mensagem registrada não deve incluir informações geradas pela Apigee. No entanto, mesmo se você definir FormatMessage=false, a mensagem de registro ainda incluirá as seguintes informações:

  • A pontuação de prioridade.
  • O carimbo de data/hora

Alternativa:

Nenhuma.

Próxima etapa

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

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