Mettre à jour les paramètres du dépôt

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

  1. Ouvrez la page Dépôts de la console Google Cloud.

    Ouvrir la page "Dépôts"

  2. Dans la liste des dépôts, sélectionnez le dépôt et cliquez sur Modifier le dépôt.

  3. 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.
  4. 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.