Administrar revisiones

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.
  • No es necesario que borres las revisiones de forma manual, aunque puedes hacerlo.
  • 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 la CLI de gcloud.

Roles obligatorios

Para obtener los permisos que necesitas para administrar los servicios y las revisiones de Cloud Run, pídele a tu administrador que te otorgue el rol de IAM Desarrollador de Cloud Run (roles/run.developer) en el servicio de Cloud Run.

Para obtener una lista de los roles y los permisos de IAM asociados con Cloud Run, consulta los roles de IAM de Cloud Run y los permisos de IAM de Cloud Run. Si tu servicio de Cloud Run interactúa con las APIs de Google Cloud, como las bibliotecas cliente de Cloud, consulta la guía de configuración de identidades del servicio. Para obtener más información acerca de cómo otorgar roles, consulta Permisos de implementación y Administra el acceso.

Visualiza la lista de revisiones de un servicio

Console

Para ver la lista de revisiones del proyecto, debes hacer lo siguiente:

  1. Ir a Cloud Run

  2. Ubicar el servicio en la lista de servicios y hacer clic en él

  3. Hacer clic en la pestaña Revisions (Revisiones) para ver la lista de revisiones actuales de ese servicio

    lista de revisiones

gcloud

Para ver la lista de revisiones de un servicio determinado, sigue estos pasos:

  1. Busca el nombre del servicio en la lista de servicios disponibles en el proyecto:

    gcloud run services list

  2. Usa el siguiente comando para obtener todas las revisiones del servicio que acabas de buscar:

    gcloud run revisions list --service SERVICE --region REGION

    Reemplazar

    • SERVICE por el nombre de tu servicio.
    • REGION por la región de Google Cloud del servicio.

Cloud Code

Para ver la lista de revisiones con Cloud Code, lee las guías de Cloud Run Explorer sobre IntelliJ y Visual Studio Code.

Bibliotecas cliente

Para ver la lista de revisiones desde el código, usa las siguientes opciones:

API de REST

Para ver la lista de revisiones, envía una solicitud HTTP GET al extremo revisions de la API de Cloud Run Admin.

Por ejemplo, con 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

Reemplaza lo siguiente:

  • ACCESS_TOKEN por un token de acceso válido para una cuenta que tenga los permisos de IAM para ver revisiones. Por ejemplo, si accediste a gcloud, puedes recuperar un token de acceso con gcloud auth print-access-token. Desde una instancia de contenedor de Cloud Run, puedes recuperar un token de acceso a través del servidor de metadatos de instancias de contenedor.
  • SERVICE-NAME por el nombre del servicio
  • REGION por la región de Google Cloud del servicio.
  • PROJECT-ID por el ID del proyecto de Google Cloud.

Consulta los detalles de las revisiones

Console

Para ver los detalles de una revisión en tu proyecto, debes hacer lo siguiente:

  1. Ir a Cloud Run

  2. Selecciona tu servicio en la lista de servicios.

  3. Hacer clic en la pestaña Revisions (Revisiones) para ver la lista de revisiones actuales de ese servicio

  4. Seleccionar la revisión del servicio que te interesa:

  5. 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

    imagen

gcloud

Para ver los detalles de una revisión en tu proyecto, debes hacer lo siguiente:

  1. Busca el nombre del servicio en la lista de servicios disponibles en el proyecto:

    gcloud run services list

  2. Usa el siguiente comando para obtener todas las revisiones del servicio que acabas de buscar: 

    gcloud run revisions list --service SERVICE --region REGION

    Reemplazar

    • SERVICE por el nombre de tu servicio.
    • REGION por la región de Google Cloud del servicio.

  3. Usa el siguiente comando para ver más detalles sobre una revisión específica:

    gcloud run revisions describe REVISION --region REGION
     Reemplaza

    • REVISION por el nombre de la revisión sobre la que quieres obtener más detalles.
    • REGION por la región de Google Cloud del servicio.

    Puedes usar la marca --format para dar formato al resultado. Por ejemplo, como YAML: 

    gcloud run revisions describe REVISION --region REGION --format yaml

Cloud Code

Para ver los detalles de una revisión con Cloud Code, lee las guías de Cloud Run Explorer sobre IntelliJ y Visual Studio Code.

Bibliotecas cliente

Para ver los detalles de una revisión desde el código, usa las siguientes opciones:

API de REST

Para ver los detalles de una revisión, envía una solicitud HTTP GET al extremo revisions de la API de Cloud Run Admin.

Por ejemplo, con 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

Reemplaza lo siguiente:

  • ACCESS_TOKEN por un token de acceso válido para una cuenta que tenga los permisos de IAM para ver los detalles del servicio. Por ejemplo, si accediste a gcloud, puedes recuperar un token de acceso con gcloud auth print-access-token. Desde una instancia de contenedor de Cloud Run, puedes recuperar un token de acceso a través del servidor de metadatos de instancias de contenedor.
  • SERVICE-NAME por el nombre del servicio
  • REVISION-NAME por el nombre de la revisión.
  • REGION por la región de Google Cloud del servicio.
  • PROJECT-ID por el ID del proyecto de Google Cloud.

Ten en cuenta que una revisión no actual puede tener el estado RETIRED, lo que significa que Cloud Run 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 las 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:

  1. Ir a Cloud Run

  2. Ubicar el servicio en la lista de servicios y hacer clic en él

  3. Hacer clic en la pestaña Revisions (Revisiones) para ver la lista de revisiones actuales de ese servicio

  4. Ubicar la revisión del servicio que deseas borrar

  5. Hacer clic en los tres puntos verticales ubicados a la izquierda de la revisión para ver el menú Delete (Borrar)

    revision-delete

  6. Hacer clic en Delete (Borrar) para borrar la revisión

gcloud

Para borrar una revisión, usa el siguiente comando:

gcloud run revisions delete REVISION --region REGION

Reemplazar

  • Reemplaza REVISION por el nombre de la revisión que quieres borrar.
  • REGION por la región de Google Cloud del servicio.

Bibliotecas cliente

Para borrar una revisión desde el código, usa las siguientes opciones:

API de REST

Para borrar una revisión, envía una solicitud HTTP DELETE al extremo revisions de la API de Cloud Run Admin.

Por ejemplo, con 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

Reemplaza lo siguiente:

  • ACCESS_TOKEN por un token de acceso válido para una cuenta que tenga los permisos de IAM para borrar un servicio. Por ejemplo, si accediste a gcloud, puedes recuperar un token de acceso con gcloud auth print-access-token. Desde una instancia de contenedor de Cloud Run, puedes recuperar un token de acceso a través del servidor de metadatos de instancias de contenedor.
  • SERVICE-NAME por el nombre del servicio
  • REVISION-NAME por el nombre de la revisión.
  • REGION por la región de Google Cloud del servicio.
  • PROJECT-ID por el ID del proyecto de Google Cloud.

¿Qué sigue?

Después de implementar una revisión, puedes hacer lo siguiente: