4.19.06 Notas de lançamento do Edge para nuvem privada

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

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

Resumo da versão

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

Novos recursos

Esta versão inclui os novos recursos a seguir:

○ Suporte LDAP para SSO
○ Suporte à implantação HTTP
○ Análise conectável
○ Suporte ao 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 em o 19/03/01 Público notas de lançamento do Google Cloud), os processadores de mensagens agora ignoram cabeçalhos que começam com X-Apigee-* Como resultado, é preciso refatorar qualquer código que use X-Apigee-* e substitua esses cabeçalhos 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 a versão anterior do Edge para nuvem privada, as seguintes versões ocorreram e estão incluídos nesta versão:

○ Borda:
19.07.23 (UI)
19.03.01
19.02.19
19.02.04
19.01.23
19.01.14
18.12.04
18.08.31
18.07.31
○ Portal:
19.07.08
19.05.23
19.05.08
19.04.18
19.03.20
19.02.27
19.02.21
19.02.04
19.01.16
Aposentadoria Nenhum
Suspensões de uso

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

  • 4.18.01: a versão 4.18.01 do Apigee Edge para nuvem privada foi descontinuada.

Para mais informações, consulte Descontinuação, descontinuações e CPS da Apigee mudanças.

Correções de bugs

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

○ UseStringDeDuplicate não definido (140270474)
○ Erros de MP (111445518)
○ Falhas do Cassandra com o JMX (113342838)
○ Upgrades de 13 nós (138931337)
○ Proxies com o mesmo nome (119802562)
○ Keystores não carregam (118851790)
○ Falha no Analytics (110988191)
○ Falhas no backup (110785400)
○ Solicitações HEAD para Node.js (79993247)
○ apigee-postgres backup/restauração (70291825)
○ Redefinir a senha do sysadmin (65737520)

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:

○ Menta sem classificação inicial (141628497)
○ Vazamento de memória em servidores de classificação da moeda (137865184)
○ Formato de arquivo de metadados para instalação da Apigee-sso (135616498)
apigee-monit não compatível com o Amazon Linux 1 (122370980)
○ O backup do processador de mensagens não faz o backup do conjunto correto de arquivos (121095148)
○ DataAccessExceptions em configurações de vários data centers (76087166)
○ Política do MessageLogging, incluindo informações extras na mensagem de registro (68722102)

Para obter 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 para esta versão:

A partir de 19/04/01 Faça upgrade diretamente da versão 4.19.01 → 4.19.06
A partir de 18/04/05 Faça upgrade diretamente da versão 4.18.05 → 4.19.06
A partir de 18 de abril de 2001 Faça 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, essa versão inclui todos recursos na interface do usuário do Edge, no gerenciamento do Edge e nas versões do portal listados em Lançamentos incluídos.

Além das melhorias a seguir, essa versão também contém vários recursos de usabilidade, segurança e estabilidade.

Suporte à implantação HTTP

Por padrão, o Edge usa a RPC para implantar proxies de API. Esse modo funciona muito bem para a maioria topologias maiores com muitos MPs podem sofrer esgotamento de tempo limite quando um grande número de chamadas simultâneas são feitas via RPC.

Como resultado, a Apigee recomenda que implantações maiores usem HTTP em vez de RPC para implantação do Google Workspace. Agora é possível ativar implantações HTTP.

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

Suporte para rack do Cassandra

A Apigee agora oferece orientação geral para as operações de escalonamento do Cassandra, tornando o Cassandra no Apigee Edge para reconhecimento de rack de nuvem privada.

Para mais informações, consulte Suporte ao 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 visualizar os dados de análise na interface do Edge.

Com esta versão de recurso, é possível configurar o processador de mensagens para gravar dados de análise no no disco ou use ambas as 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 experiência do New 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 a interface de usuário de borda e as chamadas de API de gerenciamento de borda agora são compatíveis com LDAP em além do SAML. O suporte ao LDAP inclui métodos de vinculação direta e indireta.

Para mais informações, consulte Visão geral de ambientes Autenticação do IdP.

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 endereços IPv6 ao roteador com uma nova propriedade.

Para mais informações, consulte Usar IPv6 na Cloud Router.

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

Agora é possível excluir INVALID_TSC transações para que elas não sejam adicionadas ao Postgres ao usar a monetização.

Para mais informações, consulte Monetização propriedades do servidor.

Software compatível

Esta versão inclui as seguintes mudanças de software com suporte:

Suporte adicionado Não há mais suporte

Esta versão adiciona suporte para as 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 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 inclui todas as correções de bugs na interface do usuário do Edge, no gerenciamento de borda e nas versões do portal mostradas em Lançamentos incluídos.

ID do problema Descrição
140270474

UseStringDeDuplicate não definido

UseStringDeduplication não era da configuração para os componentes edge-message-processor em produção e ambientes de teste.
111445518

Erros de MP

Os processadores de mensagens registram 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 estavam funcionando quando a autenticação do 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 estavam falhando.
119802562

Proxies com o mesmo nome

Se dois usuários na mesma organização criarem proxies com os mesmos nomes, a segunda regra substituirá a primeira. Isso só acontecia quando Usuários diferentes não podiam ver o outro proxy.
118851790

Keystores não carregam

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

Falha na análise

Falha na análise de um ambiente quando os dados do Microgateway que foram enviados defina uma data no futuro.
110785400

Falhas no backup

O ZooKeeper, o Cassandra e o OpenLDAP falharam de maneira intermitente faça backup dos dados corretamente com o seguinte erro: File changed as we read it.
79993247

Solicitações HEAD para Node.js

Solicitações HEAD para um destino Node.js podem travar, o que deixou 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

Redefinir a senha do sysadmin

Redefinir a senha do administrador do sistema para o servidor de gerenciamento que continham falha.

Problemas conhecidos

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

ID do problema Descrição
141628497

Mint não classifica transações inicialmente

O Edge para nuvem privada não classifica as transações inicialmente quando você ativa a monetização em uma organização pela primeira vez. Isso se aplica a organizações novas e existentes.

A API de ativação de monetização responde com o ID do job e, após a conclusão, o status do job indica êxito. 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 comuns.

Alternativa:

Reinicie qualquer um dos processadores de mensagens (MPs), o que pode ser feito com o seguinte:
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 a cada reinicialização, o que significa que o problema se aplica apenas inicialmente.

137865184

Vazamento de memória dos servidores de classificação do Mint

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

Alternativa:

Nenhum.
135616498

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

Ao instalar 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 do arquivo, o arquivo metadata.xml não vai ser lido completamente.

Alternativa:

Para contornar esse problema, siga um destes procedimentos:

  • Adicione um CRLF ao final do arquivo metadata.xml

    OU

  • Usar um local baseado 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 faz o backup do conjunto correto de arquivos

Alternativa:

Execute o backup uma segunda vez e ele deve fazer backup do 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 seguinte erro:

DataAccessException: Error while accessing datastore;
Please retry later

Por isso, talvez o Management Server não seja iniciado porque ele está tentando se conectar ao Cassandra. em dc-1 e dc-2. O DataAccessExceptions ocorre se um nó do Cassandra é para baixo. Isso também pode resultar na interrupção do tráfego da API, quando os processadores de mensagens relatam DataAccessExceptions ao tentar recuperar KVMs.

O estado esperado é que o servidor de gerenciamento não se conecte a componentes do repositório de dados entre regiões.

Alternativa

A solução é cancelar o registro dos seguintes tipos de nó do Cassandra no data center indisponível e registre-os novamente assim 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 Apigee do Compute Engine.
    • MS_IP e MS_PORT são o endereço IP e a porta do servidor de gerenciamento número
    • 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". Você pode ter o renomeou com outro nome, então verifique sua implementação.
    • CASSANDRA_NODE_TYPE é um de kms-datastore, dc-datastore, e keyvaluemap-datastore.

    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"
    }

    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ê vai usá-las 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. Não se esqueça de anotar as 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

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

68722102

Política do 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 precisa incluir informações geradas pela Apigee. No entanto, mesmo que você defina FormatMessage=false, a mensagem de registro ainda vai incluir as seguintes 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 a 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