4.19.01 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.01 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:

○ Lançamento de disponibilidade geral (GA, na sigla em inglês) da IU do Edge
○ Lançamento da monetização na IU do Edge
apigee-monit adiciona serviços de monitoramento e autocorreção




Para mais informações sobre cada um desses novos recursos, consulte Novos recursos.

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:

○ Borda:
   18/06/08
   18/06/06
   18/05/21
   18/05/2010
   18/05/09
   18/01/201804.04.04
○ Portal:
   18.11.28.00
   18.10.17.00
   18.10.09.00
   18.07.16.00
Aposentadorias Nenhum
Descontinuações A versão 4.17.09 do Apigee Edge para nuvem privada não é mais compatível (descontinuado).

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

Correções de bugs

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

○ Zookeeper não foi interrompido pelo script de backup (122694069)
○ Página de destino "Nenhuma organização" adicionada (120993451)
○ Exclusão de relatórios personalizados (120682369)
○ Guia Geomap na experiência nova do Edge (120681592)






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-monitHEAD

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 18/04/05 Diretamente da versão 4.18.05 → 4.19.01
A partir de 18/04/01 Diretamente da versão 4.18.01 → 4.19.01
A partir de 17/04/09 Diretamente da versão 4.17.09 → 4.19.01
A partir de 17/04/05 Faça upgrade da versão 4.17.05 → 4.18.01, depois faça upgrade da versão 4.18.01 → 4.19.01
A partir de 17/04/01 Faça upgrade da versão 4.17.01 → 4.18.01, depois faça upgrade da versão 4.18.01 → 4.19.01
A partir de 16/04/09 Faça upgrade da versão 4.16.09 → 4.18.01, depois faça upgrade da versão 4.18.01 → 4.19.01
A partir de 16/04/05 Faça upgrade da versão 4.16.05 → 4.18.01, depois faça upgrade da versão 4.18.01 → 4.19.01
A partir de 16/04/01 Faça upgrade da versão 4.16.01 → 4.18.01, depois faça upgrade da versão 4.18.01 → 4.19.01
A partir de 4.15.0x Faça upgrade da versão 4.15.0x → 4.16.01, depois da versão Upgrade da versão 4.16.01 → 4.18.01, depois faça upgrade da versão 4.18.01 → 4.19.01

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.

Versão de disponibilidade geral (GA) da IU do Edge

A IU do Apigee Edge é nosso serviço de IU de gerenciamento mais recente. Antes, ele estava na versão Beta. Com o Apigee Edge para nuvem privada v4.19.01, a IU do Edge faz parte da versão geral.

Para usar a IU do Edge, você precisa ativar o SAML e instalar a IU do Edge no próprio nó.

Para mais informações, consulte IU de borda para nuvem privada.

Versão de disponibilidade geral (GA) da monetização na IU do Edge

A monetização na IU da nova experiência do Edge já está disponível para todos os usuários.

Agora é possível gerenciar todas as tarefas de monetização do Apigee Edge para nuvem privada na IU de experiência do New Edge, incluindo o seguinte:

Devido a este aviso, os relatórios de variação de monetização foram oficialmente descontinuados. Veja as descontinuações da Apigee.

O apigee-monit adiciona serviços de monitoramento e autocorreção

O Apigee Edge para nuvem privada agora inclui apigee-monit, uma ferramenta baseada no utilitário Monit de código aberto. apigee-monit pesquisa periodicamente os serviços de borda. Se um serviço estiver indisponível, o apigee-monit tentará reiniciá-lo.

Para informações sobre como instalar, configurar e usar o apigee-monit, consulte Autocorreção com o apigee-monit.

Novas propriedades de configuração de TLS

A IU do Edge é compatível com as novas propriedades de configuração do TLS que podem ser usadas para definir o seguinte:

  • Protocolo TLS padrão
  • Lista de protocolos TLS compatíveis
  • Algoritmos TLS compatíveis
  • Criptografias TLS compatíveis

Para mais informações, consulte Como definir propriedades TLS opcionais.

Criar, editar e excluir hosts virtuais na IU do Edge

A funcionalidade de autoatendimento foi expandida para que agora você possa criar, editar e excluir hosts virtuais em um navegador (somente na IU do Edge).

Para mais informações, consulte Criar um host virtual usando um navegador.

Adição do suporte à OpenAPI v3

Nesta versão, adicionamos suporte à criação de um proxy via OpenAPI versão 3 (somente na IU do Edge).

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) 7.6
  • CentOS 7.6
  • Oracle Linux 7.6

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

  • RHEL/CentOS/Oracle versão 7.3
  • RHEL/CentOS versão 6.8
  • Oracle Linux 6.7

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
122694069

O Zookeeper não foi interrompido pelo script de backup

O processo do Zookeeper não era interrompido pelo script de backup antes dessa correção.
120993451

Página de destino "Nenhuma organização" adicionada

Os desenvolvedores que fazem login com um usuário que não tem organizações associadas não são mais enviados para uma página que não existe. Uma nova página de destino foi adicionada para esses usuários.
120682369

Como excluir relatórios personalizados

Os usuários não podiam excluir relatórios personalizados na experiência com o New Edge.
120681592

Guia "Mapa geográfico" na experiência "New Edge"

Quando os usuários navegavam para a guia "Mapa geográfico" na experiência "New Edge", a experiência "New Edge" estava gerando um erro.
120624977

Opções da JVM do Zookeeper

A definição de opções da JVM usando o código com o Config para Zookeeper não estava funcionando.
80187407

Ocorreram erros indefinidos nas dicas

Quando um gráfico tinha apenas uma série temporal, as dicas geravam erros indefinidos.
79949124

Como criar proxies reversos via OpenAPI

O botão Usar OpenAPI ao criar proxies não estava funcionando.
77515655

Como redefinir senhas sem enviar links

Os usuários não estavam recebendo e-mails ao solicitar um link para redefinir as senhas.
72799769

Cabeçalhos incorretos para links de redefinição de senha

Mesmo depois que um usuário definiu a propriedade trustxforwarded como true, os cabeçalhos de solicitação resultantes não usavam HTTPS.
69550284

Como usar WSDLs para criar proxies de API

A geração de proxy de API falhava ao usar WSDLs.

Problemas conhecidos

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

Id do problema Descrição
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.

115278838

Tokens de sessão não invalidados

Os tokens de sessão não são invalidados no servidor quando o usuário clica no botão de logout do Apigee Edge.

Alternativa:

Usar a nova experiência do Edge com SAML.

113342838

As operações do Cassandra não funcionam quando a autenticação JMX está ativada

Alternativa:

Adicione seu nome de usuário e senha sempre que invocar o comando nodetool.

79993247

As solicitações HEAD para destinos do Node.js travam

As solicitações HEAD para um destino Node.js podem travar, deixando as conexões pendentes.

Alternativa:

Para contornar esse problema, defina um gerenciador para que as solicitações HEAD retornem explicitamente uma resposta vazia.

79757554

Os nomes de host não são resolvidos

Depois de instalar ou fazer upgrade do Edge para nuvem privada, os nomes do host talvez não sejam resolvidos para os endereços deles.

Alternativa:

Para resolver esse problema, reinicie o componente da IU do Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
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.
65737520

Falha ao redefinir a senha de administrador do sistema

Falha ao redefinir a senha de administrador do sistema do servidor de gerenciamento que contém caracteres especiais.

Alternativa:

Defina a senha em um arquivo de dados que você transmite para o endpoint /users na API Management. Veja mais informações em Redefinir a senha do administrador do sistema.

Próxima etapa

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

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