Modifier les paramètres du dépôt

Vous pouvez modifier les paramètres de dépôt suivants :

  • Description du dépôt.
  • 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 par défaut latest

    Pour en savoir plus sur les tags d'image, les condensés d'image et les tags d'image immuables, consultez la section Versions d'image de conteneur.

  • Libellés de dépôt .

Rôles requis

Pour obtenir les autorisations nécessaires pour modifier les paramètres du dépôt, demandez à votre administrateur de vous accorder le rôle IAM Administrateur Artifact Registry (roles/artifactregistry.admin) sur le Cloud de Confiance projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec 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 Cloud de Confiance console ou de Google Cloud CLI.

Console

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

    Ouvrir la page "Dépôts"

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

  3. Modifiez les paramètres que vous souhaitez modifier :

    • Modifiez la description du dépôt.
    • 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.
      • Supprimer un tag d'une image.
      • Transférer une image avec un tag déjà utilisé par une autre version de l'image dans le dépôt.
      • Ajouter, supprimer ou modifier 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 modifier la mutabilité du tag d'image, exécutez l'une des commandes suivantes :

Pour définir des tags d'image immuables :

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

Pour définir des tags d'image mutables :

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

Pour modifier des libellés, exécutez la commande suivante :

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

Remplacez les valeurs suivantes :

  • REPOSITORY est le nom du dépôt. Si vous avez configuré un dépôt par défaut, vous pouvez omettre cet indicateur pour utiliser le dépôt par défaut.
  • PROJECT-ID est l' Cloud de Confiance by S3NS ID du projet. Si cet indicateur est omis, le projet actuel ou par défaut est utilisé.
  • LOCATION est l'emplacement régional du dépôt. 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 cet indicateur pour utiliser l'emplacement par défaut.
  • DESCRIPTION est une description du dépôt.
  • SECRET_ID est le nom de votre secret.
  • SECRET_VERSION est la version du secret que vous souhaitez utiliser.
  • Les deux indicateurs de paramètre de tag, --no-immutable-tags ou --immutable-tags, indiquent comment les tags sont associés aux versions des images.
    • --no-immutable-tags : la version d'image vers laquelle pointe le tag peut changer. La suppression d'images, la suppression de tags et la modification de la version d'une image vers laquelle pointe un tag sont autorisées.
    • --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.
      • Supprimer un tag d'une image.
      • Transférer une image avec un tag déjà utilisé par une autre version de l'image dans le dépôt.

  • KEY=VALUE... est une liste de libellés séparés par une virgule, spécifiés sous forme de paires clé/valeur. Exemple : team=team-1,product=example_product,stage=development. Pour en savoir plus sur l'utilisation des libellés, consultez la section Ajouter des libellés à des dépôts.