Vous pouvez mettre à jour les paramètres de dépôt suivants:
Description du dépôt
Détails de l'authentification en amont du dépôt distant.
Tags d'image immuables pour les dépôts Docker. Si vous activez ce paramètre, un tag d'image pointe toujours vers le même condensé d'image, y compris le tag
latest
par défaut.Pour en savoir plus sur les tags d'image, les condensés d'images et les tags immuables, consultez la page Versions d'images de conteneurs.
Les étiquettes des dépôts
Rôles requis
Pour obtenir les autorisations dont vous avez besoin pour mettre à jour les paramètres du dépôt, demandez à votre administrateur de vous attribuer le rôle IAM Administrateur Artifact Registry (roles/artifactregistry.admin
) sur le projet Google Cloud.
Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.
Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.
Mettre à jour les paramètres
Vous pouvez modifier les paramètres à l'aide de la console Google Cloud ou de Google Cloud CLI.
Console
Ouvrez la page Dépôts de la console Google Cloud.
Dans la liste des dépôts, sélectionnez le dépôt et cliquez sur Modifier le dépôt.
Modifiez les paramètres de votre choix:
- Modifiez la description du dépôt.
- Mettez à jour les informations d'authentification en amont de votre dépôt distant.
Activez ou désactivez les tags d'image immuables dans la section Tags d'image immuables. Si vous activez ce paramètre, les actions suivantes ne sont pas autorisées:
- Supprimer une image taguée
- Supprimez un tag associé à une image.
- Transférez une image avec un tag qui est déjà utilisé par une autre version de l'image dans le dépôt.
- Ajoutez, supprimez ou mettez à jour des libellés.
Cliquez sur Enregistrer.
gcloud
Pour modifier la description du dépôt, exécutez la commande suivante:
gcloud artifacts repositories update REPOSITORY \
--project=PROJECT-ID \
--location=LOCATION \
--description="DESCRIPTION"
Pour mettre à jour les informations d'authentification en amont de votre dépôt distant, exécutez la commande suivante:
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
Pour modifier la mutabilité du tag d'image, exécutez l'une des commandes suivantes:
Pour définir les tags d'image comme immuables:
gcloud artifacts repositories update REPOSITORY \
--project=PROJECT-ID \
--location=LOCATION \
--immutable-tags
Pour définir des tags d'image comme modifiables:
gcloud artifacts repositories update REPOSITORY \
--project=PROJECT-ID \
--location=LOCATION \
--no-immutable-tags
Pour mettre à jour les étiquettes, exécutez la commande suivante:
gcloud artifacts repositories update REPOSITORY \
--project=PROJECT-ID \
--location=LOCATION \
--update-labels="KEY=VALUE,..."
Remplacez les valeurs suivantes :
- REPOSITORY par le nom du dépôt. Si vous avez configuré un dépôt par défaut, vous pouvez ignorer cette option et utiliser le dépôt par défaut.
- PROJECT-ID par l'ID du projet Google Cloud. Si cette option est ignorée, le projet en cours ou par défaut est utilisé.
- LOCATION par l'emplacement régional ou multirégional. Utilisez cette option pour afficher les dépôts dans un emplacement spécifique. Si vous avez configuré un emplacement par défaut, vous pouvez omettre cette option pour utiliser la valeur par défaut.
- DESCRIPTION par une description du dépôt.
USERNAME
par le nom d'utilisateur de votre dépôt en amont.SECRET_ID
par le nom de votre secret ;SECRET_VERSION
par la version du secret que vous souhaitez utiliser.- TAG-SETTING indique comment les balises sont associées aux versions des images.
--no-immutable-tags
: la version de l'image vers laquelle renvoie le tag peut être modifiée. Supprimer des images, supprimer des tags et modifier la version d'une image vers laquelle renvoie un tag sont autorisés.--immutable-tags
: dans le dépôt, un tag pointe toujours vers la même version d'une image. Les actions suivantes ne sont pas autorisées :- Supprimer une image taguée
- Supprimez un tag associé à une image.
- Transférez une image avec un tag qui est déjà utilisé par une autre version de l'image dans le dépôt.
KEY=VALUE,...
par une liste d'étiquettes séparées par des virgules spécifiées sous forme de paires clé/valeur. Exemple :team=team-1,product=example_product,stage=development
. Pour en savoir plus sur l'utilisation des étiquettes, consultez la section Ajouter des étiquettes aux dépôts.