Actualiza la configuración del repositorio

Puedes actualizar los siguientes parámetros de configuración del repositorio:

  • Descripción del repositorio
  • Detalles de autenticación upstream del repositorio remoto
  • Etiquetas de imagen inmutables para repositorios de Docker Si habilitas este parámetro de configuración, una etiqueta de imagen siempre apunta al mismo resumen de imágenes, incluida la etiqueta predeterminada latest.

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

  • Etiquetas del repositorio .
  • Parámetros de configuración del análisis de vulnerabilidades scanning settings.

Roles obligatorios

Para obtener los permisos que necesitas para actualizar la configuración del repositorio, pídele a tu administrador que te otorgue el rol de IAM Administrador de Artifact Registry (roles/artifactregistry.admin) en el Google Cloud proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Actualizar configuración

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

Console

  1. Abre la página Repositorios en la Google Cloud console.

    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 quieras cambiar:

    • Cambia la descripción del repositorio.
    • Actualiza los detalles de autenticación upstream del repositorio remoto.
    • Habilita o inhabilita las etiquetas de imagen inmutables en la sección Etiquetas de imagen inmutables. Si habilitas este parámetro de configuración, no se permiten las siguientes acciones:
      • Borrar una imagen etiquetada
      • Quitar una etiqueta de una imagen
      • Enviar una imagen con una etiqueta que ya usa otra versión de la imagen en el repositorio
      • Agregar, quitar o actualizar etiquetas
    • Habilita o inhabilita el análisis de vulnerabilidades.

  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 upstream del repositorio remoto, ejecuta el 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 la etiqueta de imagen, ejecuta uno de los siguientes comandos:

Para establecer etiquetas de imagen como inmutables, haz lo siguiente:

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

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

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

Para actualizar las etiquetas, ejecuta el siguiente comando:

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

Para editar la configuración del análisis de vulnerabilidades, ejecuta uno de los siguientes comandos:

Para inhabilitar el análisis en el repositorio, haz lo siguiente:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --disable-vulnerability-scanning

Para permitir el análisis en el repositorio, haz lo siguiente:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT-ID \
    --location=LOCATION \
    --allow-vulnerability-scanning

Reemplaza los siguientes valores:

  • REPOSITORY es el nombre del repositorio. Si configuraste un repositorio predeterminado, puedes omitir esta marca para usarlo.
  • PROJECT-ID es el Google Cloud ID del proyecto. Si se omite esta marca, se usa el proyecto actual o predeterminado.
  • LOCATION es la ubicación regional o multirregional del repositorio. Usa esta marca para ver los repositorios en una ubicación específica. Si configuraste una ubicación predeterminada, puedes omitir esta marca para usarla.
  • DESCRIPTION es una descripción del repositorio.
  • USERNAME es tu nombre de usuario del repositorio upstream.
  • SECRET_ID es el nombre de tu secreto.
  • SECRET_VERSION es la versión secreta que quieres usar.
  • Las dos marcas de configuración de etiquetas, --no-immutable-tags o --immutable-tags, indican cómo se asocian las etiquetas con las versiones de las imágenes.
    • --no-immutable-tags: La versión de la imagen a la que apunta la etiqueta puede cambiar. Se permite borrar imágenes, quitar etiquetas y cambiar la versión de una imagen a la que apunta una etiqueta.
    • --immutable-tags: En el repositorio, una etiqueta siempre apunta a la misma versión de una imagen. Las siguientes acciones no están permitidas:
      • Borrar una imagen etiquetada
      • Quitar una etiqueta de una imagen
      • Enviar una imagen con una etiqueta que ya usa otra versión de la imagen en el repositorio

  • KEY=VALUE... es una lista de etiquetas separadas por comas que se especifican como pares clave-valor. Por ejemplo: team=team-1,product=example_product,stage=development. Para obtener más información sobre cómo trabajar con etiquetas, consulta Etiqueta repositorios.

¿Qué sigue?