Você está vendo a documentação do Apigee Edge.
Acesse a
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 o lançamento anterior do Edge para o recurso de nuvem privada (4.16.01), as seguintes versões ocorreram e estão incluídas nesta versão do recurso:
- Nuvem: 16.02.17, 16.03.02, 16.03.09 (UI), 16.03.16 (UI), 16.03.23 (UI), 16.03.30
Consulte Sobre a numeração de versões para entender como saber se uma versão específica do Cloud está incluída 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 das melhorias a seguir, esta versão também contém várias melhorias de usabilidade, desempenho, segurança e estabilidade.
Para mais detalhes e instruções, consulte a documentação do Edge para nuvem privada.
Guias de instalação e operações movidos on-line
Acesse o guia de instalação e operações do Edge para nuvem privada 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, esta
versão é compatível com o Java 1.8. O Oracle JDK 1.8 ou o OpenJDK 8 é obrigatório no
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 ver a lista completa, consulte a seção "Pacotes de criptografia padrão desativados" 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, reversão
Veja a seguir uma lista de mudanças na instalação, no upgrade e nos scripts relacionados. Para informações sobre o uso, consulte a documentação do Edge para nuvem privada.
- Novo processo para atualizar da versão 4.16.01: esta versão substitui o
utilitário
apigee-migrate
pelo utilitárioupdate.sh
para atualizar sua instalação da versão 4.16.01 para a 4.16.05. Consulte Atualizar o Apigee Edge 4.16.01 para 4.16.05. -
Inicialização
bootstrap.sh
(a versão 4.16.01) agora ébootstrap_4.16.05.sh
na 4.16.05.- Não é mais necessário especificar
uname:pword
para fazer o download debootstrap_4.16.05.sh
.
- Rollback: para reverter uma atualização para a versão 4.16.05, desinstale a
versão 4.16.05 do componente e reinstale a versão anterior. O utilitário
rollback.sh
anterior foi removido. Consulte 4.16.05 Processo de reversão. setup.sh
eupdate.sh
podem gravar o arquivo de registros em/tmp
: por padrão, os utilitáriossetup.sh
eupdate.sh
gravam informações de registro em/opt/apigee/var/log/apigee-setup
. Se o usuário que executa o utilitário não tiver acesso a esse diretório, ele vai 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 do BaaS da API: na versão 4.16.01, foi necessário reinstalar o BaaS da API para migrá-la. O novo utilitário
update.sh
oferece suporte à atualização do BaaS da API no local. Consulte Atualizar o Apigee Edge 4.16.01 para 4.16.05.
Administração
Confira a seguir os novos recursos para administração e configuração de nuvem privada.
- Validação da instalação: o utilitário
apigee-validate
usado para testar a instalação da nuvem privada do Edge agora pode ser executado no servidor de gerenciamento. Antes, o script precisava ser executado no processador de mensagens. Consulte Testar a instalação. - Nome da região: pode ser qualquer nome. Nas versões anteriores, o nome estava no formato "dc-#", em que # era um valor inteiro.
- Pods de gateway: os pods de gateway podem ter qualquer nome. Nas versões anteriores, o pod precisava ser nomeado como "gateway".
- Administração baseada em script: um
novo utilitário de linha de comando
apigee-adminapi.sh
permite que você execute as mesmas tarefas de configuração do Edge fazendo chamadas para a API de gerenciamento de borda. Consulte Como usar o utilitário apigee-adminapi.sh. - Configuração silenciosa de SSL do host virtual: ao criar uma organização ou um ambiente, agora é possível transmitir propriedades para configurar o SSL em um host virtual. Consulte Integrar uma organização.
Serviços da API
Confira a seguir os novos recursos para os serviços da API Edge, que foram entregues nas versões anteriores do produto na nuvem.
Prefixo de tamanho fixo para registro de mensagens syslog (Cloud 16.03.30)
A política de geração de registros de mensagens tem um novo elemento <FormatMessage>
na
configuração do Syslog. Ao
definir <FormatMessage>true</FormatMessage>
, as mensagens syslog
começam com um número fixo de caracteres, o que permite filtrar os dados inseridos pela Apigee. Para mais
informações, consulte Política de
geração de registros de mensagens. (APIRT-1398)
Curinga no caminho base do proxy de API (interface do Cloud 16.03.09)
A IU de gerenciamento é compatível com o uso de um ou mais caracteres curinga /*/
nos caminhos base do proxy de API. 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 que você tenha que criar um novo proxy para
oferecer 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 implantado na organização do Edge sem sobrecarga extra na rede. Antes, o encadeamento do proxy de API exigia uma chamada http(s) para outro proxy de API, que encaminhava a solicitação por meio de um balanceador de carga, um roteador e um processador de mensagens.
Novos elementos LocalTargetConnection
estão disponíveis no
TargetEndpoint de um proxy de API, permitindo especificar um nome de 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 um
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. Os novos elementos LocalTargetConnection
também estão listados no esquema 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 se os tíquetes de suporte foram corrigidos. Ela não foi projetada para fornecer informações detalhadas a todos os usuários.
Edge para nuvem privada 4.16.05
Id do problema | Descrição |
---|---|
PRC-770 | O instalador 16.01 falha ao registrar o servidor em espera do Postgres no axgroup. |
PRC-758 | O usuário com função do usuário pode editar relatórios personalizados |
PRC-883 | A atualização do servidor Postgres com a configuração mestre em espera está falhando |
Nuvem 16.03.30
Id do problema | Descrição |
---|---|
SECENG-584 | A verificação de validação para nova linha entre certificados em uma cadeia de certificados causa problemas com alguns certificados em produção |
MGMT-3217 | As chamadas da API Management falham se o nome do KVMap termina em "keys" |
MGMT-3214 | Conflitos de classe podem ocorrer durante JavaFrases de destaque fazendo com que o código Java de um cliente falhe |
MGMT-3185 | Erro ao adicionar administradores da organização a uma organização |
EDGEUI-127 | Recebendo permissões insuficientes com o novo editor de proxy |
EDGEUI-119 | Problema de tempo limite da sessão de interface |
CORESERV-671 | Exibição de erros "Nenhum toque configurado. Não é possível inicializar o serviço cps" |
AXAPP-2345 | Problema ao listar relatórios personalizados do AX para clientes que não são cps |
AXAPP-2302 | O resumo diário das análises da Apigee mostra que não há adesão dos desenvolvedores |
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 JavaScript especificam números de linha incorretos |
APIRT-2508 | Erro de saída ao chamar a detecção expressa em um callback do Vault |
APIRT-2336 | Problema do Gzip com o Node.js |
APIRT-1975 | As configurações de máscara não estão funcionando para message.content |
interface do Cloud 16.03.16
Id do problema | Descrição |
---|---|
MGMT-3142 | Os gráficos não estão carregando 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 pela API |
MGMT-3142 | Os gráficos não estão carregando no painel do Error Analysis |
MGMT-3118 | A interface mostra uma configuração incorreta do host virtual SSL para o parâmetro "clientAuthEnabled" |
DEVRT-2344 | As definições de 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 de atributos personalizados mostram apenas cinco atributos em vez dos 10 permitidos |
DEVRT-1275 | Nem todos os desenvolvedores são exibidos no menu suspenso do plano de tarifa. |
DEVRT-1074 | O desenvolvedor de planos pré-pagos com saldo zero gera uma NullpointerException quando o crédito é aplicado |
Nuvem 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 um WSDL que usa o namespace padrão |
MGMT-1642 | A função do usuário personalizada não tem a permissão "get" para apps do desenvolvedor |
Problemas conhecidos
Esta versão tem os problemas conhecidos a seguir.
Id do problema | Descrição |
---|---|
APIRT-2978 |
O roteador falha ao iniciar o Nginx ou o roteador não inicia Se o roteador de borda falhar ou não iniciar o Nginx, conforme mostrado no arquivo /opt/apigee/var/log/edge-router/logs/system.log, 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 no IPv4 e IPv6 Se você instalou e ativou o NSCD (Name Service Cache Daemon), os processadores de mensagens fazem duas buscas DNS: uma para IPv4 e outra para IPv6. Para desativar a busca DNS no IPv6:
|
PRC-1118 |
Erro ao executar o comando "apigee-service apigee-postgresql pg-data-purge". Se você executar o comando "apigee-service apigee-postgresql pg-data-purge" e vir um erro no formato: ERRO: precisa ser o 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ências de pacote conhecido, o agente do Katello usado no Satellite Server 6 não será instalado corretamente nos hosts do Apigee Edge que executam o daemon Qpid. |
Payloads do JSON em políticas "Atribuir mensagem", "Frase de destaque Java" e "Aumentar falha"
As políticas "Atribuir mensagem", "Frase de destaque Java" e "Aumentar falha" permitem gerar conteúdo de mensagem
usando o elemento <Set><Payload>
. Como parte dessas mensagens, é possível incluir variáveis com valores preenchidos automaticamente no ambiente de execução. Por exemplo, para gerar a data do cabeçalho HTTP, insira {message.header.date}
na mensagem.
Se o formato da mensagem for JSON, ela será parecida com esta:
{"The date is: " : "{message.header.date}"}
No entanto, ele é um JSON incorreto. Para contornar esse problema, você tem duas 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
evariableSuffix
para indicar uma variável em um payload JSON. Por exemplo:
<Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>
Na próxima versão do recurso Edge para nuvem privada, será possível usar chaves para variáveis em mensagens JSON sem problemas. APIRT-1160
O roteador não inicia o Nginx ou não inicia o roteador
Se o roteador de borda não iniciar o Nginx ou falhar, conforme mostrado no arquivo /opt/apigee/var/log/edge-router/logs/system.log, 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