Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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.
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 --revision-suffix
da Google Cloud CLI.
Como ver a lista de revisões de um serviço
Console
Para ver a lista de revisões no seu projeto, siga estas etapas:
Acesse o Knative serving no console do Google Cloud:
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.
Linha de comando
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:
gcloudrunserviceslist
Liste todas as revisões de um serviço especificando o nome dele
no seguinte comando:
gcloudrunrevisionslist--serviceSERVICE
SERVICE pelo nome do serviço;
Para exibir detalhes de uma revisão, especifique o nome delavno comando a seguir:
gcloudrunrevisionsdescribeREVISION
Substitua REVISION pelo nome da revisão sobre a qual você quer saber
mais.
gcloudrunrevisionsdescribeREVISION--formatyaml
Observe que uma revisão não atual pode ter o status RETIRED, o que significa que
o Knative serving desativou 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.
Como 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:
Acesse o Knative serving no console do Google Cloud:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-04-22 UTC."],[],[],null,["# Managing revisions\n\nWhen you deploy to a service or change the configuration of a service, an\nimmutable revision is created.\n\nThe following considerations apply to revisions:\n\n- You can specify whether a new revision receives all, none, or some of the\n traffic, you can gradually roll out a new revision, you can split traffic\n between several revisions, and you can roll back from a revision. For more\n information, refer to\n [Rollbacks, gradual rollouts, and traffic migration](/kubernetes-engine/enterprise/knative-serving/docs/rollouts-rollbacks-traffic-migration).\n\n- You can optionally use [revision tags](/kubernetes-engine/enterprise/knative-serving/docs/rollouts-rollbacks-traffic-migration#tags)\n to test a revision that is not serving traffic.\n\n- You don't need to [manually delete revisions](#delete), although you can if you want.\n\n- Non-serving revisions do not consume any resources and are not billed.\n\n- There is a maximum of 1000 revisions per service: If you exceed that limit, older revisions are automatically deleted.\n\n- The revision suffix is assigned automatically. If you want to use your own\n version suffix, you can do so using the Google Cloud CLI parameter\n [--revision-suffix](/sdk/gcloud/reference/run/deploy#--revision-suffix).\n\nViewing the list of revisions for a service\n-------------------------------------------\n\n### Console\n\nTo view the list of revisions in your project:\n\n1. Go to Knative serving in the Google Cloud console:\n\n [Go to Knative serving](https://console.cloud.google.com/kubernetes/run)\n2. Locate the service in the services list, and click\n on it.\n\n3. Click the *Revisions* tab to show the list of current revisions for that\n service.\n\n### Command line\n\n\nTo view the list of revisions for a given service:\n\n1. Find your service name from the list of services available in your\n project:\n\n ```bash\n gcloud run services list\n ```\n2. List all the revisions for a service by specifying the name of that\n service in the following command:\n\n \u003cbr /\u003e\n\n ```bash\n gcloud run revisions list --service SERVICE\n ```\n\n \u003cbr /\u003e\n\n Replace \u003cvar translate=\"no\"\u003eSERVICE\u003c/var\u003e with the name of your service.\n\nViewing revision details\n------------------------\n\n### Console\n\nTo view the details of a revision in your project:\n\n1. Go to Knative serving in the Google Cloud console:\n\n [Go to Knative serving](https://console.cloud.google.com/kubernetes/run)\n2. Locate the service in the services list, and click\n on it.\n\n3. Click the *Revisions* tab to show the list of current revisions for that\n service.\n\n4. Select the service revision you are interested in:\n\n5. Examine the *DETAILS* panel at the far right for revision-specific\n information such as the URL of the deployed container image, amount of\n memory allocated, environment variables, and possibly\n [build and source repository information](#build-source).\n\n### Command line\n\nTo view the details of a revision in your project:\n\n1. Find your service name from the list of services available in your\n project:\n\n \u003cbr /\u003e\n\n ```bash\n gcloud run services list\n ```\n\n \u003cbr /\u003e\n\n2. List all the revisions for a service by specifying the name of that\n service in the following command:\n\n \u003cbr /\u003e\n\n ```bash\n gcloud run revisions list --service SERVICE\n ```\n\n \u003cbr /\u003e\n\n Replace \u003cvar translate=\"no\"\u003eSERVICE\u003c/var\u003e with the name of your service.\n3. Display details of a revision by specifying the name of that revision\n in the following command:\n\n \u003cbr /\u003e\n\n ```bash\n gcloud run revisions describe REVISION\n ```\n\n \u003cbr /\u003e\n\n Replace \u003cvar translate=\"no\"\u003eREVISION\u003c/var\u003e with the name of the revision you want to\n learn more about.\n | **Tip:** You can use the [`--format` flag](/sdk/gcloud/reference#--format) to format the output. For example as YAML:\n\n \u003cbr /\u003e\n\n ```bash\n gcloud run revisions describe REVISION --format yaml\n ```\n\n \u003cbr /\u003e\n\nNote that a non-current revision may have the status of `RETIRED`, which means\nthat Knative serving has retired the infrastructure needed for that\nparticular revision.\n\n### About build and source repository information in the *Details* panel\n\nIf the\n[Artifact Analysis API](/container-registry/docs/container-analysis)\nis enabled and the container was built with [Cloud Build](/build),\nbuild information is displayed in the *Details* panel.\n\nAdditionally, if a\n[Cloud Build trigger](/build/docs/running-builds/create-manage-triggers)\nwas used to build the container, source repository information is also displayed\nin the *Details* panel.\n\nDeleting revisions\n------------------\n\nA common use case for deleting a revision is when you want to make sure a\nparticular revision won't be accidentally used.\n\nYou cannot delete a revision if:\n\n- it is able to receive traffic,\n- it is the only revision of the service,\n- it is the latest revision of the service.\n\nWhen you delete a revision, the container image used by this revision is not\ndeleted automatically from Container Registry or Artifact Registry. To delete a\ncontainer image from a registry, see the deletion instructions for\n[Container Registry](/container-registry/docs/managing#deleting_images) or\n[Artifact Registry](/artifact-registry/docs/docker/manage-images#deleting_images).\n\nYou cannot undo a revision deletion.\n\nYou can use either the console or the command line: \n\n### Console\n\nTo delete a revision:\n\n1. Go to Knative serving in the Google Cloud console:\n\n [Go to Knative serving](https://console.cloud.google.com/kubernetes/run)\n2. Locate the service in the services list, and click\n on it.\n\n3. Click the *Revisions* tab to show the list of current revisions for that\n service.\n\n4. Locate the service revision you want to delete.\n\n5. Click the three-dot vertical ellipse to the left of the revision to show\n the *Delete* menu.\n\n6. Click **Delete** to delete the revision.\n\n### Command line\n\nTo delete a revision, use the following command:\n\n\u003cbr /\u003e\n\n```bash\ngcloud run revisions delete REVISION\n```\n\n\u003cbr /\u003e\n\nReplace \u003cvar translate=\"no\"\u003eREVISION\u003c/var\u003e with the name of the revision you want to delete.\n\nWhat's next\n-----------\n\nAfter you deploy a revision, you can do the following:\n\n- [Gradual rollouts, rollback revisions, traffic migration](/kubernetes-engine/enterprise/knative-serving/docs/rollouts-rollbacks-traffic-migration)"]]
