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

  1. Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.

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

    Go to project selector

  3. Vérifiez que la facturation est activée pour votre projet Google Cloud.

  4. Activez l'API Artifact Registry

    Activer l'API

    5.

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

    Go to project selector

  6. Vérifiez que la facturation est activée pour votre projet Google Cloud.

  7. Activez l'API Artifact Registry

    Activer l'API

    8.

Lancer Cloud Shell

Dans la console Google Cloud, activez Cloud Shell.

Activer Cloud Shell

En bas de la fenêtre de la console Google Cloud, une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement shell dans lequel Google Cloud CLI est déjà installé, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.

Dans ce guide de démarrage rapide, vous allez exécuter des commandes gcloud à l'aide de Cloud Shell.

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 afin de 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 qui nécessitent 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 est la version de l'artefact. Vous ne pouvez pas écraser une version existante du dépôt.

Afficher les artefacts du dépôt

Pour vérifier que votre artefact a été ajouté au dépôt, vous pouvez répertorier 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 à partir de 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 est 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, sans quoi la commande échouera.

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans 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

    Supprimez un projet Google Cloud :

    gcloud projects delete PROJECT_ID

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