Puedes actualizar la siguiente 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 esta configuración, una etiqueta de imagen siempre apuntará al mismo resumen de imágenes, incluida la etiqueta
latest
predeterminada.Para obtener más información sobre etiquetas de imagen, resúmenes de imágenes y etiquetas de imagen inmutables, consulta Versiones de imagen de contenedor.
Etiquetas de repositorio.
Funciones obligatorias
Si quieres obtener los permisos que necesitas para actualizar la configuración del repositorio,
pídele a tu administrador que te otorgue el
rol de IAM de 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.
Es posible que también puedas obtener los permisos necesarios a través de los roles personalizados o de otros roles predefinidos.
Actualizar configuración
Puedes actualizar la configuración con la consola de Google Cloud o Google Cloud CLI.
Console
Abre la página Repositorios en la consola de Google Cloud.
En la lista de repositorios, selecciona el repositorio y haz clic en Editar repositorio.
Edita los parámetros de configuración que quieras cambiar:
- Cambia la descripción del repositorio.
- Actualiza los detalles de autenticación upstream de tu repositorio remoto.
Habilita o inhabilita 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:
- Borrar una imagen etiquetada
- Quita una etiqueta de una imagen.
- Envía una imagen con una etiqueta que ya se usa en otra versión de la imagen en el repositorio.
- Agregar, quitar o actualizar etiquetas
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 en inmutables, sigue estos pasos:
gcloud artifacts repositories update REPOSITORY \
--project=PROJECT-ID \
--location=LOCATION \
--immutable-tags
Para establecer etiquetas de imagen en 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,..."
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 por la ubicación regional o multirregional. 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 con una descripción para el repositorio
USERNAME
por tu nombre de usuario del repositorio upstream.SECRET_ID
por el nombre del secretoSECRET_VERSION
por la versión del secreto que quieres usar- TAG-SETTING indica cómo se asocian las etiquetas con las versiones de las imágenes.
--no-immutable-tags
: Es la versión de la imagen a la que apunta la etiqueta y puede cambiar. Está permitido 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. No se permiten las siguientes acciones:- Borrar una imagen etiquetada
- Quita una etiqueta de una imagen.
- Envía 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
Para obtener más información sobre cómo trabajar con etiquetas, consulta Repositorios de etiquetas.