Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Administra imágenes

En esta página, se explica cómo administrar imágenes de contenedor en un repositorio de Docker. La administración de imágenes incluye enumerarlas en un repositorio, agregar etiquetas, borrar etiquetas, copiar imágenes en un repositorio nuevo y borrar imágenes.

Para obtener información sobre cómo enviar y extraer imágenes, consulta la página sobre cómo enviar y extraer imágenes.

Antes de comenzar

  1. Si el repositorio de destino no existe, crea un repositorio nuevo.
  2. Verifica que tengas los permisos necesarios para el repositorio.
  3. (Opcional) Configura valores predeterminados para los comandos de gcloud.

Muestra una lista de imágenes

Puedes enumerar las imágenes con Google Cloud Console o la línea de comandos.

En la lista de repositorios, se incluyen los repositorios de Artifact Registry y Container Registry. Consulta la documentación de Container Registry para la administración de imágenes con el fin de trabajar con imágenes en un repositorio de Container Registry.

Console

Para ver imágenes en un repositorio, haz lo siguiente:

  1. Abre la página Repositorios en Cloud Console.

    Abrir la página Repositorios

  2. Haz clic en el repositorio que contiene el gráfico.

  3. Haz clic en una imagen para ver sus versiones.

gcloud

Para enumerar todas las imágenes en el proyecto, el repositorio y la ubicación predeterminados cuando los valores predeterminados están configurados, haz lo siguiente:

gcloud artifacts docker images list [--include-tags]

Para mostrar imágenes de un repositorio en una ubicación específica, ejecuta el siguiente comando:

gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT/REPOSITORY \
[--include-tags]

Para enumerar todos los resúmenes y las etiquetas de una imagen específica, ejecuta el siguiente comando:

gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE \
[--include-tags]

Reemplaza los siguientes valores:

  • LOCATION es la ubicación regional o multirregional del repositorio.
  • PROJECT es el ID de tu proyecto de Google Cloud. Si el ID de tu proyecto contiene dos puntos (:), consulta Proyectos con alcance de dominio.
  • REPOSITORY es el nombre del repositorio en el que se almacena la imagen.
  • IMAGE es el nombre de la imagen en el repositorio.
  • --include-tags muestra todas las versiones de las imágenes, incluidos los resúmenes y las etiquetas. Si se omite esta marca, en la lista que se muestra, solo se incluyen imágenes de contenedores de nivel superior.

Por ejemplo, considera una imagen con las siguientes características:

  • Ubicación del repositorio: us
  • Nombre del repositorio: my-repo
  • ID del proyecto: my-project
  • Nombre de la imagen: my-image

El nombre completo del repositorio es el siguiente:

us-docker.pkg.dev/my-project/my-repo

El nombre completo de la imagen es:

us-docker.pkg.dev/my-project/my-repo/my-image

Para obtener más información sobre el formato de nombre de imagen, consulta Nombres de repositorio y de imagen.

Etiqueta imágenes

Puedes etiquetar las imágenes existentes en un repositorio de Artifact Registry o puedes etiquetarlas antes de enviarlas a un repositorio.

Etiqueta imágenes en un repositorio

Puedes agregar una etiqueta a una imagen en un repositorio de Artifact Registry mediante Google Cloud Console o la línea de comandos. En un repositorio, las etiquetas son exclusivas de una versión de una imagen. Por lo tanto, si tienes varias versiones de una imagen, cada etiqueta se aplica solo a una de las versiones. Si aplicas a una imagen una etiqueta que ya está en uso, moverás la etiqueta de la versión original a la nueva.

Console

Para etiquetar una imagen en un repositorio, haz lo siguiente:

  1. Abre la página Repositorios en Cloud Console.

    Abrir la página Repositorios

  2. Haz clic en la imagen para ver las versiones de esta.

  3. Selecciona la versión de la imagen que deseas etiquetar.

  4. En la fila de la versión seleccionada, haz clic en Más acciones (Más acciones) y, luego, en Editar etiquetas.

  5. Escribe las etiquetas nuevas en el campo y haz clic en GUARDAR.

gcloud

Para etiquetar imágenes en un repositorio, especifica la versión de la imagen mediante el resumen o la etiqueta de la imagen y, luego, especifica la etiqueta que deseas agregar. Ejecuta uno de los siguientes comandos:

gcloud artifacts docker tags add IMAGE-VERSION TAG

Donde

  • IMAGE-VERSION es el nombre completo de la versión de la imagen que deseas etiquetar mediante el resumen de imágenes o una etiqueta existente en la versión de la imagen.
  • TAG es el nombre completo de la etiqueta que deseas agregar.

Por ejemplo, considera una imagen con las siguientes características:

  • Ubicación del repositorio: us
  • Nombre del repositorio: my-repo
  • ID del proyecto: my-project
  • Nombre de la imagen: my-image
  • Etiqueta existente: iteration6-final
  • Etiqueta que se desea agregar: release-candidate

Para agregar la etiqueta release-candidate a la versión de la imagen con la etiqueta iteration6-final, ejecuta el siguiente comando:

gcloud artifacts docker tags add \
us-docker.pkg.dev/my-project/my-repo/my-image:iteration6-final \
us-docker.pkg.dev/my-project/my-repo/my-image:release-candidate

Para obtener detalles sobre el formato del nombre de la imagen, incluido el manejo de proyectos con alcance de dominio, consulta Nombres de imágenes y repositorios.

Etiqueta imágenes locales

Antes de enviar cualquier imagen local a Artifact Registry, primero debes etiquetarla con el nombre del repositorio. Para obtener instrucciones, consulta Envío y extracción.

Quita las etiquetas de las imágenes

Puedes quitar una etiqueta de una imagen en Artifact Registry mediante Google Cloud Console o la línea de comandos.

Console

  1. Abre la página Repositorios en Cloud Console.

    Abrir la página Repositorios

  2. Haz clic en la imagen para ver las versiones de esta.

  3. Selecciona la versión de la imagen de la que deseas quitar una etiqueta.

  4. En la fila de la versión seleccionada, haz clic en Más acciones (Más acciones) y, luego, en Editar etiquetas.

  5. Borra la etiqueta y haz clic en GUARDAR.

gcloud

Para borrar una etiqueta y quitarla de la imagen, ejecuta el siguiente comando:

 gcloud artifacts docker tags delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE:TAG

Donde

  • LOCATION es la ubicación regional o multirregional del repositorio.
  • PROJECT es el ID de tu proyecto de Google Cloud. Si el ID de tu proyecto contiene dos puntos (:), consulta Proyectos con alcance de dominio.
  • REPOSITORY es el nombre del repositorio en el que se almacena la imagen.
  • IMAGE es el nombre de la imagen en el repositorio.
  • TAG es la etiqueta de la versión que deseas borrar.

Borra imágenes

Puedes borrar una imagen de contenedor completa o borrar una versión específica de una imagen asociada con una etiqueta o un resumen. Una vez que hayas borrado una imagen, no podrás deshacer esta acción.

Hay otras herramientas disponibles que te ayudarán a administrar las imágenes que no se utilizan. Por ejemplo, la herramienta gcr-cleaner busca y borra imágenes antiguas en función de diferentes criterios. Quitar imágenes que no se usan puede ayudarte a reducir los costos de almacenamiento. La herramienta gcr-cleaner no es un producto oficial de Google.

Para borrar una imagen de Google Cloud Console o de la herramienta de gcloud, sigue estos pasos:

Console

  1. Abre la página Repositorios en Cloud Console.

    Abrir la página Repositorios

  2. Haz clic en el nombre de la imagen para ver la versión correspondiente.

  3. Selecciona las versiones que deseas borrar.

  4. Haz clic en BORRAR.

  5. En el cuadro de diálogo de confirmación, haz clic en BORRAR.

gcloud

Para borrar una imagen y todas sus etiquetas, ejecuta el siguiente comando:

gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE --delete-tags

Para borrar una versión específica de una imagen, usa uno de los siguientes comandos.

gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE:TAG [--delete-tags]

o

gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE@IMAGE-DIGEST [--delete-tags]

Donde

  • LOCATION es la ubicación regional o multirregional del repositorio.
  • PROJECT es el ID de tu proyecto de Google Cloud. Si el ID de tu proyecto contiene dos puntos (:), consulta Proyectos con alcance de dominio.
  • REPOSITORY es el nombre del repositorio en el que se almacena la imagen.
  • IMAGE es el nombre de la imagen en el repositorio.
  • TAG es la etiqueta de la versión que deseas borrar. Si varias etiquetas están asociadas a la misma versión de una imagen, debes incluir --delete-tags para borrar la versión de la imagen sin quitar primero las etiquetas.
  • IMAGE-DIGEST es el valor de hash SHA256 de la versión que deseas borrar. Si una etiqueta está asociada con el resumen de la imagen, debes incluir --delete-tags para borrar la versión de la imagen sin quitar primero la etiqueta.
  • --delete-tags quita todas las etiquetas aplicadas a la versión de la imagen. Esta marca te permite forzar la eliminación de una versión de imagen cuando ocurre lo siguiente:
    • Especificaste una etiqueta, pero hay otras etiquetas asociadas con la versión de la imagen.
    • Especificaste un resumen de la imagen que tiene al menos una etiqueta.