Você está visualizando a documentação do Apigee Edge.
Acesse a
documentação da
Apigee X. info
Este tópico apresenta uma visão geral rápida da implantação de proxy. É possível implantar proxies usando a IU de gerenciamento, scripts de linha de comando ou APIs.
Vídeo:assista um vídeo curto para saber mais sobre as práticas recomendadas para evitar tempo de inatividade durante a implantação do proxy da API.
Quando implantar um proxy
Um proxy precisa ser implantado antes de ser invocado. Geralmente, a decisão é sua. Ao trabalhar em um ambiente de teste, você pode implantar de forma iterativa muitas vezes. Por outro lado, a decisão de implantar um proxy do ambiente de teste para um ambiente de produção geralmente depende das regras de ciclo de vida estabelecidas pela equipe de desenvolvimento.
Implante ou reimplante um proxy quando:
- Criar um novo proxy (a implantação acontece automaticamente)
- Modificar um proxy
- Criar uma nova revisão de um proxy
- Criar uma nova versão de um proxy
- Enviar um proxy de um ambiente para outro, por exemplo, de um ambiente de teste para um ambiente de produção.
- Exclua e recrie um keystore.
Onde implantar um proxy
Você implanta um proxy em um ambiente. Por padrão, todas as organizações no Apigee Edge
têm dois ambientes chamados test e prod. Esses ambientes são apenas
projetados para fornecer uma área para trabalhar e testar mudanças de API e outra área em que
as APIs são expostas aos apps. A figura a seguir mostra um proxy implantado no
ambiente test, conforme indicado pelo ponto verde.
Como implantar um proxy
A forma de implantação de um proxy depende de onde você está desenvolvendo o proxy. Se você estiver trabalhando na interface, poderá implantar um proxy com apenas alguns cliques do mouse. Um novo proxy é implantado automaticamente quando você o cria. Não é preciso fazer nada especial. O procedimento para reimplantar um proxy existente é quase tão simples. Basta selecionar o ambiente de implantação e a interface de gerenciamento cuida do restante. Para mais informações, consulte Como implantar proxies na IU.
Se você estiver desenvolvendo proxies e componentes relacionados off-line (ou seja, trabalhando com arquivos XML de proxy e outros códigos diretamente no seu sistema de arquivos), o Apigee Edge oferece uma ferramenta de implantação de linha de comando conveniente. Você também pode conferir um exemplo de script de shell que pode ser configurado e executado para fazer upload e implantar seus arquivos de proxy. Para mais informações, consulte Como implantar proxies na linha de comando.
Por fim, você pode usar a API de gerenciamento do Edge para implantar proxies. As APIs de implantação expõem funções atômicas que podem ser coordenadas pela equipe de desenvolvimento para automatizar e otimizar o ciclo de vida de desenvolvimento da API. Consulte Implantar proxies de API usando a API Management.
O que é uma revisão de proxy de API?
Com as revisões, você pode gerenciar as atualizações do proxy da API enquanto as cria e implanta em um ambiente. As revisões são numeradas sequencialmente, permitindo que você reverta uma mudança implantando uma revisão anterior do proxy da API.
Apenas uma revisão de um proxy de API pode ser implantada em um ambiente em um determinado momento se as revisões compartilharem o mesmo caminho base do proxy de API.
Normalmente, uma revisão atual precisa ser desimplantada antes que uma nova possa ser implantada. Outras opções avançadas incluem substituir uma revisão implantada ou optar por não incrementar uma revisão. Por exemplo, às vezes, quando você faz mudanças menores, talvez não queira incrementar a revisão. Essas opções avançadas podem ser alcançadas com chamadas diretas para a API de gerenciamento do Edge. Consulte Implantar proxies de API usando a API Management.
É possível implantar uma revisão de um proxy de API no ambiente prod e, ao mesmo tempo, continuar criando novas revisões desse proxy no ambiente test. Quando
estiver tudo pronto, será possível "promover" a revisão mais alta do proxy da API no ambiente test
com a revisão anterior do proxy da API no ambiente prod.
Para mais informações sobre revisões, consulte Implantar proxies de API usando a API Management e Implantar proxies na IU.
Vídeo:assista um vídeo curto para saber mais sobre as revisões de API.