Guide de démarrage rapide pour RPM

Ce guide de démarrage rapide vous explique comment configurer un dépôt Yum Artifact Registry, ajouter un package RPM au dépôt et installer le package. Pour apprendre à configurer des dépôts Yum utilisant DNF, consultez la section Configurer des VM pour installer des packages RPM.

Vous effectuerez les étapes de ce guide de démarrage rapide à l'aide de Cloud Shell ou d'une interface système locale qui s'exécute sur un système d'exploitation CentOS 7.

Pour en savoir plus sur la gestion des packages RPM, consultez la page Utiliser des packages RPM.

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. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  3. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

  4. Activez l'API Artifact Registry.

    Activer l'API

  5. Installez et initialisez le SDK Cloud.
  6. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  7. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

  8. Activez l'API Artifact Registry.

    Activer l'API

  9. Installez et initialisez le SDK Cloud.
  10. Créez une VM dans laquelle vous allez installer l'exemple de package. Exécutez la commande suivante en remplaçant VM_NAME par le nom de la VM.
      gcloud compute instances create VM_NAME \
          --image-family=centos-7 \
          --image-project=centos-cloud \
          --scopes=cloud-platform
  11. Accordez des autorisations d'accès au dépôt au compte de service de votre VM.

Créer un dépôt

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

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

    Console

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

      Ouvrir la page "Dépôts"

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

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

    4. Sélectionnez le format Yum.

    5. Sous Type d'emplacement, sélectionnez Région, puis l'emplacement us-central1.

    6. Cliquez sur Create (Créer).

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

    gcloud

    1. Exécutez la commande suivante pour créer un dépôt Yum dans le projet actuel nommé quickstart-yum-repo à l'emplacement us-central1.

      gcloud artifacts repositories create quickstart-yum-repo \
          --repository-format=yum \
          --location=us-central1 \
          --description="Yum repository"
      
    2. Exécutez la commande suivante pour vérifier que votre dépôt a bien été créé :

      gcloud artifacts repositories list
      
    3. Pour simplifier les commandes gcloud, définissez le dépôt par défaut sur quickstart-yum-repo et l'emplacement par défaut sur 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.

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

      gcloud config set artifacts/repository quickstart-yum-repo
      

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

      gcloud config set artifacts/location us-central1
      

      Pour plus d'informations sur ces commandes, reportez-vous à la documentation gcloud config set.

Configurer le gestionnaire de packages

Pour installer un package sur une VM, ajoutez le dépôt que vous avez créé dans le fichier Yum 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 contenant votre VM, cliquez sur SSH. Une nouvelle fenêtre s'ouvre avec une session de terminal sur la VM.

  3. Mettez à jour Yum:

    sudo yum makecache
    
  4. Installez l'assistant d'identification Yum sur la VM pour permettre à Yum d'effectuer l'authentification à l'aide de la commande suivante:

    sudo yum install yum-plugin-artifact-registry
    
  5. Configurez votre VM pour accéder aux packages Artifact Registry à l'aide de la commande suivante:

    sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOF
    [yum-quickstart]
    name=My Repository
    baseurl=https://us-central1-yum.pkg.dev/projects/PROJECT/quickstart-yum-repo
    enabled=1
    repo_gpgcheck=0
    gpgcheck=0
    EOF
    

    Remplacez PROJECT par l'ID de votre projet Google Cloud.

Ajouter un package au dépôt

Vous pouvez importer un package dans un dépôt à l'aide de l'outil de ligne de commande gcloud ou importer un package stocké dans Cloud Storage. Si vous compilez des packages à l'aide de Cloud Build, la compilation peut les stocker dans Cloud Storage pour les importer.

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

  1. Téléchargez l'éditeur de texte nano avec la commande suivante:

    sudo yum install --downloaddir=. --downloadonly nano
    

    Yum télécharge la dernière version du package disponible à partir de vos dépôts CentOS configurés.

    Loaded plugins: fastestmirror
    Loading mirror speeds from cached hostfile
     * base: mirror.dal.nexril.net
     * epel: ord.mirror.rackspace.com
     * extras: centos.mirror.lstn.net
     * updates: ftpmirror.your.org
    Resolving Dependencies
    --> Running transaction check
    ---> Package nano.x86_64 0:2.3.1-10.el7 will be installed
    --> Finished Dependency Resolution
    
    Dependencies Resolved
    
    ================================================================================
     Package        Arch             Version                   Repository      Size
    ================================================================================
    Installing:
     nano           x86_64           2.3.1-10.el7              base           440 k
    
    Transaction Summary
    ================================================================================
    Install  1 Package
    
    Total download size: 440 k
    Installed size: 1.6 M
    Background downloading packages, then exiting:
    nano-2.3.1-10.el7.x86_64.rpm                               | 440 kB   00:00
    exiting because "Download Only" specified
    

    Exécutez ls pour obtenir le nom du fichier de package. Le nom du fichier est semblable à nano-2.3.1-10.el7.x86_64.rpm.

  2. Exécutez la commande gcloud beta artifacts yum upload pour importer le package dans le dépôt:

    gcloud beta artifacts yum upload quickstart-yum-repo \
        --location=us-central1 \
        --source=FILE_NAME
    

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

Afficher le package dans le dépôt

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

Console

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

    Ouvrir la page "Dépôts"

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

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

gcloud

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

 gcloud artifacts packages list --repository=quickstart-yum-repo

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

gcloud artifacts versions list --package=nano

Installer le package

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

  1. Mettez à jour la liste des packages disponibles:

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

    sudo yum --enablerepo=yum-quickstart install nano
    

    Saisissez y lorsque vous y êtes invité.

    Les informations d'installation renvoyées se présentent comme suit:

    Loaded plugins: fastestmirror
    Loading mirror speeds from cached hostfile
     * base: mirrors.cmich.edu
     * epel: ord.mirror.rackspace.com
     * extras: mirror.team-cymru.com
     * updates: mirror.us-midwest-1.nexcess.net
    quickstart-yum-repo                                      | 1.3 kB     00:00
    Resolving Dependencies
    --> Running transaction check
    ---> Package nano.x86_64 0:2.3.1-10.el7 will be installed
    --> Finished Dependency Resolution
    
    Dependencies Resolved
    
    ================================================================================
     Package        Arch             Version                   Repository      Size
    ================================================================================
    Installing:
     nano           x86_64           2.3.1-10.el7              base           440 k
    
    Transaction Summary
    ================================================================================
    Install  1 Package
    
    Total size: 440 k
    Installed size: 1.6 M
    Is this ok [y/d/N]: y
    Downloading packages:
    Running transaction check
    Running transaction test
    Transaction test succeeded
    Running transaction
      Installing : nano-2.3.1-10.el7.x86_64                                     1/1
      Verifying  : nano-2.3.1-10.el7.x86_64                                     1/1
    
    Installed:
      nano.x86_64 0:2.3.1-10.el7
    
    Complete!
    

Effectuer un nettoyage

Pour éviter que les ressources utilisées sur cette page soient facturées sur votre compte Google Cloud :

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 Cloud Console.

    Ouvrir la page "Dépôts"

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

  3. Cliquez sur Supprimer.

gcloud

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

    gcloud artifacts repositories delete quickstart-yum-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. Remplacez VM_NAME par le nom de la VM.

gcloud compute instances delete VM_NAME

Étape suivante