Visão geral da implantação

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
informações

Neste tópico, apresentamos uma visão geral rápida da implantação do proxy. É possível implantar proxies usando a interface 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 inatividade durante a implantação do proxy de API.

Quando implantar um proxy

É preciso implantar um proxy antes de invocá-lo. Em geral, é você quem decide no momento da implantação. Ao trabalhar em um ambiente de teste, é possível implantar de maneira iterativa várias vezes. Por outro lado, a decisão de implantar um proxy do ambiente de teste em um ambiente de produção geralmente depende das regras de ciclo de vida estabelecidas pela sua equipe de desenvolvimento.

Implante ou reimplante um proxy quando você:

  • Criar um proxy novo (a implantação acontece automaticamente)
  • Modificar um proxy
  • Criar uma nova revisão de um proxy
  • Criar uma nova versão de um proxy
  • Envie um proxy de um ambiente para outro, como de um ambiente de teste para um 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 foram apenas projetados para oferecer uma área para trabalhar e testar as alterações de API e outra área em que as APIs são expostas a aplicativos. 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 ele é desenvolvido. Se você estiver trabalhando na interface, é possível implantar um proxy facilmente com apenas alguns cliques do mouse. Um novo proxy é implantado automaticamente quando você o cria. Você não precisa fazer nada de especial. O procedimento para reimplantar um proxy existente é quase tão simples quanto. Basta selecionar em qual ambiente de implantação implantar, e a IU de gerenciamento cuida do resto. 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 sistema de arquivos, o Apigee Edge vai fornecer uma ferramenta de implantação de linha de comando conveniente para você usar. Também é possível conseguir um script de shell de amostra, que pode ser configurado e executado para fazer upload e implantar os arquivos de proxy. Para mais informações, consulte Como implantar proxies a partir da linha de comando.

Por fim, é possível usar a API Edge Management para implantar proxies. As APIs de implantação expõem funções atômicas que sua equipe de desenvolvimento pode coordenar para automatizar e otimizar o ciclo de desenvolvimento de APIs. Consulte Implantar proxies de API usando a API de gerenciamento.

O que é uma revisão de proxy de API?

As revisões permitem gerenciar atualizações do proxy de API à medida que você as cria e as implanta em um ambiente. As revisões são numeradas em sequência, permitindo que você reverta uma alteração implantando uma revisão anterior do proxy de API.

Somente 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, é preciso remover a implantação de uma revisão atual para que outra possa ser implantada. Outras opções avançadas incluem a substituição de uma revisão implantada ou a opção de não incrementar uma revisão. Por exemplo, às vezes, quando você faz pequenas alterações, pode não querer incrementar a revisão. Essas opções avançadas podem ser feitas por chamadas diretas para a API de gerenciamento do Edge. Consulte Implantar proxies de API usando a API de gerenciamento.

É possível implantar uma revisão de um proxy de API no ambiente prod e continuar criando novas revisões desse proxy de API no ambiente test. Quando estiver tudo pronto, você poderá "promover" a revisão mais recente do proxy de API do ambiente test em vez da revisão anterior do proxy de API no ambiente prod.

Para mais informações sobre revisões, consulte Implantar proxies de API usando a API de gerenciamento e Como implantar proxies na interface.

Vídeo:assista a um vídeo curto para saber mais sobre as revisões de API.