Actualiza la configuración del repositorio

Puedes actualizar la siguiente configuración del repositorio:

  • Descripción del repositorio.

  • Detalles de autenticación ascendente del repositorio remoto.

  • Etiquetas de imagen inmutables para los repositorios de Docker. Si habilitas esta configuración, una etiqueta de imagen siempre apunta al mismo resumen de imágenes, lo que incluye la etiqueta latest predeterminada.

    Para obtener más información sobre etiquetas de imágenes, resúmenes de imágenes y etiquetas de imágenes inmutables, consulta Versiones de imágenes de contenedor.

  • Etiquetas del repositorio.

Roles obligatorios

A fin de obtener los permisos que necesitas para actualizar la configuración del repositorio, haz lo siguiente: solicita a tu administrador que te otorgue el Rol de IAM Administrador de Artifact Registry (roles/artifactregistry.admin) en el proyecto de Google Cloud. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Actualizar configuración

Puedes actualizar la configuración con la consola de Google Cloud o Google Cloud CLI.

Console

  1. Abre la página Repositorios en la consola de Google Cloud.

    Abrir la página Repositorios

  2. En la lista de repositorios, selecciona el repositorio y haz clic en Editar repositorio.

  3. Edita los parámetros de configuración que quieres cambiar:

    • Cambia la descripción del repositorio.
    • Actualiza los detalles de autenticación upstream de tu repositorio remoto.

    • Habilitar o inhabilitar las etiquetas de imagen inmutables en la Sección Etiquetas de imagen inmutables. Si habilitas esta configuración, no se permitirán las siguientes acciones:

      • Borra una imagen etiquetada.
      • Quita una etiqueta de una imagen.
      • Enviar una imagen con una etiqueta que ya se usa en otra versión de la imagen en el repositorio.
      • Agrega, quita o actualiza etiquetas.

  4. Haz clic en Guardar.

gcloud

Para editar la descripción del repositorio, ejecuta el siguiente comando:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --description="DESCRIPTION"

Para actualizar los detalles de autenticación ascendentes de tu repositorio remoto, ejecuta el comando siguiente comando:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT_ID \
    --location=LOCATION \
    --remote-username=USERNAME \
    --remote-password-secret-version=projects/PROJECT_ID/secrets/SECRET_ID/versions/SECRET_VERSION

Para editar la mutabilidad de las etiquetas de imágenes, ejecuta uno de los siguientes comandos:

Para configurar las etiquetas de imagen como inmutables, haz lo siguiente:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --immutable-tags

Para establecer las etiquetas de imagen como mutables, haz lo siguiente:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --no-immutable-tags

Para actualizar etiquetas, ejecuta el siguiente comando:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --update-labels="KEY=VALUE,..."

Reemplaza los siguientes valores:

  • REPOSITORY por el nombre del repositorio Si configuraste un repositorio predeterminado, puedes omitir esta marca para usarlo.
  • PROJECT-ID por el ID del proyecto de Google Cloud. Si se omite esta marca, se usa el proyecto actual o predeterminado.
  • LOCATION con el regional o multirregional location. Usa esta marca para ver los repositorios en una ubicación específica. Si configuraste una ubicación predeterminada puedes omitir esta marca para usar el valor predeterminado.
  • DESCRIPTION con una descripción para el repositorio
  • USERNAME por el nombre de usuario del repositorio upstream
  • SECRET_ID por el nombre del secreto
  • SECRET_VERSION por la versión del secreto que deseas usar.
  • TAG-SETTING indica cómo se asocian las etiquetas con las versiones de imágenes.
  • --no-immutable-tags: Es la versión de la imagen a la que apunta la etiqueta. cambio. Eliminar imágenes, eliminar etiquetas y cambiar la versión de una imagen a la que apunte una etiqueta están permitidos.
  • --immutable-tags: En el repositorio, una etiqueta siempre apunta a la misma versión. de una imagen. No se permiten las siguientes acciones:
    • Borra una imagen etiquetada.
    • Quita una etiqueta de una imagen.
    • Enviar una imagen con una etiqueta que ya se usa en otra versión de la imagen en el repositorio.
  • KEY=VALUE,... con una lista de etiquetas separadas por comas especificadas como pares clave-valor. Por ejemplo: team=team-1,product=example_product,stage=development Más información sobre cómo trabajar con etiquetas, consulta Repositorios de etiquetas.