Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Cuando implementas en un servicio o cambias su configuración, se crea una revisión inmutable.
Las siguientes consideraciones se aplican a las revisiones:
Puedes especificar si una revisión nueva recibirá todo el tráfico, nada de tráfico o parte de él; puedes lanzar una revisión nueva de forma gradual, dividir el tráfico entre varias revisiones y revertir desde una revisión. Para obtener más información, consulta Reversiones, lanzamientos graduales y migración de tráfico.
De manera opcional, puedes usar etiquetas de revisión para probar una revisión que no entrega tráfico.
Las revisiones que no se usan no consumen ningún recurso y no se facturan.
Hay un máximo de 1,000 revisiones por servicio: si superas ese límite, las revisiones anteriores se borrarán de forma automática.
El sufijo de revisión se asigna de forma automática. Si deseas usar tu propio sufijo de versión, puedes hacerlo mediante el parámetro --revision-suffix de Google Cloud CLI.
Visualiza la lista de revisiones de un servicio
Console
Para ver la lista de revisiones del proyecto, debes hacer lo siguiente:
Ve a Knative serving en la consola de Google Cloud:
Ubicar el servicio en la lista de servicios y hacer clic en él
Hacer clic en la pestaña Revisions (Revisiones) para ver la lista de revisiones actuales de ese servicio
Seleccionar la revisión del servicio que te interesa:
Examinar el panel DETALLES (DETAILS) en el extremo derecho para obtener información específica de la revisión, como la URL de la imagen de contenedor que se implementó, la cantidad de memoria asignada, las variables de entorno y, tal vez, la información del repositorio de origen y compilación
Línea de comandos
Para ver los detalles de una revisión en tu proyecto, debes hacer lo siguiente:
Busca el nombre del servicio en la lista de servicios disponibles en el proyecto:
gcloudrunserviceslist
Para enumerar todas las revisiones de un servicio, especifica el nombre de ese servicio en el siguiente comando:
gcloudrunrevisionslist--serviceSERVICE
SERVICE por el nombre del servicio
Muestra los detalles de una revisión mediante la especificación del nombre de esa revisión en el siguiente comando:
gcloudrunrevisionsdescribeREVISION
Reemplaza REVISION por el nombre de la revisión sobre la que deseas obtener más información.
gcloudrunrevisionsdescribeREVISION--formatyaml
Ten en cuenta que una revisión no actual puede tener el estado RETIRED, lo que significa que Knative serving retiró la infraestructura necesaria para esa revisión en particular.
Información del repositorio de origen y compilación en el panel Detalles
Si la API de Artifact Analysis está habilitada y el contenedor se compiló con Cloud Build, la información de compilación se muestra en el panel Detalles.
Además, si se usó un activador de Cloud Build para compilar el contenedor, la información del repositorio de origen también se muestra en el panel Detalles.
Borra revisiones
Un caso práctico común para borrar una revisión es cuando deseas asegurarte de que una revisión determinada no se use de forma accidental.
No puedes borrar una revisión si se cumplen las siguientes condiciones:
La revisión puede recibir tráfico.
Es la única revisión del servicio.
Es la última revisión del servicio.
Cuando borras una revisión, la imagen de contenedor que usa esta revisión no se borra de forma automática de Container Registry o Artifact Registry. Para borrar una imagen de contenedor de un registro, consulta las instrucciones de eliminación de Container Registry o Artifact Registry.
No puedes deshacer la eliminación de una revisión.
Puedes usar Console o la línea de comandos:
Console
Para borrar una revisión, debes hacer lo siguiente:
Ve a Knative serving en la consola de Google Cloud:
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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)"]]
