Actualizar la configuración del repositorio

Puedes actualizar los siguientes ajustes del repositorio:

  • Descripción del repositorio.
  • Etiquetas de imagen inmutables para repositorios de Docker. Si habilita este ajuste, una etiqueta de imagen siempre apuntará al mismo digest de imagen, incluida la etiqueta latest predeterminada.

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

  • Etiquetas del repositorio.

Roles obligatorios

Para obtener los permisos que necesitas para actualizar la configuración del repositorio, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de Artifact Registry (roles/artifactregistry.admin) en el proyecto Trusted Cloud . Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Actualizar configuración

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

Consola

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

    Abre la página Repositorios.

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

  3. Edita los ajustes que quieras cambiar:

    • Cambia la descripción del repositorio.
    • Habilite o inhabilite las etiquetas de imagen inmutables en la sección Etiquetas de imagen inmutables. Si habilitas este ajuste, no se permitirán las siguientes acciones:
      • Eliminar una imagen etiquetada.
      • Quita una etiqueta de una imagen.
      • Envía una imagen con una etiqueta que ya esté en uso en otra versión de la imagen del repositorio.
      • Añadir, quitar o actualizar 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 editar la mutabilidad de la etiqueta de imagen, ejecuta uno de los siguientes comandos:

Para definir etiquetas de imagen como inmutables, sigue estos pasos:

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

Para definir etiquetas de imagen como mutables, sigue estos pasos:

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,..."

Sustituye los siguientes valores:

  • REPOSITORY es el nombre del repositorio. Si has configurado un repositorio predeterminado, puedes omitir esta marca para usar el predeterminado.
  • PROJECT-ID es el Trusted Cloud by S3NS ID del proyecto. Si se omite esta marca, se usará el proyecto actual o el predeterminado.
  • LOCATION es la ubicación regional del repositorio. Usa esta marca para ver los repositorios de una ubicación específica. Si has configurado una ubicación predeterminada, puedes omitir esta marca para usarla.
  • DESCRIPTION es una descripción del repositorio.
  • SECRET_ID es el nombre de tu secreto.
  • SECRET_VERSION es la versión del secreto que quieres usar.
  • Las dos marcas de configuración de etiquetas, --no-immutable-tags o --immutable-tags, indican cómo se asocian las etiquetas a 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 eliminar 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. No se permiten las siguientes acciones:
      • Eliminar una imagen etiquetada.
      • Quita una etiqueta de una imagen.
      • Envía una imagen con una etiqueta que ya esté en uso en otra versión de la imagen del 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 Repositorios de etiquetas.