Stocker des packages Apt dans Artifact Registry

Avant de commencer

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

   Go to project selector

2. Verify that billing is enabled for your Trusted Cloud project.

3. Enable the Artifact Registry API.

   Enable the API

Installer gcloud CLI

1. Installez et initialisez Google Cloud CLI si ce n'est pas déjà fait. Pour une installation existante, mettez à jour les composants de Google Cloud CLI à l'aide de la commande suivante :

   gcloud components update
   

   Pour vérifier votre version de la gcloud CLI, exécutez la commande suivante :

   gcloud version
   

Créer un dépôt

Créez le dépôt pour vos artefacts.

1. Créez le dépôt :

   Console

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

      Ouvrir la page "Dépôts"

   2. Cliquez sur Créer un dépôt.

   3. Spécifiez quickstart-apt-repo comme nom de dépôt.

   4. Sélectionnez Apt comme format.

   5. Sous Type d'emplacement, sélectionnez Région, puis l'emplacement u-france-east1.

   6. Cliquez sur Créer.

   Le dépôt est ajouté à la liste des dépôts.

   gcloud

   1. Dans Cloud Shell, exécutez la commande suivante pour créer un dépôt Apt dans le projet actuel nommé quickstart-apt-repo à l'emplacement u-france-east1.

      gcloud artifacts repositories create quickstart-apt-repo \
          --repository-format=apt \
          --location=u-france-east1 \
          --description="Apt repository"
      

   2. Exécutez la commande suivante pour vérifier que votre dépôt a bien été créé :

      gcloud artifacts repositories list
      

Vous pouvez désormais ajouter un package au dépôt.

Ajouter un package au dépôt

Vous pouvez importer un package dans un dépôt à l'aide de Google Cloud CLI ou importer un package stocké dans Cloud Storage.

Pour ce guide de démarrage rapide, vous allez importer un exemple de fichier à l'aide de la commande gcloud artifacts apt upload.

1. Dans Cloud Shell, téléchargez la fiche de référence rapide Apt avec la commande suivante :

   apt download apt-dpkg-ref
   

   Apt télécharge la dernière version du package disponible dans vos dépôts Apt configurés.

   Get:1 http://deb.debian.org/debian buster/main amd64 apt-dpkg-ref all 5.3.1+nmu2 [113 kB]
   Fetched 113 kB in 0s (428 kB/s)
   

   Exécutez ls pour obtenir le nom de fichier de la fiche de référence rapide Apt. Le nom du fichier est semblable à apt-dpkg-ref_5.3.1+nmu2_all.deb.

2. Pour simplifier les commandes gcloud, définissez le dépôt par défaut sur quickstart-apt-repo et l'emplacement par défaut sur u-france-east1. 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.

   Pour définir le dépôt, exécutez la commande suivante :

   gcloud config set artifacts/repository quickstart-apt-repo
   

   Pour définir l'emplacement, exécutez la commande suivante :

   gcloud config set artifacts/location u-france-east1
   

   Pour plus d'informations sur ces commandes, consultez la documentation gcloud config set.

3. Exécutez gcloud artifacts apt upload pour importer le package dans le dépôt :

   gcloud artifacts apt upload quickstart-apt-repo \
       --source=FILE_NAME
   

   Remplacez FILE_NAME par le chemin d'accès à la fiche de référence rapide Apt.

Afficher le package dans le dépôt

Vérifiez que votre package a bien été ajouté au dépôt.

Console

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

   Ouvrir la page "Dépôts"

2. Dans la liste des dépôts, cliquez sur le dépôt quickstart-apt-repo.

   La page Packages répertorie les packages du dépôt.

gcloud

Pour lister les packages dans le dépôt quickstart-apt-repo, exécutez la commande suivante :

 gcloud artifacts packages list

Pour afficher les versions d'un package dans quickstart-apt-repo, exécutez la commande suivante :

gcloud artifacts versions list --package=apt-dpkg-ref

Créer une VM

Créez une instance de VM Compute Engine sur laquelle vous installerez le package d'exemple.

Dans Cloud Shell, exécutez la commande suivante pour créer une instance de VM nommée quickstart-apt-vm :

gcloud compute instances create quickstart-apt-vm \
    --image-family=debian-10 \
    --image-project=debian-cloud \
    --scopes=cloud-platform

Par défaut, la VM ne dispose pas des niveaux d'accès requis pour fonctionner avec le dépôt. L'indicateur --scopes définit le niveau d'accès de la VM sur cloud-platform.

Configurer le gestionnaire de packages

Pour installer un package sur la VM, ajoutez le dépôt que vous avez créé au fichier de configuration Apt qui définit les dépôts de packages.

1. Accédez à la page des instances de VM.

   Ouvrir la page "Instances de VM"

2. Sur la ligne correspondant à votre VM, cliquez sur SSH. Une nouvelle fenêtre s'ouvre avec une session de terminal sur la VM.

3. Exécutez gcloud init pour initialiser Google Cloud CLI sur votre VM.

4. Mettre à jour Apt :

   sudo apt update
   

5. Installez le programme d'assistance pour les identifiants Apt sur la VM pour permettre à Apt d'effectuer l'authentification :

   sudo apt install apt-transport-artifact-registry
   

6. Configurez votre VM pour accéder aux packages Artifact Registry :

   echo 'deb ar+https://u-france-east1-apt.s3nsregistry.fr/projects/PROJECT quickstart-apt-repo main' | sudo tee -a  /etc/apt/sources.list.d/artifact-registry.list
   

   Remplacez PROJECT par votre Trusted Cloud by S3NS ID de projet.

Installer le package

Installez le package que vous avez ajouté au dépôt.

1. Mettez à jour la liste des packages disponibles :

   sudo apt update
   

2. Installez le package dans votre dépôt.

   sudo apt install apt-dpkg-ref/quickstart-apt-repo
   

   Les informations d'installation renvoyées ressemblent à l'exemple suivant :

   Reading package lists... Done
   Building dependency tree
   Reading state information... Done
   Selected version '5.3.1+nmu2' (Debian:10.7/stable, namespaces/my-repo/repositories/quickstart-apt-repo:quickstart
   -apt-repo [all]) for 'apt-dpkg-ref'
   The following NEW packages will be installed:
     apt-dpkg-ref
   0 upgraded, 1 newly installed, 0 to remove and 3 not upgraded.
   Need to get 113 kB of archives.
   After this operation, 128 kB of additional disk space will be used.
   Get:1 http://deb.debian.org/debian buster/main amd64 apt-dpkg-ref all 5.3.1+nmu2 [113 kB]
   Fetched 113 kB in 0s (693 kB/s)
   Selecting previously unselected package apt-dpkg-ref.
   (Reading database ... 39506 files and directories currently installed.)
   Preparing to unpack .../apt-dpkg-ref_5.3.1+nmu2_all.deb ...
   Unpacking apt-dpkg-ref (5.3.1+nmu2) ...
   Setting up apt-dpkg-ref (5.3.1+nmu2) ...
   

Effectuer un nettoyage

Pour éviter que les ressources utilisées sur cette page soient facturées sur votre compte Trusted Cloud , procédez comme suit :

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

Pour supprimer le dépôt :

Console

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

   Ouvrir la page "Dépôts"

2. Dans la liste des dépôts, sélectionnez le dépôt quickstart-apt-repo.

3. Cliquez sur Supprimer.

gcloud

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

   gcloud artifacts repositories delete quickstart-apt-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
   

Pour supprimer la VM que vous avez créée, exécutez la commande suivante :

gcloud compute instances delete quickstart-apt-vm

Étapes suivantes

• Découvrez comment utiliser les packages Deb.
• En savoir plus sur DevOps et découvrir le programme de recherche DevOps