Configurer des VM pour installer des paquets Debian

Cette page explique comment configurer des VM pour installer des packages Debian à partir d'un dépôt Apt Artifact Registry.

Avant de commencer

Préparer une VM pour accéder à un dépôt Apt

Configurer une VM pour accéder à un dépôt Apt standard

Configurez une VM pour accéder à un dépôt Apt :

1. Générez la commande de configuration de la VM en exécutant la commande gcloud beta artifacts print-settings apt :

   gcloud beta artifacts print-settings apt \
       --repository=REPOSITORY \
       --location=LOCATION
   

   Remplacez les éléments suivants :

   • LOCATION est l'emplacement régional ou multirégional du dépôt.
   • REPOSITORY est le nom du dépôt Artifact Registry.

   Le résultat ressemble à ce qui suit :

   # To configure your package manager with this repository:
   
   # Update Apt:
   sudo apt update
   
   # Install the Apt credential helper:
   sudo apt install apt-transport-artifact-registry
   
   # Configure your VM to access Artifact Registry packages using the following
   # command:
   
   echo "deb ar+https://LOCATION-apt.pkg.dev/projects/PROJECT REPOSITORY main" | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list
   
   # Update Apt:
   sudo apt update
   

2. Configurez Apt pour qu'il récupère les packages de votre dépôt à l'aide de la commande echo à partir du résultat de la commande print-settings.

   Par exemple, pour installer des packages à partir du dépôt public my-repo dans le projet my-project et à l'emplacement us-west1, utilisez la commande suivante :

   echo 'deb ar+https://us-west1-apt.pkg.dev/projects/my-project my-repo main'
   

3. Mettez à jour les sources de votre dépôt à l'aide de la commande suivante :

   sudo apt update
   

Apt peut désormais se connecter au dépôt.

Si vous créez des dépôts Apt supplémentaires, vous pouvez les ajouter au fichier artifact-registry.list, puis réexécuter sudo apt update pour mettre à jour les sources des dépôts.

Configurer une VM pour accéder à un dépôt Apt distant

Pour configurer une VM afin qu'elle n'utilise qu'un dépôt Apt distant au lieu d'un dépôt Apt en amont standard, remplacez le dépôt standard par votre dépôt distant dans le fichier /etc/apt/sources.list de la VM.

1. Accordez des autorisations d'écriture Artifact Registry à l'échelle du projet au compte de service Compute Engine par défaut :

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:PROJECT_NUMBER-compute@developer.gserviceaccount.com \
      --role=roles/artifactregistry.writer
   

2. Accédez à la page Instances de VM.

3. Sur la ligne correspondant à votre VM, cliquez sur SSH.

   Une nouvelle fenêtre s'ouvre avec une session de terminal sur la VM.

4. Ouvrez le fichier /etc/apt/sources.list de la VM et recherchez le dépôt standard que vous souhaitez remplacer par votre nouveau dépôt distant.

5. Supprimez la ligne du dépôt standard et remplacez-la par ce qui suit :

   deb ar+https://LOCATION-apt.pkg.dev/remote/PROJECT_ID/REMOTE_REPOSITORY_NAME UPSTREAM_REPOSITORY_NAME COMPONENTS
   

   Remplacez les éléments suivants :

   • LOCATION avec l'emplacement régional ou multirégional du dépôt distant.
   • PROJECT_ID par l'ID de projet de la VM.
   • REMOTE_REPOSITORY_NAME par le nom que vous avez donné à votre dépôt distant.
   • UPSTREAM_REPOSITORY_NAME par le nom du dépôt en amont de votre dépôt distant.
   • COMPONENTS par une liste de noms de composants séparés par un espace.

   Par exemple, la configuration suivante permet à la VM d'extraire des packages du dépôt my-repo dans le projet my-project à l'emplacement us-east1 en utilisant buster comme dépôt en amont pour les composants main, contrib et non-free.

   deb ar+https://us-east1-apt.pkg.dev/remote/my-project/my-repo buster main contrib non-free
   

6. Mettez à jour les sources de votre dépôt à l'aide de la commande suivante :

   sudo apt update
   

   Apt peut désormais se connecter au dépôt.

Utiliser un dépôt Apt distant comme sauvegarde

Si vous souhaitez conserver l'upstream standard comme première option et ajouter le dépôt distant comme option de secours, vous pouvez conserver l'upstream standard dans le fichier sources.list, et ajouter le dépôt distant à la fin du fichier sources.list ou créer une liste dans le dossier sources.list.d.

Pour créer un fichier artifact-registry.list dans le dossier sources.list.d, exécutez la commande suivante :

echo 'deb ar+https://LOCATION-apt.pkg.dev/remote/PROJECT_ID/REMOTE_REPOSITORY_NAME UPSTREAM_REPOSITORY_NAME COMPONENTS' | sudo tee -a  /etc/apt/sources.list.d/artifact-registry.list

Remplacez les éléments suivants :

• LOCATION est l'emplacement régional ou multirégional du dépôt.
• PROJECT_ID par l'ID de projet de la VM.
• REMOTE_REPOSITORY_NAME par le nom que vous avez donné à votre dépôt distant.
• UPSTREAM_REPOSITORY_NAME par le nom du dépôt en amont pour votre dépôt distant.
• COMPONENTS par une liste de noms de composants séparés par des espaces.

Si vous créez des dépôts Apt supplémentaires, vous pouvez les ajouter au fichier artifact-registry.list ou sources.list, puis réexécuter sudo apt update pour mettre à jour les sources du dépôt.

Configurer l'accès HTTP à un dépôt Apt

Si vous utilisez d'anciens outils clients qui ne sont pas compatibles avec le chiffrement SSL, vous pouvez configurer un accès public à votre dépôt Apt et y accéder via HTTP. Les requêtes envoyées à des dépôts publics en lecture seule à l'aide du protocole HTTP seront refusées si un jeton d'authentification est présenté avec la requête.

1. Configurez l'accès public au dépôt.

2. Pour configurer Apt afin qu'il récupère les packages de votre dépôt à l'aide de HTTP, exécutez la commande suivante :

    echo 'deb http://LOCATION-apt.pkg.dev/projects/PROJECT_ID \
    REPOSITORY main' | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list
   

   Remplacez les éléments suivants :

   • LOCATION est l'emplacement régional ou multirégional du dépôt.
   • PROJECT_ID est l'ID de projet du dépôt.
   • REPOSITORY est le nom du dépôt.

   Par exemple, pour installer des packages à partir du dépôt public my-repo dans le projet my-project et à l'emplacement us-west1 à l'aide de HTTP, utilisez la commande suivante :

   echo 'deb http://us-west1-apt.pkg.dev/projects/my-project my-repo main' | sudo tee -a /etc/apt/sources.list.d/artifact-registry.list
   

3. Mettez à jour les sources de votre dépôt à l'aide de la commande suivante :

   sudo apt update
   

Apt peut désormais se connecter au dépôt.

Si vous créez des dépôts Apt supplémentaires, vous pouvez les ajouter au fichier artifact-registry.list, puis réexécuter sudo apt update pour mettre à jour les sources des dépôts.

Étapes suivantes

• En savoir plus sur la gestion des packages Debian