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

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

Desde a versão anterior do Edge para nuvem privada, as seguintes versões foram ocorreram e estão incluídos neste Lançamento de Recurso:

Consulte Sobre a versão numeração, para entender como descobrir se uma versão específica incluído 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 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 Vaults foram descontinuados.

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

Descontinuações e descontinuações

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

Desativado: adicionando caminhos na guia "Performance" do proxy de API

Até esta versão, você podia navegar para um proxy de API na interface de gerenciamento, acessar na guia "Performance" e criar caminhos diferentes para uma comparação com base em gráficos nas instâncias na guia "Desempenho" e no painel "Transações comerciais". Este recurso foi descontinuado e não é mais estão disponíveis na interface. Para uma alternativa a essa funcionalidade, consulte os seguintes links da Apigee Artigo da comunidade: https://community.apigee.com/articles/23936/alternative-to-business-transactions-api.html (em inglês). EDGEUI-902

Aposentado(a): URL buildInfo do portal de serviços para desenvolvedores

Nas versões anteriores do portal, para determinar sua versão, você abriu o seguinte: URL no navegador:

http://yourportal.com/buildInfo

Na versão 4.17.05, esse link foi removido. Para determinar a versão, abra Relatórios > Entrada de menu do relatório de status no Drupal. A versão do portal aparece na tabela da linha chamado Instalar perfil.

Descontinuação da Apigee loja segura (vault)

A tecnologia Apigee loja, também conhecida como "cofres", está sendo descontinuada e será desativada após um ano data de anúncio de descontinuação mostrada no Descontinuações e de desativação. 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 grupo apigee-access Módulo 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. As KVMs criptografadas são tão seguras quanto cofres e oferecem mais opções de criação e recuperação. (MGMT-3848)

Novos recursos e atualizações

Veja a seguir os novos recursos e melhorias desta versão. Além do seguinte melhorias, essa versão também contém vários recursos de usabilidade, desempenho, segurança e melhorias.

Nuvem privada

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

Agora você precisa usar o parâmetro SMTPMAILFROM no o arquivo de configuração de instalação do Edge. Este parâmetro especifica o endereço de e-mail usada quando o Edge envia e-mails automáticos, como quando um usuário solicita a redefinição de uma senha. Consulte Instale os componentes do Edge em um nó para saber mais.

EDGEUI-1020

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

Agora você pode especificar a duração do tempo limite da API usado pela interface do Edge para controlar por quanto tempo a interface aguarda o retorno de uma chamada de gerenciamento de API. As propriedades a seguir definem o tempo limite:

• conf_apigee_apigee.feature.apitimeout definidos o tempo, em segundos, que a interface espera pelo retorno de uma chamada ao back-end, independentemente de qualquer atividade nele. Se a chamada não for concluída nesse período, a interface emitirá um erro de tempo limite. A o valor padrão é de 180 segundos (3 minutos).
• conf_apigee_play.ws.timeout.idle define como tempo que a interface aguarda, em milissegundos, por atividade no servidor. Ele pode ser definido com o mesmo valor como conf_apigee_apigee_apitimeout ou para um valor menor. A definição com um valor maior não tem efeito. O padrão é 180000. milésimos de segundo (3 minutos).
• conjuntos conf_apigee_play.ws.timeout.connection quanto tempo a interface espera o estabelecimento de uma conexão. Ele pode ser definido com o mesmo valor como conf_apigee_apigee_apitimeout ou para um valor menor. A definição com um valor maior não tem efeito. O padrão é 120000. milissegundos (2 minutos).

Consulte Definir o tempo limite usada pela interface do usuário do Edge para chamadas de gerenciamento da API Edge para saber mais.

EDGEUI-816

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

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

Consulte Como configurar roteador para tentar se conectar a um processador de mensagens por mais tempo.

APIRT-2912

Procedimento adicionado para alterar o administrador padrão do sistema

A documentação para alterar o administrador de sistema padrão foi incluída.

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

(DOS-4895)

Adição de documentação sobre a separação de tarefas de instalação do Edge entre usuários raiz e não raiz

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

Consulte Instalação do Edge Visão geral.

(DOS-4573)

Propriedade adicionada para definir o nome do host de links nos e-mails gerados

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

https://domain/login

O domínio é determinado automaticamente pelo Edge e geralmente é o correto para a organização. No entanto, é possível que, quando a interface do Edge estiver atrás de um balanceador de carga, os eventos automáticos nome de domínio gerado está incorreto. Nesse caso, use a propriedade conf_apigee_apigee.emails.hosturl para defina explicitamente a parte do nome de domínio do URL gerado.

Consulte Como configurar o nome do host para links nos e-mails gerados para saber mais.

EDGEUI-1044

Como configurar o URL de base exibido 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 correspondentes ao local de implantação do proxy. Essa tela pode incluir o número da porta do roteador de host virtual.

Na maioria dos casos, o URL exibido na interface do usuário do Edge é o URL correto para tornar solicitações ao proxy. No entanto, para algumas configurações, o URL exibido não está correto. Por exemplo, qualquer uma das seguintes configurações pode fazer com que o URL exibido não correspondem 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 da Apigee
• Um balanceador de carga configurado com regravação de caminho

O Edge for Private Cloud 4.17.05 e versões mais recentes oferecem suporte a um atributo no host virtual chamado <BaseUrl> que permite substitua o URL exibido pela interface do Edge. Este é um exemplo que mostra o objeto de host virtual com o novo <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, padrão, o URL padrão renderizado pela interface do Edge vai aparecer como: "http://DNS_name_or_IP:9005/", e a configuração de alias de host é http://myCo.com.

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

Consulte Como configurar o TLS acesso a uma API para a nuvem privada.

EDGEUI-5008

Adição de documentação sobre como ativar a geração de registros de depuração

Foi adicionada uma documentação para descrever como ativar/desativar a geração de registros de depuração para o Edge. componentes de solução.

Consulte Como ativar a geração de registros de depuração. para saber mais.

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 para a Apigee as estatísticas sobre APIs tráfego de proxy usando a versão Beta da linha de comando apigee-analytics-collector utilitário. Esse utilitário envia o relatório de volume de chamadas de API de volta à Apigee.

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

Consulte Upload da API Tráfego de dados para a Apigee - Versão Beta para mais.

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

Após atualizar uma nova instalação do 4.17.01 que usa Nginx/Postgres, o diretório raiz alterado 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 alfabetos (todos os casos), 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 da máscara de traces de depuração
• Nomes de recursos (chamada Java, xsl, todos os recursos)
• Keystores
• CRLstores
• Referências de recursos
• Servidores de destino

(MGMT-3840)

Implantação sem inatividade de fluxos compartilhados

Quando você quer implantar fluxos compartilhados e garantir que pouco ou nenhum tráfego de entrada seja rejeitado durante a implantação, agora é possível usar uma API de gerenciamento de implantação sem inatividade. O processo é quase idêntica à implantação sem inatividade para proxies de API que usam a API de gerenciamento. O único a diferença é o recurso da API de gerenciamento.

A chamada a seguir implanta a revisão de fluxo compartilhado indicada no URI e, em seguida, cancela a implantação do revisão implantada anteriormente (o parâmetro de consulta override=true ativa 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

Você pode excluir os dados de monetização da sua organização nos seguintes casos:

• Excluir sua organização. Nesse caso, você precisa excluir os dados de monetização antes de pode excluir a organização.
• Remova os dados de monetização de uma organização de teste que você quer reutilizar. Neste caso, você precisa sincronizar 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 API para ativar a monetização em uma organização

Agora você pode usar uma API para ativar a monetização em uma organização.

Consulte Ativar monetização de uma organização.

(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.

Nuvem privada 4.17.05

Cloud 17.04.12 (interface)

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 APIs)

Cloud 17.03.1 (interface)

Cloud 17.02.15 (interface)

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

Cloud 17.02.13 (gerenciamento de API)

Cloud 17.01.18 (interface)

Cloud 17.01.16 (gerenciamento de API)

Cloud 17.01.16 (monetização)