4.17.05 - Notas da versão do Edge for Private Cloud

Você está lendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. info

Desde a versão de recursos anterior do Edge para nuvem privada, as seguintes versões foram lançadas e estão incluídas nesta versão de recursos:

Consulte Sobre a numeração de versões para entender como descobrir se uma versão específica da nuvem está incluída na sua versão do Edge para nuvem privada.

Visão geral da versão

Esta versão inclui vários recursos importantes que ajudam a controlar e proteger melhor suas APIs, incluindo:

• Os fluxos compartilhados oferecem suporte à implantação sem inatividade.
• Agora é possível excluir dados de monetização de uma organização.
• Outros novos recursos descritos abaixo.

Em relação à descontinuação, os cofres foram descontinuados.

O restante deste tópico contém detalhes sobre todos os novos recursos, atualizações e correções de bugs contidos na versão.

Descontinuações e desativações

Os seguintes recursos foram descontinuados ou desativados nesta versão. Consulte a política de descontinuação do Edge para mais informações.

Desativado: como adicionar caminhos na guia "Performance" do proxy de API

Até esta versão, era possível navegar até um proxy de API na interface de gerenciamento, acessar a guia "Performance" e criar diferentes caminhos para uma comparação baseada em gráficos na guia "Performance" do proxy e no painel "Transações comerciais". Esse recurso foi desativado e não está mais disponível na interface. Para uma alternativa a essa funcionalidade, consulte o seguinte artigo da comunidade Apigee: Alternativa à API Business Transactions. (EDGEUI-902)

Desativado: URL buildInfo para o portal dos Serviços para desenvolvedores

Em versões anteriores do portal, para determinar a versão, abra o seguinte URL em um navegador:

http://yourportal.com/buildInfo

Na versão 4.17.05, esse link foi removido. Para determinar a versão, abra a entrada de menu Relatórios > Relatório de status no Drupal. A versão do portal aparece na tabela na linha chamada Perfil de instalação.

Descontinuação do armazenamento seguro (cofres) da Apigee

O armazenamento seguro da Apigee, também conhecido como "cofres", está sendo descontinuado e será desativado um ano após a data do anúncio de descontinuação mostrada na página de descontinuações e desativações. Os vaults, que fornecem armazenamento criptografado de pares de chave-valor, são criados com a API de gerenciamento e acessados no ambiente de execução com funções no módulo apigee-access Node.js.

Em vez de usar o armazenamento seguro, use mapas de chave-valor (KVMs) criptografados, conforme descrito em Como trabalhar com mapas de chave-valor. Os KVMs criptografados são tão seguros quanto os cofres e oferecem mais opções de criação e recuperação. (MGMT-3848)

Novos recursos e atualizações

Confira a seguir os novos recursos e melhorias desta versão. Além das melhorias a seguir, esta versão também inclui várias melhorias de usabilidade, desempenho, segurança e estabilidade.

Nuvem privada

Adicionado um novo parâmetro de configuração SMTP obrigatório à instalação

Agora, você precisa usar o parâmetro SMTPMAILFROM no arquivo de configuração da instalação do Edge. Esse parâmetro especifica o endereço de e-mail usado quando o Edge envia e-mails automatizados, como quando um usuário pede para redefinir uma senha. Consulte Instalar componentes do Edge em um nó para mais informações.

(EDGEUI-1020)

Agora é possível definir o tempo limite usado pela interface do Edge para chamadas de gerenciamento da API Edge.

Agora é possível especificar a duração do tempo limite da API usada pela interface do Edge para controlar por quanto tempo a interface aguarda o retorno de uma chamada de gerenciamento de API. As seguintes propriedades definem o tempo limite:

• conf_apigee_apigee.feature.apitimeout define o tempo, em segundos, que a interface espera uma chamada para o back-end retornar, independente de qualquer atividade nela. Se a chamada não for concluída nesse período, a interface vai gerar um erro de tempo limite. O valor padrão é de 180 segundos (3 minutos).
• conf_apigee_play.ws.timeout.idle define por quanto tempo a interface espera, em milissegundos, por atividade no servidor. Ele pode ser definido com o mesmo valor de conf_apigee_apigee_apitimeout ou com um valor menor. Definir um valor maior não tem efeito. O padrão é 180.000 milissegundos (3 minutos).
• conf_apigee_play.ws.timeout.connection define por quanto tempo a interface espera que uma conexão seja estabelecida. Ele pode ser definido com o mesmo valor de conf_apigee_apigee_apitimeout ou com um valor menor. Definir um valor maior não tem efeito. O padrão é 120.000 milissegundos (2 minutos).

Consulte Definir o tempo limite usado pela interface do Edge para chamadas de gerenciamento da API Edge para mais informações.

(EDGEUI-816)

Adição do tempo limite de nova tentativa do processador de mensagens aos roteadores

Adição de um tempo limite para que os roteadores parem de tentar novamente uma solicitação aos processadores de mensagens e retornem uma mensagem de erro.

Consulte Configurar o roteador para tentar novamente as conexões com um processador de mensagens para saber mais.

(APIRT-2912)

Adição de um procedimento para mudar o administrador do sistema padrão

Agora há documentação para mudar o administrador do sistema padrão.

Consulte Como gerenciar usuários, papéis e permissões para mais informações.

(DOS-4895)

Adicionamos documentação sobre como separar as tarefas de instalação do Edge entre usuários root e não root.

A nova documentação descreve as etapas para separar as tarefas de instalação do Edge entre usuários raiz e não raiz.

Consulte Visão geral da instalação do Edge para mais informações.

(DOS-4573)

Adicionada propriedade para definir o nome do host dos links em e-mails gerados

O Edge envia e-mails automaticamente em resposta a determinados eventos, como quando um usuário é adicionado a uma organização. Muitos desses e-mails contêm um link. Por exemplo, quando um novo usuário é adicionado a uma organização, a interface do Edge envia um e-mail com um URL de login no formato:

https://domain/login

O domínio é determinado automaticamente pelo Edge e geralmente está correto para a organização. No entanto, há uma chance de que, quando a interface do Edge estiver atrás de um balanceador de carga, o nome de domínio gerado automaticamente esteja incorreto. Se for o caso, use a propriedade conf_apigee_apigee.emails.hosturl para definir explicitamente a parte do nome de domínio do URL gerado.

Consulte Como definir o nome do host para links em e-mails gerados para mais informações.

(EDGEUI-1044)

Como definir o URL de base mostrado pela interface do Edge para um proxy de API

A interface do Edge mostra o URL de um proxy de API com base nas configurações do host virtual correspondente ao local em que o proxy é implantado. Essa exibição pode incluir o número da porta do roteador do host virtual.

Na maioria dos casos, o URL mostrado na interface do Edge é o correto para fazer solicitações externas ao proxy. No entanto, em algumas configurações, o URL exibido não está correto. Por exemplo, qualquer uma das seguintes configurações pode fazer com que o URL mostrado não corresponda ao URL real usado para fazer solicitações externas ao proxy:

• A terminação SSL ocorre em um balanceador de carga
• O mapeamento de portas ocorre entre um balanceador de carga e os roteadores do Apigee.
• Um balanceador de carga configurado com reescrita de caminhos

O Edge para nuvem privada 4.17.05 e versões mais recentes oferecem suporte a um atributo no host virtual chamado <BaseUrl> que permite substituir o URL mostrado pela interface do Edge. Confira um exemplo que mostra o objeto de host virtual com o novo atributo <BaseURL>. Neste exemplo, o valor "http://myCo.com" aparece na interface do Edge:

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:9005</HostAlias>
   </HostAliases>
   <BaseUrl>http://myCo.com</BaseUrl>
   <Interfaces/>
   <Port>9005</Port>
</VirtualHost>

Se <BaseUrl> não estiver definido, o padrão, o URL padrão renderizado pela interface do Edge vai aparecer como: "http://DNS_name_or_IP:9005/", enquanto a configuração real do alias do host é "http://myCo.com".

Também é possível definir o URL base ao criar uma organização usando a propriedade VHOST_BASEURL com o utilitário apigee-provision.

Consulte Configurar o acesso TLS a uma API para a nuvem privada para mais informações.

(EDGEUI-5008)

Foi adicionada documentação sobre como ativar o registro de depuração.

Adicionamos documentação para descrever como ativar/desativar o registro de depuração para componentes do Edge.

Consulte Como ativar o registro de depuração para mais informações.

(APIRT-4018)

Nova sintaxe de comando e instalador para o utilitário apigee-analytics-collector

Todos os clientes do Edge para nuvem privada precisam enviar à Apigee estatísticas sobre o tráfego de proxy de API usando a versão Beta do utilitário de linha de comando apigee-analytics-collector. Esse utilitário envia o relatório de volume de chamadas de API de volta para a Apigee.

Esta versão do Edge contém novas instruções de instalação e sintaxe de comando para o utilitário apigee-analytics-collector. Nesta versão, você usa apigee-service para instalar o utilitário apigee-analytics-collector em vez do npm e invoca o utilitário apigee-analytics-collector usando apigee-service em vez de um comando independente.

Consulte Como fazer upload de dados de tráfego da API para o Apigee: versão Beta para mais informações.

Novo diretório de instalação padrão após a atualização do portal dos serviços para desenvolvedores do Nginx/Postgres de uma nova instalação 4.17.01

Depois de atualizar uma nova instalação do 4.17.01 que usa Nginx/Postgres, o diretório raiz mudou de:

/opt/apigee/apigee-drupal

para:

/opt/apigee/apigee-drupal/wwwroot

Serviços da API

Validação de entrada mais rigorosa para entidades

Uma validação de entrada mais rigorosa foi aplicada em todas as entidades da organização do Apigee Edge. Os caracteres permitidos geralmente são letras (maiúsculas e minúsculas), números e sublinhados.

As entidades afetadas incluem:

• Organizações
• Ambientes
• Proxies de API
• Revisões de proxy de API
• Nomes de políticas no proxy de API
• IDs de configuração de máscara de rastreamento de depuração
• Nomes de recursos (callout Java, xsl, todos os recursos)
• Keystores
• CRLstores
• Referências de recursos
• Servidores de destino

(MGMT-3840)

Implantação sem inatividade de fluxos compartilhados

Agora, é possível usar uma API de gerenciamento de implantação sem inatividade para implantar fluxos compartilhados e garantir que pouco ou nenhum tráfego de entrada seja rejeitado durante a implantação. O processo é quase idêntico à implantação sem tempo de inatividade para proxies de API usando a API Management. A única diferença é o recurso da API de gerenciamento.

A chamada a seguir implanta a revisão do fluxo compartilhado indicada no URI e cancela a implantação da revisão implantada anteriormente. O parâmetro de consulta override=true permite isso:

curl -X POST -H "Content-type:application/x-www-form-urlencoded" \
https://api.enterprise.apigee.com/v1/o/{org_name}/environments/{env-name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments?"override=true" \
-u email:password

(MGMT-3485)

Monetização

Excluir dados de monetização de uma organização

Talvez seja necessário excluir os dados de monetização da sua organização nos seguintes casos:

• Exclua a organização. Nesse caso, é necessário excluir os dados de monetização antes de excluir a organização.
• Limpe os dados de monetização de uma organização de teste que você quer reutilizar. Nesse caso, sincronize os dados do Apigee Edge depois de excluir os dados de monetização.

Para mais informações, consulte Excluir dados de monetização da sua organização. (DEVRT-2581)

Adição de uma API para ativar a monetização de uma organização

Agora é possível usar uma API para ativar a monetização de uma organização.

Consulte Ativar a monetização para uma organização para mais informações.

(DEVRT-2383)

Bugs corrigidos

Os bugs a seguir foram corrigidos nesta versão. Esta lista é principalmente para usuários que verificam se os tíquetes de suporte foram corrigidos. Ela não foi projetada para fornecer informações detalhadas a todos os usuários.

Private Cloud 4.17.05

Cloud 17.04.12 (UI)

Cloud 17.04.05 (interface)

Cloud 17.03.29 (interface)

Cloud 17.03.15.01 (interface)

Cloud 17.03.15 (interface)

Cloud 17.03.13.02 (monetização)

Cloud 17.03.13.01 (monetização)

Cloud 17.03.13 (gerenciamento de API)

Cloud 17.03.1 (interface)

Cloud 17.02.15 (interface)

Cloud 17.02.13 (tempo de execução da API)

Cloud 17.02.13 (gerenciamento de API)

Cloud 17.01.18 (interface)

Cloud 17.01.16 (gerenciamento de APIs)

Cloud 17.01.16 (monetização)