Gérer les packages Debian

Cette page décrit l'ajout, l'affichage et la suppression de packages Debian dans Apt. des dépôts.

Avant de commencer

  1. Si le dépôt Apt cible n'existe pas, Créer un dépôt
  2. Configurez les VM pour qu'elles accèdent au dépôt.
  3. (Facultatif) Configurez des valeurs par défaut pour les commandes gcloud.
  4. Assurez-vous que les noms de vos packages dans les métadonnées respectent les normes de dénomination des paquets Debian.

Ajouter des packages

Modes de dépôt:standard

Vous devez disposer des autorisations de lecture et d'écriture pour le pour ajouter des packages.

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 les stocker dans Cloud Storage pour que vous puissiez les 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 devez ajouter un très grand nombre de packages, envisagez de les ajouter par lots plus petits afin que chaque opération d'importation ou d'importation puisse être effectuée plus rapidement. Pour en savoir plus, consultez la documentation sur le dépannage des packages d'OS. des informations.

Importation directe

Utilisez la commande gcloud artifacts apt upload pour importer un paquet dans un dépôt Apt :

gcloud artifacts apt 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.deb dans le dépôt Apt, my-repo à l'emplacement us-central1, exécutez la commande suivante:

gcloud artifacts apt upload my-repo \
    --location=us-central1 \
    --source=my-package.deb

Cloud Storage

  1. 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
  2. Exécutez la commande suivante :

    gcloud artifacts apt 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 dépôt.
    • PACKAGES est une liste de packages séparés par une virgule dans Cloud Storage. Pour importer tous les packages à partir d'un répertoire, utilisez un caractère générique de répertoire (*) ou un caractère générique de répertoire récursif (**) pour importer tous les packages de tous les sous-répertoires.

    Par exemple, pour importer le package package.rpm et tous les packages du répertoire directory du bucket my-bucket vers le dépôt Apt my-repo à l'emplacement us-central1, exécutez la commande suivante :

    gcloud artifacts apt import my-repo \
       --location=us-central1 \
       --gcs-source=gs://my-bucket/path/to/package.deb,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 disposez d'un dépôt volumineux contenant de nombreux paquets, la régénération de l'index des paquets peut prendre plusieurs minutes afin que les nouveaux paquets soient visibles par le client Apt.

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 à l'intérieur des packages.

To view packages and package versions using the Google Cloud console or gcloud:

Console

  1. Open the Repositories page in the Google Cloud console.

    Open the Repositories page

  2. In the repository list, click the appropriate repository.

    The Packages page lists the packages in the repository.

  3. Click a package to view versions of the package.

gcloud

To list packages in a repository, run the following command:

gcloud artifacts packages list [--repository=REPOSITORY] [--location=LOCATION]

Replace the following:

  • REPOSITORY is the name of the repository. If you configured a default repository, you can omit this flag to use the default.
  • LOCATION is the regional or multi-regional location of the repository. If you configured a default location, then you can omit this flag to use the default.

To view versions of a package, run the following command:

gcloud artifacts versions list --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION]

Replace the following:

  • PACKAGE is the ID of the package or fully qualified identifier for the package.
  • REPOSITORY is the name of the repository. If you configured a default repository, then you can omit this flag to use the default.
  • LOCATION is the regional or multi-regional location of the repository. Use this flag to view repositories in a specific location. If you configured a default location, then you can omit this flag to use the default.

Installer des packages

Modes de dépôt : standard, distant (bêta)

Avant d'installer des packages, vérifiez que vous avez configuré le gestionnaire de packages et le dépôt.

Pour installer un package dans le dépôt :

  1. Mettez à jour la liste des packages disponibles :

    sudo apt update
    
  2. Installez le package en spécifiant le nom du dépôt configuré dans Appt.

    sudo apt install PACKAGE/REPOSITORY
    

    Remplacez les valeurs suivantes :

    • PACKAGE est le nom du package.
    • REPOSITORY est le nom du dépôt Artifact Registry. Pour les dépôts distants, utilisez le nom du dépôt en amont standard.

    Par exemple, pour installer le package my-package à partir du dépôt my-repo, exécutez la commande suivante :

    sudo apt install my-package -t my-repo
    

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

  1. Ouvrez la page Dépôts de la console Google Cloud.

    Open the Repositories page

  2. 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.

  3. Sélectionnez le package que vous souhaitez supprimer.

  4. Cliquez sur SUPPRIMER.

  5. 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]

  • 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

  1. Ouvrez la page Dépôts de la console Google Cloud.

    Open the Repositories page

  2. 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.

  3. Cliquez sur un package pour afficher ses versions.

  4. Sélectionnez les versions que vous souhaitez supprimer.

  5. Cliquez sur SUPPRIMER.

  6. 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]

  • 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 régénération de l'index des paquets Apt pour refléter les suppressions peut prendre quelques minutes.

Étape suivante