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 do Edge
○ 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 do Public Cloud), os processadores de mensagens agora ignoram os cabeçalhos que começam com X-Apigee-*. Como resultado, é necessário refatorar qualquer código que use cabeçalhos X-Apigee-* e substituí-los por cabeçalhos 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
{19.19.19.19.19.04
{19.02.19

19.19.19.02.19.
19.01.1418.12.0418.08.3118.07.31
○ Portal:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
   19.02.2719.02.2119.02.0419.01.16
Aposentadoria Nenhum
Descontinuações

Com o lançamento da versão 4.19.06, os seguintes itens estão obsoletos:

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

Para mais informações, consulte Descontinuações, suspensões e mudanças na CPS.

Correções de bugs

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

○ UseStringDeDuplicação (140270474)
○ Erros de 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 Mensagens sem classificação inicialmente (141628497)
○ Vazamento de memória dos servidores de classificação da cunhar (137865184)
○ Formato do arquivo de metadados para instalação do apigee-sso (135616498)
Configurações de backup apigee-monit não suportadas no Amazon Linux 1 (12237098) os arquivos de registro de política extra do Amazon Linux 1 (12237098)



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:

From 4.19.01 Faça upgrade da versão 4.19.01 → 4.19.06 diretamente
A partir de 4.18.05 Fazer upgrade da versão 4.18.05 → 4.19.06 diretamente
A partir de 18/04/01 Fazer upgrade diretamente da versão 4.18.01 → 4.19.06

Novos recursos

Esta seção lista os novos recursos desta versão. Além disso, esta versão inclui todos os recursos nas versões do Edge UI, Edge Management e Portal listados em Versões incluídas.

Além das melhorias a seguir, esta versão também contém várias melhorias de usabilidade, desempenho, segurança e estabilidade.

Suporte à implantação HTTP

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

Como resultado, 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, acesse Ativar a implantação HTTP.

Suporte a rack do Cassandra

A Apigee agora fornece orientações gerais para escalonar as operações do Cassandra ao fazer o Cassandra no Apigee Edge para o rack de nuvem privada.

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 ao Postgres para processamento. É possível conferir os dados de análise na interface do Edge.

Com esta versão do recurso, você pode configurar o processador de mensagens para gravar dados de análise no disco ou 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 saber mais, consulte Instalar a nova experiência do Edge.

Suporte ao IdP LDAP

A autenticação de usuários com chamadas da IU do Edge e da API Edge Management 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 é possível impedir que transações INVALID_TSC sejam adicionadas ao banco de dados do Postgres ao usar a monetização.

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

Softwares compatíveis

Esta versão inclui as seguintes alterações em softwares com suporte:

Suporte adicionado Não há mais suporte

Nesta versão, adicionamos suporte às seguintes plataformas:

  • Red Hat Enterprise Linux (Ela) 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 (Firebase) 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, esta versão inclui todas as correções de bugs nas versões do Edge UI, Edge Management e Portal mostradas em Versões incluídas.

Id do problema Descrição
140270474

UseStringDeobfuscate não definido

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

Erros de MP

Os processadores de mensagens registraram 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 foi 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 falhavam.
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 diferentes usuários não conseguiam ver o outro proxy.
118851790

Keystores não estão carregando

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

Falha no Google Analytics

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

Falhas no backup

ZooKeeper, Cassandra e OpenLDAP falhavam de forma intermitente ao fazer o 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 (em inglês)

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

Redefinir a senha do sysadmin

A redefinição da senha do 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 sem classificação de 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 vai indicar que ela foi bem-sucedida. No entanto, as chamadas de API monetizadas feitas inicialmente não serão processadas por monetização e não serão classificadas. Essas transações só vão aparecer em análises normais.

Alternativa:

Reinicie qualquer operador de mensagem (MPs), o que pode ser feito da seguinte maneira:
apigee-service edge-message-processor restart

Após a ativação da monetização, reiniciar os MPs faz com que o Edge carregue a configuração do ZooKeeper na inicialização. Isso acontece em cada reinicialização, o que significa que o problema só se aplica inicialmente.

137865184

Vazamento de memória dos servidores de classificação de mint

Quando uma nova instância Qpid é registrada em um mxgroup, as filas são criadas sem consumidores, o que resulta no aumento da profundidade da fila até que ela use todos os recursos disponíveis.

Alternativa:

Nenhum.
135616498

Formato do arquivo de metadados para instalação do apigee-sso

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

Alternativa:

Para contornar esse problema, siga um destes procedimentos:

  • Adicionar 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:

Nenhum.
121095148

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

Alternativa:

Execute o backup uma segunda vez para conseguir o conjunto correto de arquivos.

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 erro a seguir:

DataAccessException: Error while accessing datastore;
Please retry later

O resultado é que o servidor de gerenciamento pode não ser iniciado porque está tentando se conectar aos nós do Cassandra em dc-1 e dc-2. O 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 as 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 depois que os nós do Cassandra 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 para 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. Elas serão usadas para cancelar o registro dos nós.

  2. Repita a etapa um 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 coletado 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

Observe que 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 for FormatMessage=false, a mensagem registrada não poderá incluir informações geradas pela Apigee. No entanto, mesmo que você defina FormatMessage=false, a mensagem de registro ainda vai incluir estas informações:

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

Alternativa:

Nenhum.

Próxima etapa

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

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