Esta página se aplica à Apigee e à Apigee híbrida.
Confira a documentação da Apigee Edge.
Ao fazer alterações em um proxy de API, é possível salvá-lo como uma nova revisão e implantá-lo no cluster.
Sobre a implantação
Veja na figura a seguir o ciclo de vida da implantação de uma revisão de proxy de API na Apigee.
Limitações de revisão do proxy de API
As seguintes limitações são aplicadas às revisões do proxy de API:
- Se você fizer alterações em um proxy de API, precisará implantá-lo como uma nova revisão.
- Depois que você implantar um proxy de API, a revisão será somente leitura. Não é possível alterar uma revisão de proxy de API (como para fazer alterações incrementais). A única maneira de alterar uma revisão é criar uma nova revisão e implantá-la.
- Os MPs podem implantar um pacote de proxy apenas na íntegra. Se você fizer alterações em fragmentos ou políticas individuais, os MPs continuarão implantando todo o pacote de proxy.
- Se o uso da Apigee distinguir entre
proxies padrão e extensível,
ao implantar uma revisão que altera um proxy de API de um proxy padrão para um proxy extensível:
- pode haver custos. Se você é um cliente de pagamento por uso, consulte os direitos desse modelo. Se você é cliente de uma assinatura, consulte os detalhes do seu plano.
- a implantação requer mais tempo. Durante a janela de implantação, o fluxo de chamadas de API não é interrompido, mas não é possível implantar, cancelar a implantação ou excluir o proxy. Além disso, revisões atuais ou novas não podem ser excluídas durante a janela de implantação. Alterações no proxy de API e a criação de uma nova revisão são permitidas.
Implantação sem inatividade
Todas as implantações de proxy de API bem-sucedidas na Apigee são implantações sem inatividade. As implantações de proxy de API acontecem nesta ordem:
- A revisão 1 do proxy da API
/hello
é implantada e processa o tráfego. - A revisão 2 de
/hello
é implantada. - A revisão 2 é implantada nos processadores de mensagens do plano de ambiente de execução.
- A implantação da revisão 1 é cancelada.
A implantação da revisão do proxy de API é concluída sem tempo de inatividade.
Como visualizar o status da implantação
A implantação de um proxy de API na Apigee não o disponibiliza imediatamente. Leva algum tempo para que o proxy de API seja sincronizado em todos os MPs no plano de ambiente de execução. No entanto, a Apigee oferece ferramentas que podem mostrar algumas informações sobre o status das suas revisões de proxy de API.
IU da Apigee
Na IU da Apigee, há várias visualizações que apresentam o status da implantação dos proxies de API.
Visualização da IU da Apigee | Etapas e descrição |
---|---|
Proxies |
A IU da Apigee usa os seguintes ícones para exibir um status rápido de cada proxy de API: indica que o
proxy de API não foi implantado no ambiente selecionado. Para ver o ícone de status, clique na guia Desenvolver. Se preferir, selecione Desenvolver > Proxies de API e clique em um proxy de API |
API Apigee
Para ver o status da implantação da revisão do proxy de API em um ambiente, use a seguinte chamada de API:
curl "https://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/apis/$API/revisions/$REV/deployments" \ -X GET \ -H "Authorization: Bearer $TOKEN"
Em que $TOKEN
está definido como seu token de acesso OAuth 2.0, conforme descrito em
Como receber um token de acesso OAuth 2.0. Para informações sobre as opções de curl
usadas neste exemplo, consulte
Como usar curl. Para uma descrição das variáveis de ambiente usadas, consulte
Como definir variáveis de ambiente para solicitações de API da Apigee.
Veja a seguir um exemplo de resposta. Neste exemplo, mostramos o status da implantação da revisão 1
do proxy de API helloworld
, que foi implantado no ambiente test
:
{ "environment": "test", "apiProxy": "helloworld", "revision": "1", "deployStartTime": "1559149080457", "pods": [ { "podName": "apigee-runtime-myorg-test-f8bdf9d-2s72w", "deploymentStatus": "deployed", "statusCodeDetails": "Deployment Success", "podStatus": "active", "podStatusTime": "1595357668001" } ], "state": "READY" }
Para mais informações, consulte a API Deployments do ambiente de revisão do proxy de API.
gcloud
Para ver o status da implantação da revisão do proxy de API em um ambiente, use o seguinte comando gcloud:
gcloud alpha apigee deployments describe --api=$API --environment=$ENV
Para mais informações e uma descrição das variáveis de ambiente usadas nos exemplos, consulte Primeiros passos com a gcloud na Apigee.
Veja a seguir um exemplo de resposta. Neste exemplo, mostramos o status da implantação da revisão 1
do proxy de API helloworld
, que foi implantado no ambiente test
:
Using Apigee organization `my-org` Using deployed revision `1` apiProxy: helloworld deployStartTime: '1598032332802' environment: test pods: - deploymentStatus: deployed podName: apigee-runtime-myorg-test-f8bdf9d-2s72w podStatus: active podStatusTime: '1598302128087' statusCodeDetails: Deployment Success revision: '1' state: READY
Para mais informações, consulte Descrever a CLI de implantações.
Próximas etapas
Saiba como implantar: Como implantar um proxy de API
|
Saiba como cancelar a implantação: Como cancelar a implantação de um proxy de API
|