Stocker d'autres formats dans Artifact Registry

Stocker d'autres formats dans Artifact Registry

Découvrez comment configurer un dépôt au format générique Artifact Registry et importer un fichier YAML.

Avant de commencer

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Lancer Cloud Shell

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

Dans ce guide de démarrage rapide, vous allez utiliser Cloud Shell pour exécuter des commandes gcloud.

Créer un dépôt générique

1. Pour créer un dépôt de format générique nommé quickstart-generic-repo à l'emplacement us-central1 avec la description Generic repository, exécutez la commande suivante :

   gcloud artifacts repositories create quickstart-generic-repo \
       --repository-format=generic \
       --location=us-central1 \
       --description="Generic repository"
   

2. Pour vérifier que votre dépôt a bien été créé, exécutez la commande suivante :

   gcloud artifacts repositories list
   

3. Pour simplifier les commandes gcloud, exécutez les commandes suivantes pour définir le dépôt par défaut sur quickstart-generic-repo et l'emplacement par défaut sur us-central1.

   1. Pour définir le dépôt par défaut sur quickstart-generic-repo, exécutez la commande suivante :

      gcloud config set artifacts/repository quickstart-generic-repo
      

   2. Pour définir l'emplacement par défaut sur us-central1, exécutez la commande suivante :

      gcloud config set artifacts/location us-central1
      

   Une fois les valeurs définies, vous n'avez pas besoin de les spécifier dans les commandes gcloud nécessitant un dépôt ou un emplacement.

Importer un artefact dans le dépôt

1. Dans votre répertoire d'accueil, créez un fichier à importer dans votre dépôt :

   echo "hello world" > hello.yaml
   

2. Pour importer le fichier en tant qu'artefact dans le dépôt, exécutez la commande suivante :

   gcloud artifacts generic upload \
       --source=hello.yaml \
       --package=my-package \
       --version=1.0.0
   

   Où :

   • hello.yaml est le chemin d'accès du fichier à importer.
   • my-package est le package à importer.
   • 1.0.0 correspond à la version de l'artefact. Vous ne pouvez pas écraser une version existante dans le dépôt.

Afficher les artefacts dans le dépôt

Pour vérifier que votre artefact a été ajouté au dépôt, vous pouvez lister tous les artefacts en exécutant la commande suivante :

gcloud artifacts files list

La réponse inclut les détails du fichier au format PACKAGE:VERSION:FILE_NAME.

Dans l'exemple suivant, hello.yaml correspond à FILE_NAME :

FILE: my-package:1.0.0:hello.yaml
CREATE_TIME: 2023-03-09T20:55:07
UPDATE_TIME: 2023-03-09T20:55:07
SIZE (MB): 0.000
OWNER: projects/my-project/locations/us-central1/repositories/quickstart-generic-repo/packages/my-package/versions/1.0.0

Télécharger un artefact générique

Pour télécharger un artefact générique depuis votre dépôt, exécutez la commande suivante :

gcloud artifacts generic download \
    --name=hello.yaml \
    --package=my-package \
    --version=1.0.0 \
    --destination=DESTINATION

Où :

• hello.yaml est le nom du fichier à télécharger.
• my-package est le package à télécharger.
• 1.0.0 correspond à la version de l'artefact.

Remplacez DESTINATION par le répertoire de votre système de fichiers local dans lequel vous souhaitez enregistrer le téléchargement. Le dossier de destination doit déjà exister, sinon la commande échouera.

Effectuer un nettoyage

Pour éviter que les ressources utilisées lors de ce tutoriel soient facturées sur votre compte Google Cloud , supprimez le projet contenant les ressources, ou conservez le projet et supprimez le dépôt.

Supprimer le projet

Attention : La suppression d'un projet a les effets suivants :

• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour les tâches décrites dans ce document et que vous le supprimez, vous supprimerez également tout autre travail effectué dans le projet.
• Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID de projet, telle qu'une URL appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.

Si vous envisagez d'explorer plusieurs architectures, tutoriels et guides de démarrage rapide, réutiliser des projets peut vous aider à ne pas dépasser les limites de quotas des projets.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Supprimer le dépôt

Avant de supprimer un dépôt, assurez-vous que tous les packages que vous souhaitez conserver sont disponibles dans un autre emplacement.

1. Pour supprimer le dépôt quickstart-generic-repo, exécutez la commande suivante :

   gcloud artifacts repositories delete quickstart-generic-repo
   

2. Si vous souhaitez supprimer le dépôt par défaut et les paramètres d'emplacement que vous avez définis pour la configuration gcloud active, exécutez les commandes suivantes :

   gcloud config unset artifacts/repository
   gcloud config unset artifacts/location
   

Étapes suivantes

• En savoir plus sur les artefacts génériques