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 d'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 la balise latest par défaut.

    Pour en savoir plus sur les tags d'image, les condensés d'images et les tags immuables, consultez Versions des images de conteneur :

  • Étiquettes de dépôt.

Rôles requis

Pour obtenir les autorisations nécessaires pour mettre à jour les paramètres du dépôt, demandez à votre administrateur de vous accorder le 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 mettre à jour les paramètres à l'aide de la console Google Cloud ou de la 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, puis 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 le 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 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 mettre à 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 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é des tags d'image, exécutez l'une des commandes suivantes:

Pour définir des tags d'image comme immuables:

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

Pour définir les 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 avec le régional ou multirégional position. Utilisez cette option pour afficher les dépôts dans un emplacement spécifique. Si vous configuré un emplacement par défaut, vous pouvez omettre cet indicateur 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. d'images.
  • --no-immutable-tags: la version d'image vers laquelle pointe le tag peut le changement. Supprimer des images, des tags et modifier la version de vers une image vers laquelle pointe un tag.
  • --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 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,... avec une liste de des étiquettes séparées par une virgule spécifiées en tant que 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.