Gerenciar revisões

Quando você implanta para um serviço ou altera a configuração dele, uma revisão imutável é criada.

As considerações a seguir se aplicam a revisões:

É possível especificar se uma nova revisão recebe o tráfego total, parcial ou nenhum, implantar gradualmente uma nova revisão, dividir o tráfego entre várias revisões e reverter de uma revisão. Para mais informações, consulte Reversões, lançamentos graduais e migração de tráfego.
Opcionalmente, é possível usar tags de revisão para testar uma revisão que não está veiculando tráfego.
Não é necessário excluir manualmente as revisões, embora isso seja possível.
As revisões não processadas não consomem nenhum recurso e não são faturadas.
Há um máximo de 1.000 revisões por serviço: se você exceder esse limite, as revisões mais antigas serão excluídas automaticamente.
O sufixo de revisão é atribuído automaticamente. Se você quiser usar seu próprio sufixo de versão, insira o parâmetro da CLI --revision-suffix.

Funções exigidas

Se quiser ter as permissões necessárias para gerenciar os serviços e as revisões do Cloud Run, peça ao administrador para conceder a você o Desenvolvedor do Cloud Run (roles/run.developer) do IAM no serviço do Cloud Run.

Para uma lista de papéis e permissões do IAM associados ao Cloud Run, consulte Papéis do IAM do Cloud Run e Permissões do IAM do Cloud Run. Se o serviço do Cloud Run interage com as APIs do Google Cloud, como as bibliotecas de cliente do Cloud, consulte o guia de configuração de identidade de serviço. Para mais informações sobre como conceder papéis, consulte permissões de implantação e gerenciar acesso.

Ver a lista de revisões de um serviço

Console

Para ver a lista de revisões no seu projeto, siga estas etapas:

Acessar o Cloud Run
Na lista, localize e clique no serviço.
Clique na guia Revisões para mostrar a lista de revisões atuais desse serviço.

gcloud

Para visualizar a lista de revisões de um determinado serviço, siga estas etapas:

Encontre o nome do serviço na lista de serviços disponíveis no projeto:
```
gcloud run services list
```
Use o comando a seguir para ver todas as revisões do serviço que você acabou de pesquisar:
```
gcloud run revisions list --service SERVICE --region REGION
```
Substituir
- SERVICE pelo nome do serviço;
- REGION pela região do Google Cloud do serviço.

Cloud Code

Para ver a lista de revisões com o Cloud Code, leia os guias do explorador do Cloud Run para IntelliJ e Visual Studio Code.

Bibliotecas de cliente

Para ver a lista de revisões do código:

API REST

Para conferir a lista de revisões, envie uma solicitação HTTP GET ao endpoint revisions da API Cloud Run Admin.

Por exemplo, usando curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE-NAME/revisions

Substitua:

ACCESS_TOKEN por um token de acesso válido para uma conta com as permissões do IAM para visualizar revisões. Por exemplo, se você fez login no gcloud, é possível recuperar um token de acesso usando gcloud auth print-access-token. Em uma instância de contêiner do Cloud Run, é possível recuperar um token de acesso por meio do servidor de metadados da instância de contêiner.
SERVICE-NAME pelo nome do serviço;
REGION pela região do Google Cloud do serviço.
PROJECT-ID pelo ID do projeto do Google Cloud.

Ver detalhes da revisão

Console

Para ver os detalhes de uma revisão no projeto, siga estas etapas:

Acesse o Cloud Run
Selecione seu serviço na lista.
Clique na guia Revisões para mostrar a lista de revisões atuais desse serviço.
Selecione a revisão de serviço que interessa a você.
Examine o painel DETALHES à direita para informações específicas da revisão, como o URL da imagem do contêiner implantado, a quantidade de memória alocada, as variáveis de ambiente e, possivelmente, as informações do repositório de origem e do build.

gcloud

Para ver os detalhes de uma revisão no projeto, siga estas etapas:

Encontre o nome do serviço na lista de serviços disponíveis no projeto:
```
gcloud run services list
```
Use o comando a seguir para ver todas as revisões do serviço que você acabou de pesquisar:
```
gcloud run revisions list --service SERVICE --region REGION
```
Substituir
- SERVICE pelo nome do serviço;
- REGION pela região do Google Cloud do serviço.
Use o comando a seguir para ver mais detalhes sobre uma revisão específica:
```
gcloud run revisions describe REVISION --region REGION
```
Substituir
- REVISION pelo nome da revisão que você quer saber mais.
- REGION pela região do Google Cloud do serviço.
É possível usar a sinalização --format para formatar a saída. Por exemplo, como YAML:
```
gcloud run revisions describe REVISION --region REGION --format yaml
```

Cloud Code

Para ver os detalhes de uma revisão com o Cloud Code, leia os guias do explorador do Cloud Run para IntelliJ e Visual Studio Code.

Bibliotecas de cliente

Para ver os detalhes de uma revisão do código:

API REST

Para visualizar detalhes sobre uma revisão, envie uma solicitação HTTP GET para o endpoint revisions da API Cloud Run Admin.

Por exemplo, usando curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE-NAME/revisions/REVISION-NAME

Substitua:

ACCESS_TOKEN por um token de acesso válido para uma conta com as permissões do IAM para visualizar detalhes do serviço. Por exemplo, se você fez login no gcloud, é possível recuperar um token de acesso usando gcloud auth print-access-token. Em uma instância de contêiner do Cloud Run, é possível recuperar um token de acesso por meio do servidor de metadados da instância de contêiner.
SERVICE-NAME pelo nome do serviço;
REVISION-NAME pelo nome da revisão.
REGION pela região do Google Cloud do serviço.
PROJECT-ID pelo ID do projeto do Google Cloud.

Observe que uma revisão não atual pode ter o status de RETIRED, o que significa que o Cloud Run retirou a infraestrutura necessária para essa revisão específica.

Sobre as informações do build e do repositório de origem no painel Detalhes

Se a API Artifact Analysis estiver ativada e o contêiner tiver sido criado com o Cloud Build, as informações do build serão exibidas no painel Detalhes.

Além disso, se um gatilho do Cloud Build tiver sido usado para criar o contêiner, as informações do repositório de origem também serão exibidas no painel Detalhes.

Excluir revisões

Um caso de uso comum para excluir uma revisão é quando você quer garantir que uma revisão específica não seja usada acidentalmente.

Não é possível excluir uma revisão se ela:

é capaz de receber tráfego;
é a única revisão do serviço;
é a revisão mais recente do serviço.

Quando você exclui uma revisão, a imagem do contêiner usada por ela não é excluída automaticamente do Container Registry ou do Artifact Registry. Para excluir uma imagem de contêiner de um registro, consulte as instruções de exclusão do Container Registry ou Artifact Registry.

Não é possível desfazer a exclusão de uma revisão.

É possível usar o console ou a linha de comando:

Console

Para excluir uma revisão

Acessar o Cloud Run
Na lista, localize e clique no serviço.
Clique na guia Revisões para mostrar a lista de revisões atuais desse serviço.
Localize a revisão do serviço que você quer excluir.
Clique no botão de três pontos à esquerda da revisão para mostrar o menu Excluir.
Clique em Excluir para excluir a revisão.

gcloud

Para excluir uma revisão, use o comando a seguir:

gcloud run revisions delete REVISION --region REGION

Substituir

Substitua REVISION pelo nome da revisão que você quer excluir.
REGION pela região do Google Cloud do serviço.

Bibliotecas de cliente

Para excluir uma revisão do código:

API REST

Para excluir uma revisão, envie uma solicitação HTTP DELETE ao endpoint revisions da API Cloud Run Admin.

Por exemplo, usando curl:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X DELETE \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE-NAME/revisions/REVISION-NAME

Substitua:

ACCESS_TOKEN por um token de acesso válido para uma conta com as permissões do IAM para excluir um serviço. Por exemplo, se você fez login no gcloud, é possível recuperar um token de acesso usando gcloud auth print-access-token. Em uma instância de contêiner do Cloud Run, é possível recuperar um token de acesso por meio do servidor de metadados da instância de contêiner.
SERVICE-NAME pelo nome do serviço;
REVISION-NAME pelo nome da revisão.
REGION pela região do Google Cloud do serviço.
PROJECT-ID pelo ID do projeto do Google Cloud.

A seguir

Depois de implantar uma revisão, faça o seguinte:

Reversões, lançamentos graduais e migração de tráfego