Cette page décrit l'ajout, l'affichage et la suppression de packages RPM dans Yum des dépôts. Les dépôts Artifact Registry Yum sont compatibles avec Yum et DNF.
Avant de commencer
- Si le dépôt Yum cible n'existe pas, Créer un dépôt
- Configurez des VM pour accéder au dépôt.
- (Facultatif) Configurez des valeurs par défaut pour les commandes gcloud.
- Assurez-vous que les noms de vos packages dans les métadonnées respectent les Consignes de dénomination des packages Fedora et Consignes de gestion des versions des packages Fedora.
Ajouter des packages
Modes de dépôt : standard
Vous devez disposer des autorisations en lecture et en écriture pour le dépôt afin d'ajouter des paquets.
Vous pouvez importer un package dans un dépôt à l'aide de la Google Cloud CLI ou importer un package stocké dans Cloud Storage. Si vous créez des packages à l'aide de Cloud Build, la compilation peut stocker les packages dans Cloud Storage pour vous à importer.
Les opérations d'importation très longues peuvent dépasser la période d'expiration de que gcloud CLI utilise pour appeler l'API. Si vous avez un un grand nombre de packages à ajouter, envisagez de les ajouter en plus petits lots afin que chaque opération d'importation ou d'importation peut s'effectuer en moins de temps. Pour en savoir plus, consultez la documentation Résoudre les problèmes liés aux paquets d'OS.
Importation directe
Utilisez les
Commande gcloud artifacts yum upload
pour importer un package dans un dépôt Yum:
gcloud artifacts yum upload REPOSITORY \
--location=LOCATION \
--source=PACKAGES
Remplacez les valeurs suivantes :
- REPOSITORY est le nom du dépôt Artifact Registry.
- LOCATION est l'emplacement régional ou multirégional du dépôt.
- PACKAGES est le chemin d'accès au package.
Par exemple, pour importer le package my-package.rpm
dans le dépôt Yum my-repo
à l'emplacement us-central1
, exécutez la commande suivante :
gcloud artifacts yum upload my-repo \ --location=us-central1 \ --source=my-package.rpm
Cloud Storage
Importez les packages dans Cloud Storage de l'une des manières suivantes :
- Importez des packages directement dans un Bucket Cloud Storage
- Créer des packages avec Cloud Build et les stocker dans un bucket
Exécutez la commande suivante :
gcloud artifacts yum import REPOSITORY \ --location=LOCATION \ --gcs-source=PACKAGES
Remplacez les valeurs suivantes :
- REPOSITORY est le nom du dépôt Artifact Registry.
- LOCATION est l'emplacement régional ou multirégional du un dépôt de clés.
- PACKAGES est une liste de packages dans Cloud Storage, séparés par des virgules. Pour télécharger tous les packages à partir d'un répertoire, utilisez un
caractère générique de répertoire (
*
) ou utiliser un caractère générique de répertoire récursif (**) pour importer tous les packages dans tous les sous-répertoires ;
Par exemple, pour importer le package
package.rpm
et tous les packages de le répertoiredirectory
du bucketmy-bucket
vers le fichier Yummy-repo
à l'emplacementus-central1
, exécutez la commande suivante:gcloud artifacts yum import my-repo \ --location=us-central1 \ --gcs-source=gs://my-bucket/path/to/package.rpm,gs://my-bucket/directory*
Une fois l'opération d'importation ou d'importation terminée, vous pouvez utiliser la méthode la console Google Cloud ou gcloud CLI pour afficher les packages dans et confirmer qu'ils ont bien été importés.
Si vous avez un grand dépôt avec beaucoup de packages, plusieurs minutes pour régénérer l'index des packages afin que les nouveaux packages soient visibles par le client Yum.
Afficher les packages
Modes de dépôt : standard, distant (bêta)
Pour afficher les packages, vous devez disposer des autorisations du rôle Lecteur d'Artifact Registry. Artifact Registry ne liste pas les fichiers dans les packages.
Pour afficher les packages et les versions de package à l'aide de la console Google Cloud ou de gcloud
:
Console
Ouvrez la page Dépôts de la console Google Cloud.
Dans la liste des dépôts, cliquez sur le dépôt approprié.
La page Packages répertorie les packages du dépôt.
Cliquez sur un package pour afficher ses versions.
gcloud
Pour répertorier les packages d'un dépôt, exécutez la commande suivante :
gcloud artifacts packages list [--repository=REPOSITORY] [--location=LOCATION]
Où
- REPOSITORY est le nom du dépôt. Si vous avez configuré un dépôt par défaut, vous pouvez omettre cette option pour utiliser la valeur par défaut.
- LOCATION a le statut régional ou multirégional position. Utilisez cette option pour afficher les dépôts dans un emplacement spécifique. Si vous avez configuré un emplacement par défaut, vous pouvez omettre cette option pour utiliser la valeur par défaut.
Pour afficher les versions d'un package, exécutez la commande suivante :
gcloud artifacts versions list --package=PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION]
Où :
- PACKAGE est l'ID du package ou de l'identifiant complet. pour le package.
- REPOSITORY est le nom du dépôt. Si vous avez configuré un dépôt par défaut, vous pouvez omettre cet indicateur pour utiliser le dépôt par défaut.
- LOCATION a le statut 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 default, vous pouvez omettre cette option pour utiliser par défaut.
Installer des packages
Modes de dépôt:standard, distant (preview)
Avant d'installer des paquets, vérifiez que vous avez correctement configuré le gestionnaire de paquets et le dépôt.
Pour installer des packages :
Installez le package en spécifiant le nom du dépôt configuré dans Yum.
sudo yum --enablerepo=REPOSITORY install PACKAGE
Remplacez les valeurs suivantes :
- PACKAGE est le nom du package.
- REPOSITORY est le nom du dépôt configuré dans
le fichier
.repo
.
Par exemple, pour installer le package my-package
à partir du dépôt
my-repo
, exécutez la commande suivante:
sudo yum --enablerepo=my-repo install my-package
Supprimer des packages
Modes de dépôt : standard
Avant de supprimer un package ou une version de package, vérifiez que vous avez communiqué ou résolu toute dépendance importante associée.
Pour supprimer un package, procédez comme suit :
Console
Ouvrez la page Dépôts de la console Google Cloud.
Dans la liste des dépôts, cliquez sur le dépôt approprié.
La page Packages répertorie les packages du dépôt.
Sélectionnez le package que vous souhaitez supprimer.
Cliquez sur SUPPRIMER.
Dans la boîte de dialogue de confirmation, cliquez sur SUPPRIMER.
gcloud
Exécutez la commande suivante :
gcloud artifacts packages delete PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION] [--async]
Où
- PACKAGE est le nom du package dans le dépôt.
- REPOSITORY est le nom du dépôt. Si vous avez configuré un dépôt par défaut, vous pouvez omettre cet indicateur pour utiliser le dépôt par défaut.
- LOCATION a le statut 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 default, vous pouvez omettre cette option pour utiliser par défaut.
--async
renvoie immédiatement une réponse, sans attendre la fin de l'opération en cours.
Pour supprimer des versions d'un package, procédez comme suit :
Console
Ouvrez la page Dépôts de la console Google Cloud.
Dans la liste des dépôts, cliquez sur le dépôt approprié.
La page Packages répertorie les packages du dépôt.
Cliquez sur un package pour afficher ses versions.
Sélectionnez les versions que vous souhaitez supprimer.
Cliquez sur SUPPRIMER.
Dans la boîte de dialogue de confirmation, cliquez sur SUPPRIMER.
gcloud
Exécutez la commande suivante :
gcloud artifacts versions delete VERSION \
--package=PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION] \
[--async]
Où
- PACKAGE est le nom du package dans le dépôt.
- REPOSITORY est le nom du dépôt. Si vous avez configuré un dépôt par défaut, vous pouvez omettre cet indicateur pour utiliser le dépôt par défaut.
- LOCATION a le statut régional ou multirégional position. Utilisez cette option pour afficher les dépôts dans un emplacement spécifique. Si vous avez configuré un emplacement par défaut, vous pouvez omettre cette option pour utiliser la valeur par défaut.
--async
renvoie immédiatement une réponse, sans attendre la fin de l'opération en cours.
Pour les dépôts volumineux, la génération à nouveau du package Yum peut prendre quelques minutes pour refléter les suppressions.
Étape suivante
- En savoir plus sur la gestion des paquets Debian
- Télécharger des fichiers individuels dans un package