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

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

Na quinta-feira, 24 de março de 2016, lançamos uma nova versão do Apigee Edge para nuvem privada.

Desde o lançamento trimestral anterior do Edge for Private Cloud (4.15.07.00), as seguintes de lançamento ocorreram e estão incluídos nesta Versão de Recurso:

• Google Cloud: 15.07.08, 15.07.22, 15.08.05, migração Nginx, 15.09.02, 15.09.30, 16.01.20
• Nuvem privada: 4.15.07.01, 4.15.07.03

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.

Suspensões de uso

Nuvem privada 4.15.07.03

curl http:// <qpid_IP>:8083/v1/servers/self/queues

Analytics: visualização do painel de relatórios personalizados com vários relatórios (Cloud 15.09.30)

A página Personalizada específica Painel de relatórios, que fornece uma visualização de até quatro relatórios personalizados, está sendo descontinuada e será removida em uma versão futura. (MGMT-2673). Todos os outros aspectos da personalização mas os relatórios ainda estarão disponíveis.

Não é possível substituir o comprimento do nome da organização na nuvem privada

Não é mais possível substituir o comprimento de 20 caracteres do nome da organização definindo:

• APIGEE_ORG_NAME_LENGTH=25
  

• APIGEE_ENV_NAME_LENGTH=25
  

Novos recursos e melhorias

Veja a seguir os novos recursos e melhorias desta versão. Além da seção após as melhorias, essa versão também contém vários recursos de usabilidade, desempenho, melhorias de estabilidade.

Nuvem privada

Adicionado suporte para RedHat, CentOS e Oracle 6.7 a 7.2

Esta versão adiciona suporte ao RedHat Enterprise Linux, CentOS e Oracle Linux versões 6.7 até a 7.2.

Para uma lista completa dos requisitos do sistema, consulte Software e versões compatíveis.

Instalação baseada em RPM

Esta versão do Edge usa um mecanismo de instalação baseado em RPM que simplifica muito a procedimentos de instalação e migração.

Novo diretório base

A estrutura de diretórios da versão Edge 4.16.01 mudou. Em versões anteriores do Edge, instalou o Edge no diretório base:

/<install-dir>/apigee4

Onde install-dir pode estar localizado em qualquer lugar, com um padrão de /opt. Exemplo:

/opt/apigee4

Para a versão 4.16.01, é necessário instalar o Edge no seguinte diretório:

/opt/apigee

Observe também que o apigee4 foi alterado para apigee.

O local do seu diretório de dados não foi afetado. Ele pode estar em /opt/apigee ou em em outro lugar.

Novo requisito de host virtual

O script de migração de borda lida com a maioria das tarefas necessárias para migrar um roteador Netty para Nginx. No entanto, como parte do upgrade, você também deve garantir que todos os seus incluem um alias de host antes da migração.

Consulte o guia de instalação do Edge, disponível no FTP da Apigee. site: ftp://ftp.apigee.com/, para saber como adicionar um alias de host a um host virtual existente para mais.

Código com configuração

Na versão 4.16.01 do Edge, não é mais possível usar arquivos .properties no diretório /<install-dir>/apigee4/conf para configurar os componentes do Edge. A partir da versão 4.16.01, você ainda configura os componentes do Edge usando .properties, mas agora eles estão localizados no diretório:

/opt/apigee/customer/application

Para cada componente do Edge instalado em um nó, haverá um arquivo .properties nesse nó diretório. Para configurar um componente, edite o arquivo .properties correspondente para alterar a de uma propriedade existente ou adicionar uma nova propriedade e um valor novo. Se o arquivo não existir já é possível criá-la.

Ao contrário das versões anteriores do Edge, os arquivos .properties para o Edge 4.16.01 não contêm as propriedades de um componente. Uma das mudanças desta versão é que os arquivos .properties contêm apenas substituições de valores de propriedade padrão.

A vantagem dessa arquitetura é que, na migração para uma versão posterior do Edge, o Edge nunca substitui os arquivos em /opt/apigee/customer/application. Isso elimina a chance de o Edge substituir acidentalmente suas configurações.

Em uma migração, o instalador do Edge examina os arquivos .properties existentes e copia as alterações para definir valores de propriedade padrão no diretório /opt/apigee/token. Portanto, você não precisarão fazer edições depois da migração.

Para mais informações, consulte o Guia de operações do Apigee Edge, disponível no site de FTP da Apigee: ftp://ftp.apigee.com/.

Os scripts de configuração de borda foram substituídos

Os scripts de configuração usados em versões anteriores do Edge foram removidos e substituído por:

• Comandos executados com os utilitários da Apigee, como apigee-service, apigee-all apigee-setup, apiee-provision ou apigee-migrate.
  Por exemplo, os scripts all-start.sh e all-stop.sh foram substituídos pelo seguinte comandos:
  > /opt/apigee/apigee-service/bin/apigee-all start
  > /opt/apigee/apigee-service/bin/apigee-all stop
• Comandos que você executa diretamente nos componentes do Edge. Por exemplo, em versões anteriores Você usou o script chpasswd-openldap.sh para mudar a senha do OpenLDAP. Esse script tem foi substituído pelo seguinte comando que você executa no componente apigee-openldap:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-password -o oldPword -n newPword

Consulte o Guia de operações do Apigee Edge, disponível no FTP da Apigee ftp://ftp.apigee.com/ (links em inglês) para saber como e executar a configuração por meio de comandos.

Novo roteador de borda

Esta versão do Edge para a nuvem privada inclui uma nova arquitetura de roteador baseada na e o roteador Nginx. O roteador Nginx substitui o roteador Netty usado nas versões de borda anteriores a 4.16.01.

Os roteadores Nginx têm os mesmos requisitos de hardware e porta que o roteador Netty, portanto é necessário fazer mudanças nos nós atuais.

Para mais informações, consulte o Apêndice A: Sobre o roteador Nginx, na instalação do Edge disponível no site de FTP da Apigee: ftp://ftp.apigee.com/ (em inglês).

Balanceador de carga do BaaS removido

O balanceador de carga interno foi removido do portal de APIs BaaS. Agora, você deve usar seu próprio balanceador de carga entre o portal da API BaaS e os três nós da pilha de BaaS da API.

Como alternativa a um balanceador de carga, é possível usar o DNS round-robin. Nesse cenário, criar uma entrada DNS com vários registros A correspondentes aos endereços IP da pilha BaaS. Durante uma configuração pesquisa, o servidor DNS retornará automaticamente valores de registro A em formato round-robin.

Nova documentação descrevendo como adicionar nós do Cassandra e ZooKeeper e como adicionar um dado a um data center atual

O arquivo ZIP da documentação no site de FTP da Apigee agora contém "Scaling Edge for Private" Google Cloud" descrevendo como adicionar nós do Cassandra e ZooKeeper e como adicionar um data center a em um data center atual.

Ferramenta organizacional removida

O orgtool pode consultar uma Instalação de borda para receber informações sobre uma organização. Essa ferramenta foi removida. Você usam a interface do usuário do Edge ou chamadas de API para conseguir informações sobre a organização.

Como realizar tarefas em 4.16.01

A tabela a seguir mostra como você executou tarefas em 4.15.07.03 e como você faz isso agora no 4.16.01. Para mais informações, consulte o Guia de operações do Edge, disponível no site de FTP da Apigee: ftp://ftp.apigee.com/.

Versão alfa de a ferramenta de monitoramento e o painel

Essa versão inclui uma versão Alfa da nova ferramenta de monitoramento e um painel para Borda Essa ferramenta permite entender a integridade de vários componentes (Roteadores, Processadores, ZooKeeper, Cassandra), bem como códigos de erro http para várias organizações e ambientes na implantação. Também é possível criar um snapshot dos dados do painel e compartilhá-lo com Apigee para ajudar a resolver incidentes de suporte.

A documentação, incluindo as instruções de instalação, está incluída no arquivo ZIP do Edge. O documento 4.16.01 está disponível no site de FTP da Apigee: ftp://ftp.apigee.com/.

No entanto, antes de instalar e usar o painel, é preciso concluir a avaliação da Apigee Contrato incluído no arquivo ZIP do documento e devolvê-lo à Apigee por e-mail para orders@apigee.com.

Plataforma de borda

Reformulação da interface de gerenciamento (Cloud 15.09.30)

Várias páginas na interface de gerenciamento receberam uma atualização na aparência. (MGMT-2627)

Serviços da API

Assistente de proxy de API reformulado (Cloud 16.01.20)

O assistente de proxy de API foi reformulado. Quando você clica em "+ API Proxy", na página "Proxies de API", na interface de gerenciamento, o novo assistente guia você pelo processo de criação do proxy de API. Todos os as mesmas configurações do assistente de proxy de API anterior estão disponíveis. (MGMT-1376)

Criar proxies de API com documentos OpenAPI (Swagger) (Cloud 16.01.20)

Como parte da reformulação do assistente de proxy de API, agora você pode criar um proxy de API em uma OpenAPI (Swagger). Na primeira página do assistente de proxy de API, clique em Usar OpenAPI ao selecionar Proxy reverso, Node.js App ou Sem destino. No campo exibido, insira o URL para documento da OpenAPI. Para mais informações, consulte Criar um proxy de API simples. (MGMT-1376)

Compatibilidade WSDL 1.2 para proxies SOAP (Cloud 16.01.20)

O Apigee Edge oferece suporte a WSDL 1.2 na criação de proxies de API para chamar serviços SOAP. (MGMT-2835)

Variáveis de SSLInfo nas configurações do TargetEndpoint (Cloud 16.01.20)

Em um TargetEndpoint de proxy de API, você pode definir dinamicamente detalhes de SSL/TLS para oferecer suporte e os requisitos de execução. No exemplo a seguir, veja como SSLInfo seria definido em um TargetEndpoint os valores podem ser fornecidos no ambiente de execução por uma chamada de Java, uma política de JavaScript ou uma política "Atribuir mensagem". Use as variáveis de mensagem que contêm os valores que você quer definir.

<TargetEndpoint>
...
  <SSLInfo>
    <Enabled>{myvars.ssl.enabled}</Enabled>
    <ClientAuthEnabled>{myvars.ssl.client.auth.enabled}</ClientAuthEnabled>
    <KeyStore>{myvars.ssl.keystore}</KeyStore>
    <KeyAlias>{myvars.ssl.keyAlias}</KeyAlias>
    <TrustStore>{myvars.ssl.trustStore}</TrustStore>
  </SSLInfo>
...
</TargetEndpoint>

Esse recurso é abordado nos seguintes documentos:

• Proxy de API referência de configuração
• https://community.apigee.com/articles/21424/dynamic-sslinfo-for-targetendpoint-using-variable.html

APIRT-1475

Suporte ao algoritmo RSA_SHA256 para políticas de declaração SAML (Cloud 16.01.20)

As políticas de asserção SAML agora oferecem suporte ao algoritmo RSA_SHA256, além de RSA_SHA1. APIRT-1779

Validação em uploads de certificados (Cloud 16.01.20)

Para ajudar a impedir o upload de certificados expirados ou inválidos para keystores e truststores, a API de gerenciamento valida os certificados no upload. Os certificados são validados para garantir que O arquivo precisa ter no máximo 50 KB e o formato é PEM ou DER. A validade do certificado também é validada. Para substituir a validação do vencimento padrão (para não validar para a expiração do certificado no upload), use o seguinte parâmetro de consulta: ?ignoreExpiryValidation=true

Para obter mais informações, consulte Faça upload de um arquivo JAR em um Keystore e Faça upload de um certificado para um Truststore. (SECENG-516) e (APIRT-2213)

Pesquisa automática na página de registros do Node.js (Cloud 16.01.20)

Ao visualizar os registros do Node.js no editor de proxy, a página "Registros" do Node.js é automaticamente atualizada periodicamente para listar os novos registros disponíveis. Clique em "Parar atualização automática" para desativar atualização automática. (MGMT-1692)

Cabeçalho HTTP X-Forwarded-For (Cloud 15.09.30)

Para maior segurança, o Edge remove a solicitação HTTP X-Forwarded-For por padrão que pode conter um ou mais endereços IP. O novo comportamento padrão significa que o IP do cliente recebido pelo Edge será o endereço IP que ele recebeu da última conexão TCP e não um endereço com potencial de ser falsificado para burlar a Central de controle de acesso política.

Para alterar esse comportamento padrão e permitir que X-Forwarded-For endereços acessem sua proxies de API, é preciso definir a propriedade feature.enableMultipleXForwardCheckForACL=true na sua organização.

Acesso do JavaScript às propriedades da política (Cloud 15.07.08)

Ao usar o JavaScript em fluxos de proxy de API, você pode acessar as propriedades definidas no arquivo política. Isso é útil principalmente para usar variáveis conhecidas no código JavaScript o código-fonte. Por exemplo, digamos que sua política de JavaScript continha a seguinte definição de propriedade:

<Properties>
    <Property name='source'>response.content</Property>
</Properties>

Em seu JavaScript, você pode acessar a resposta da mensagem com uma referência à "origem" da seguinte forma:
var source = properties.get('source'); // returns: response.content
ou
var source = properties.source e
ou
var source = properties['source']

Para mais informações, consulte a política de JavaScript. APIRT-1460

Auditorias no nível da organização (Cloud 15.07.08)

Os administradores da organização podem auditar o histórico de ações realizadas no nível da organização. Na interface de gerenciamento, selecione Administrador > Histórico da organização. Para mais informações, consulte Auditorias: API, produto e da organização. (MGMT-2232)

Autorremoção do papel de administrador da organização (Cloud 15.07.08)

Os administradores da organização podem remover a si mesmos do papel de administrador da organização em interface de gerenciamento em Administrador > usuários da organização e Clique em Remover ao lado do nome. (MGMT-934)

Indicador de progresso da importação de pacotes de proxy de API (Cloud 15.07.08)

Ao fazer o upload de um pacote grande de proxy de API na interface de gerenciamento, um endereço de e-mail animação é exibido para indicar que a importação ainda está ocorrendo, o que impede você de interagir com o de gerenciamento de projetos até que a importação seja concluída. (MGMT-1285)

Comportamento e configuração do cache (Cloud 15.07.22)

Para melhor gerenciamento e utilização do cache na memória, a opção "Máximo de elementos na memória" configurações nos recursos de cache do ambiente foram descontinuadas a partir da versão 15.06.10 do Edge Cloud. Em versão 15.07.22 do Edge Cloud, essa configuração foi removida da interface "Criar cache" Parte de configuração do ambiente da IU de gerenciamento do Apigee Edge.

O total de elementos presentes em todos os recursos do cache (inclusive o cache padrão) depende a memória total alocada para o cache. Por padrão, a quantidade total de memória alocada o armazenamento em cache em um determinado processador de mensagens representa 40% da memória total disponível. Os elementos serão eliminados do cache na memória somente quando não há memória suficiente ou os elementos expiram. (MGMT-2413, APIRT-1140)

Configuração do servidor de destino na interface de gerenciamento (Cloud 15.07.22)

As APIs > A página de configuração do ambiente na interface do usuário de gerenciamento agora permite adicionar, editar e e excluir servidores de destino.

Além disso, a página foi reformulada para que caches também possam ser criados, adicionados e excluídos inline, em vez de ir para uma nova página. Várias propriedades de cache, incluindo "Máximo elementos na memória", não estão mais disponíveis na interface, porque a definição dessas propriedades não tem mais qualquer efeito no comportamento do cache no momento da execução. (MGMT-280)

SSL com geração de registros de mensagens para o syslog (Cloud 15.07.22)

A política de registro de mensagens permite o envio de syslog para provedores de gerenciamento de registros de terceiros. por SSL/TLS. Use o seguinte na configuração da política como filho direto do pai :

<SSLInfo>
    <Enabled>true</Enabled>
</SSLInfo>

Para mais informações, consulte a Política de registro de mensagens. APIRT-942

Interface de gerenciamento (Cloud 15.07.22)

A engenharia da Apigee fez várias pequenas correções de bugs e melhorias de usabilidade no gerenciamento de ML pela IU.

cURL no Trace (Cloud 15.09.02)

Ao rastrear uma chamada de proxy de API que faz uma solicitação a um servidor de destino, é possível visualizar as para o servidor de destino como um comando cURL. Selecione a "Solicitação enviada ao servidor de destino" etapa no diagrama do Mapa de transações e, em seguida, clique no botão na página "Solicitação enviada ao servidor" coluna no painel "Detalhes da fase". (MGMT-2589)

Caracteres especiais para mascaramento de dados (Cloud 15.09.02)

Ao usar o mascaramento de dados para mascarar dados confidenciais em payloads JSON, caracteres especiais como $, * e { agora podem ser mascarados. APIRT-1727

Mapas de chave-valor na IU de gerenciamento (Cloud 15.09.30)

Agora é possível criar e gerenciar mapas de chave-valor (KVMs) no escopo do ambiente no gerenciamento de borda de ML pela IU. As KVMs com escopo de ambiente contêm pares de chave-valor acessíveis por qualquer proxy de API em uma ambiente, como teste ou produção. No menu da interface de gerenciamento, acesse APIs > Configuração do ambiente > selecione o ambiente desejado > Mapas de chave-valor guia. Para obter mais informações, consulte Criação e edição mapas de chave-valor de ambiente. (MGMT-1393)

Expiração padrão da política PreencherCache na interface de gerenciamento (Cloud 15.09.30)

Ao adicionar uma política FillCache com o editor de proxy de API, o <TimeoutInSec> elemento para expiração do cache é pré-preenchido com um valor de 3.600 segundos (1 hora). O padrão anterior de 300 segundos (5 minutos). (MGMT-2622)

Serviços para desenvolvedores

Desempenho da página do produto da API, nenhum app para desenvolvedores listado (Cloud 16.01.20)

Ao visualizar um produto de API na interface de gerenciamento, os aplicativos dos desenvolvedores associados a ele produto estão listados. Para melhorar o desempenho da interface, a lista de apps do desenvolvedor não é exibida quando editar o produto de API. (MGMT-2869)

Coluna da chave na página "Apps para desenvolvedores" (Cloud 15.08.05)

Em organizações com um grande número de apps de desenvolvedores (milhares), mostrar a coluna "Chave" na página "Apps do desenvolvedor" (mostra o número de chaves por app) pode prejudicar o desempenho da tela. Para melhorar o desempenho da tela nessa situação, entre em contato com o suporte da Apigee para definir o seguinte propriedade no nível da organização: features.appsNoCredentialsEnabled = true. Isso remove a coluna Key. Observe, entretanto, que remover a coluna Key também remove as a capacidade de pesquisar por chave e segredo do cliente. (MGMT-2486)

Ícone de progresso da página "Detalhes do desenvolvedor" (Cloud 15.09.30)

Quando a página "Detalhes do desenvolvedor" é carregada na interface de gerenciamento, a seção "Apps" da página mostra um ícone de carregamento de progresso se os apps ainda estiverem sendo carregados. Isso melhora o comportamento anterior em que a seção "Apps" aparecia vazia ao carregar apps. (MGMT-2667)

Monetização

Editar nomes de pacotes de APIs (Cloud 16.01.20)

É possível atualizar o nome de um pacote de API a qualquer momento durante o ciclo de monetização, mesmo quando o pacote da API tem um plano de tarifas publicado. (DEVRT-2177)

decimais permitidos em atributos personalizados (Cloud 16.01.20)

Ao usar uma "Tabela de preços com atributo personalizado" plano, o atributo personalizado na mensagem que é usado como multiplicador da transação agora pode ter um valor decimal de até quatro casas decimais. Para mais informações sobre esse tipo de plano, consulte Especificar detalhes do atributo personalizado da tabela de preços (DEVRT-2191).

Nome e ID do plano de tarifação em relatórios resumidos (Cloud 15.09.02)

Ao gerar um relatório de resumo da receita com a API de gerenciamento, é possível adicionar "Plano de tarifas" nome e classifique "ID do plano" colunas ao relatório. Para fazer isso, adicione "RATEPLAN". como um atributo groupBy a chamada de API, conforme descrito em Criar . Esse recurso ainda não está disponível na interface do relatório de monetização. Em as colunas "Nome do plano de tarifação" e "ID" estão localizadas perto da parte da frente junto com as outras colunas de agrupamento. (DEVRT-1740)

Serviços de análise

função sum( ) nas métricas de tempo de resposta (Cloud 16.01.20)

Em relatórios personalizados de análise e chamadas de API, a "sum" a função agregada já está disponível para Meta de Tempo de Resposta, Tempo Total de Resposta e end_point_response_time. Por exemplo, na API /stats (http://docs.apigee.com/management/apis/get/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/stats/%7Bdimension_name%7D-0), agora você pode usar o seguinte "select" parâmetro de consulta: ?select=sum(total_response_time). (AXAPP-2006)

Relatório de análise de latência: nomes de proxy de API classificados (Cloud 16.01.20)

Na interface do relatório de análise de latência (somente nos planos empresariais do Apigee Edge), os proxies de API são em ordem alfabética na lista suspensa Proxy. (MGMT-2858)

Apps para desenvolvedores no painel por nome de exibição (Cloud 16.01.20)

No painel da interface de gerenciamento, o gráfico de barras "Apps para desenvolvedores" lista os apps dos desenvolvedores por exibição. em vez de um nome interno. (MGMT-2853)

Novo widget de data/hora em relatórios personalizados (Cloud 16.01.20)

O widget do seletor de data/hora em uma página de relatórios personalizados na interface de gerenciamento foi aprimorado. (MGMT-2881)

Detalhamento de cidades no GeoMap (Cloud 15.07.22)

O GeoMap analítico inclui uma "Cidade" detalhamento para Estados Unidos e Canadá. Quando você clique em um estado ou província no mapa para ver uma lista das cidades de origem das chamadas. (MGMT-2282)

| (barra vertical) e = caracteres nos relatórios personalizados de análise (Cloud 15.09.02)

As definições de relatórios personalizados do Google Analytics são compatíveis com o uso de | (barra vertical) e =. Antes disso, A codificação %7C e %3D precisava ser usada para esses símbolos. (MGMT-2504)

Dimensão "Sufixo do caminho do proxy" (Cloud 15.09.30)

Uma nova dimensão "Sufixo do caminho do proxy" (proxy_pathsuffix) está disponível nos relatórios personalizados do Google Analytics e chamadas de API. O sufixo do caminho do proxy faz parte do URL de um proxy de API que vem depois do caminho base. como o caminho criado para fluxos condicionais. (AXAPP-1902)

Os relatórios mostram IDs de desenvolvedores, e não nomes de exibição (Cloud 15.09.30)

Ao fazer chamadas da API Edge analytics com a API /stats, que retorna desenvolvedores, a o nome de exibição do desenvolvedor é retornado junto com o ID do desenvolvedor. Antes, apenas o ID do desenvolvedor era retornados. (AXAPP-1759)

Bugs corrigidos

Os bugs abaixo foram corrigidos nesta versão.

Nuvem privada 4.16.01

A tabela a seguir lista os bugs corrigidos desde a versão 4.16.01 do Edge for Private Cloud. Para obter essas correções, siga as instruções para atualizar a instalação do 4.16.01 para a versão mais recente RPMs e arquivos de suporte, conforme descrito em Atualizar Apigee Edge 4.16.01.x para a versão 4.16.01 mais recente.

Cloud 16/01/20

Cloud 15/07/08

Cloud 15/07/22

Cloud 15/08/05

Cloud 15/09/02

Cloud 15/09/30

Nuvem privada 4.15.07.03

Nuvem privada 4.15.07.01

Problemas conhecidos

Esta versão tem os problemas conhecidos a seguir.

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart