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

Na terça-feira, 31 de maio de 2016, lançamos uma nova versão do Apigee Edge para nuvem privada.

Desde a versão anterior do Edge para nuvem privada (4.16.01), as seguintes versões 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.

Novos recursos e melhorias

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.

Para mais detalhes e instruções, consulte a documentação do Edge para nuvem privada.

Instalação e Os guias de operações agora estão on-line

Agora você pode acessar o guia de instalação e operações do Edge for Private Cloud na versão 4.18.01.

Atualizações de software

As seguintes atualizações de software estão incluídas na versão:

  • Java JDK 1.8: para aproveitar os recursos mais recentes do Java, este é compatível com o Java 1.8. O Oracle JDK 1.8 ou o OpenJDK 8 é necessário no em seu ambiente.
    Como parte da atualização para o Java 8, algumas criptografias TLS não estão mais disponíveis no Oracle JDK 1.8. Para acessar a lista completa, consulte a seção "Pacotes de criptografia desativados por padrão". http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
  • Cassandra 2.1.13: atualizado do Cassandra 2.0.15.

Instalação, upgrade reverter

Veja a seguir uma lista de alterações na instalação, no upgrade e nos scripts relacionados. Para informações para uso, consulte a documentação do Edge para nuvem privada.

  • Novo processo para atualizar a partir da versão 4.16.01: esta versão substitui o Utilitário apigee-migrate com o update.sh para atualizar o de 4.16.01 a 4.16.05. Consulte Atualizar o Apigee Edge 4.16.01 para 4.16.05.
  • Inicialização
    • O bootstrap.sh (a versão 4.16.01) agora está bootstrap_4.16.05.sh na versão 4.16.05.
    • Não é mais necessário especificar uname:pword para fazer o download bootstrap_4.16.05.sh.
  • Reverter: para reverter uma atualização para a versão 4.16.05, desinstale o 4.16.05 do componente e reinstale a versão anterior. O anterior O utilitário rollback.sh foi removido. Consulte 4.16.05 Processo de reversão.
  • setup.sh e update.sh podem gravar o arquivo de registros /tmp: por padrão, os setup.sh e Os utilitários update.sh gravam informações de registro para /opt/apigee/var/log/apigee-setup. Se o usuário que estiver executando o utilitário não tiver acesso a esse diretório, ele gravará o registro no diretório /tmp. Se o usuário não tiver acesso ao /tmp, o utilitário falhará.
  • Procedimento de atualização BaaS da API: na versão 4.16.01, era necessário reinstalar a API BaaS para migrá-la. O novo utilitário update.sh oferece suporte atualizando o BaaS da API. Consulte Atualizar o Apigee Edge 4.16.01 para 4.16.05.

Administração

Confira a seguir os novos recursos de administração e configuração da nuvem privada.

  • Validação da instalação - O utilitário apigee-validate usado para testar a nuvem privada do Edge agora pode ser executada no servidor de gerenciamento. Antes, era preciso executar o script no processador de mensagens. Consulte Testar a instalar.
  • Nome da região: a região pode ser qualquer nome. Em versões anteriores, o nome era na forma "dc-#", em que # era um valor inteiro.
  • Pods de gateway: os pods de gateway podem ter qualquer nome. Em versões anteriores, o pod precisava ser chamado de "gateway".
  • Administração com base em script: uma o novo utilitário de linha de comando apigee-adminapi.sh permite executar a mesma As tarefas de configuração do Edge que você executa fazendo chamadas para a API Edge Management. Consulte Usar o utilitário apigee-adminapi.sh.
  • Configuração silenciosa de SSL do host virtual: ao criar uma organização ou é possível passar propriedades para configurar o SSL em um host virtual. Consulte Integrar uma organização.

Serviços da API

Veja a seguir novos recursos para os serviços da API Edge, que foram fornecidos na nuvem anterior mais recentes do produto.

Prefixo de tamanho fixo para geração de registros de mensagens syslog (Cloud 16.03.30)

A política de registro de mensagens tem um novo elemento <FormatMessage> em a configuração do Syslog. De configuração <FormatMessage>true</FormatMessage>, mensagens syslog comece com um número fixo de caracteres, o que permite filtrar os dados inseridos pela Apigee. Para mais informações, consulte Mensagem Política de geração de registros. APIRT-1398

Caractere curinga no caminho base do proxy de API (IU do Cloud 16.03.09)

A interface de gerenciamento é compatível com o uso de um ou mais caracteres curinga /*/ no proxy de API. e caminhos base. Por exemplo, um caminho base de /team/*/members permite que os clientes chamem seu proxy com https://[host]/team/blue/members ou https://[host]/team/green/members sem precisar criar um novo proxy para e dar suporte a novas equipes. Observe que /**/ não é permitido. (MGMT-3154)

Encadeamento de proxy de API (Cloud 16.03.02, interface do Cloud 16.03.09)

O Edge oferece suporte ao encadeamento de proxy de API local, o que permite que um proxy de API chame outro proxy de API. implantados na organização de Edge sem sobrecarga adicional de rede. Antes, o proxy de API o encadeamento exigia uma chamada http(s) para outro proxy de API, que encaminhou a solicitação por um balanceador de carga, roteador e processador de mensagens.

Novos elementos LocalTargetConnection estão disponíveis no proxy TargetEndpoint, permitindo que você especifique o nome de um proxy de API, o nome de um ProxyEndpoint específico em um proxy de API, ou simplesmente o caminho base para um recurso de proxy de API local (como /v1/myresource). A interface do editor de proxy também oferece essas opções quando você adiciona ou atualiza o TargetEndpoint.

O encadeamento de proxy também está disponível nas políticas de chamada de serviço.

Para mais informações, consulte Como encadear proxies de API juntas. Os novos elementos LocalTargetConnection também estão listados no XML. aqui: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd. (MGMT-3049, MGMT-3050)

Bugs corrigidos

Os bugs abaixo foram corrigidos nesta versão. Esta lista serve principalmente para usuários que verificam para saber se os tíquetes de suporte foram corrigidos. Ele não foi projetado para fornecer informações para todos os usuários.

Edge para nuvem privada 4.16.05

ID do problema Descrição
PRC-770 O instalador do 16.01 não registra o servidor em espera do Postgres no axgroup
PRC-758 O usuário com função de usuário pode editar relatórios personalizados
PRC-883 A atualização no servidor Postgres com a configuração mestre-esperada é falha

Cloud 16/03/30

ID do problema Descrição
SECENG-584 A verificação de validação para uma nova linha entre certificados em uma cadeia causa problemas com alguns certificados em produção
MGMT-3217 As chamadas da API de gerenciamento falharão se o nome do KVMap terminar em "chaves"
MGMT-3214 Conflitos de classe podem ocorrer durante Java callouts, fazendo com que o código Java de um cliente falhar
MGMT-3185 Erro ao adicionar orgadmins a uma organização
EDGEUI-127 Como receber permissões insuficientes com o novo editor de proxy
EDGEUI-119 Problema de tempo limite da sessão da interface
CORESERV-671 Mensagem "Nenhum toque configurado. Não é possível inicializar o serviço cps" erros
AXAPP-2345 Problema na listagem de relatórios personalizados do AX para clientes que não são clientes do serviço de comparação de preços
AXAPP-2302 O resumo diário das análises da Apigee mostra zero nas métricas de desenvolvedor adoção
APIRT-2750 Falhas de tráfego altas em uma organização específica
APIRT-2516 Os erros de tempo de execução em frases de destaque em JavaScript especificam uma linha incorreta números
APIRT-2508 Erro de saída ao chamar a detecção expressa em um callback do Vault
APIRT-2336 Problema do Gzip com Node.js
APIRT-1975 As configurações de máscara não funcionam para message.content

Interface do Cloud 16.03.16

ID do problema Descrição
MGMT-3142 Os gráficos não carregam no painel do Error Analysis (correção atualizada)

Interface do Cloud 16.03.09

ID do problema Descrição
MGMT-3158 Permissões insuficientes na interface quando o RBAC em proxies individuais é definido a API
MGMT-3142 Os gráficos não carregam no painel do Error Analysis
MGMT-3118 A interface exibe a configuração incorreta do host virtual SSL para "clientAuthEnabled" parâmetro
DEVRT-2344 As definições do relatório de um único dia não carregam transações na interface

Cloud 16/03/02

ID do problema Descrição
MGMT-3083 A atualização automática de registros do Node.js é muito detalhada com mensagens de registro
DEVRT-2275 Os planos de tarifas dos atributos personalizados mostram apenas cinco atributos em vez de 10 permitido
DEVRT-1275 Nem todos os desenvolvedores são mostrados no menu suspenso "Plano de preços"
DEVRT-1074 O desenvolvedor pré-pago sem saldo zero gera uma NullpointerException quando o crédito é aplicada

Cloud 16/02/17

ID do problema Descrição
MGMT-3083 A atualização automática de registros do Node.js é muito detalhada com mensagens de registro
MGMT-3077 A interface gera um pacote de proxy inválido a partir de uma WSDL que usa o namespace
MGMT-1642 A função do usuário personalizada não tem "get" permissão para apps de desenvolvedores

Problemas conhecidos

Esta versão tem os problemas conhecidos a seguir.

ID do problema Descrição
APIRT-2978

O roteador não inicia o Nginx ou o roteador não inicia

Se o roteador de borda não iniciar o Nginx, como mostrado no /opt/apigee/var/log/edge-router/logs/system.log arquivo, depois exclua todos os arquivos no diretório /opt/nginx/conf.d e Reinicie o roteador:

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

O processador de mensagens faz buscas DNS em IPv4 e IPv6

Se você instalou e ativou o NSCD (Name Service Cache Daemon), talvez os processadores de mensagens fazem duas buscas DNS: uma para IPv4 e outra para IPv6.

Para desativar a busca DNS no IPv6:

  1. Em cada nó do processador de mensagens, edite /etc/nscd.conf.
  2. Defina a seguinte propriedade:

    hosts enable-cache Não
PRC-1118

Erro ao executar "apigee-service apigee-postgresql pg-data-purge" comando

Se você executar "apigee-service apigee-postgresql pg-data-purge" comando e verá um erro no formulário:

ERRO: deve ser proprietário da relação

Edite /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge e defina a seguinte propriedade como "apigee":

POSTGRES_USER=apigee
DOC-1687 Devido a um conflito de dependência de pacote conhecido, o agente Katello usado no satélite O Server 6 não será instalado corretamente nos hosts do Apigee Edge que executam o Qpid daemon.

Payloads do JSON no Atribuir políticas de mensagem, chamada Java e aumento de falhas

As políticas "Atribuir mensagem", "Chamada Java" e "Aumentar a falha" permitem que você gere mensagens conteúdo usando o elemento <Set><Payload>. Como parte dessas mensagens, podem incluir variáveis com valores que são preenchidos automaticamente no ambiente de execução. Por exemplo, se você quiser gerar a data do cabeçalho HTTP, é possível insira {message.header.date} na sua mensagem.

Se a mensagem tiver o formato JSON, a aparência vai ser semelhante a esta:

{"The date is: " : "{message.header.date}"}

No entanto, você pode ver que o JSON está incorreto. Para contornar esse problema, você tem dois opções:

  • Escape da chave de abertura com uma barra invertida: 
    \{"The date is: " : "{message.header.date}"}
  • Na configuração do elemento de payload, use os atributos variablePrefix e Atributos variableSuffix para indicar uma variável em um payload JSON. Para exemplo:
    <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>

Na próxima Borda para Versão de Nuvem Privada, você poderá usar chaves para variáveis em mensagens JSON sem problemas. APIRT-1160

O roteador falha ao iniciar Nginx ou O roteador falha ao iniciar

Se o roteador de borda não iniciar o Nginx, como mostrado em /opt/apigee/var/log/edge-router/logs/system.log arquivo, exclua todos os arquivos no diretório /opt/nginx/conf.d e reinicie roteador:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
Anterior
16/04/2001
Próxima
16/04/2008