Configura le VM per installare i pacchetti Debian

Questa pagina descrive la configurazione delle VM per installare pacchetti Debian da un repository Apt di Artifact Registry.

Prima di iniziare

Prepara una VM per accedere a un repository Apt

Configura una VM per accedere a un repository Apt standard

Configura una VM per accedere a un repository Apt:

1. Genera il comando di configurazione della VM eseguendo il comando gcloud beta artifacts print-settings apt:

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

   Sostituisci quanto segue:

   • LOCATION è la posizione regionale o multiregionale del repository.
   • REPOSITORY è il nome del repository Artifact Registry.

   L'output è simile al seguente:

   # 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. Configura Apt in modo che recuperi i pacchetti dal repository utilizzando il comando echo dall'output del comando print-settings.

   Ad esempio, per installare pacchetti dal repository pubblico my-repo nel progetto my-project e nella località us-west1, utilizza il seguente comando:

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

3. Aggiorna le origini del repository con il seguente comando:

   sudo apt update
   

Ora Apt può connettersi al repository.

Se crei repository Apt aggiuntivi, puoi aggiungerli al file artifact-registry.list e poi eseguire di nuovo sudo apt update per aggiornare le origini dei repository.

Configurare una VM per accedere a un repository Apt remoto

Per configurare una VM in modo che utilizzi solo un repository Apt remoto anziché un repository Apt upstream standard, sostituisci il repository standard con il repository remoto nel file /etc/apt/sources.list della VM.

1. Concedi le autorizzazioni di scrittura Artifact Registry a livello di progetto al account di servizio Compute Engine predefinito:

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

2. Vai alla pagina Istanze VM.

3. Nella riga della tua VM, fai clic su SSH.

   Si apre una nuova finestra con una sessione del terminale sulla VM.

4. Apri il file /etc/apt/sources.list della VM e individua il repository standard che vuoi sostituire con il nuovo repository remoto.

5. Elimina la riga del repository standard e sostituiscila con la seguente:

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

   Sostituisci quanto segue:

   • LOCATION con la posizione regionale o multiregionale del repository remoto.
   • PROJECT_ID con l'ID progetto della VM.
   • REMOTE_REPOSITORY_NAME con il nome che hai dato al repository remoto.
   • UPSTREAM_REPOSITORY_NAME con il nome del repository upstream per il tuo remote.
   • COMPONENTS con un elenco separato da spazi vuoti di nomi dei componenti.

   Ad esempio, la seguente configurazione della VM per recuperare i pacchetti dal repository my-repo nel progetto my-project nella posizione us-east1 utilizzando buster come repository upstream per i componenti main, contrib e non-free.

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

6. Aggiorna le origini del repository con il seguente comando:

   sudo apt update
   

   Ora Apt può connettersi al repository.

Utilizzare un repository Apt remoto come backup

Se vuoi mantenere l'upstream standard come prima opzione e aggiungere il repository remoto come opzione di riserva, puoi mantenere l'upstream standard nel file sources.list e aggiungere il repository remoto alla fine del file sources.list o creare un nuovo elenco nella cartella sources.list.d.

Per creare un nuovo file artifact-registry.list nella cartella sources.list.d, esegui questo comando:

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

Sostituisci quanto segue:

• LOCATION è la posizione regionale o multiregionale del repository.
• PROJECT_ID con l'ID progetto della VM.
• REMOTE_REPOSITORY_NAME con il nome che hai dato al repository remoto.
• UPSTREAM_REPOSITORY_NAME con il nome del repository upstream per il tuo repository remoto.
• COMPONENTS con un elenco separato da spazi di nomi dei componenti.

Se crei repository Apt aggiuntivi, puoi aggiungerli al file artifact-registry.list o sources.list e poi eseguire di nuovo sudo apt update per aggiornare le origini dei repository.

Configurare l'accesso HTTP a un repository Apt

Se utilizzi strumenti client meno recenti che non supportano la crittografia SSL, puoi configurare l'accesso pubblico al repository Apt e accedervi tramite HTTP. Le richieste inviate a repository leggibili pubblicamente tramite HTTP verranno rifiutate se viene presentato un token di autenticazione con la richiesta.

1. Configura l'accesso pubblico al repository.

2. Per configurare Apt in modo che recuperi i pacchetti dal repository utilizzando HTTP, esegui il seguente comando:

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

   Sostituisci quanto segue:

   • LOCATION è la posizione regionale o multiregionale del repository.
   • PROJECT_ID è l'ID progetto del repository.
   • REPOSITORY è il nome del repository.

   Ad esempio, per installare pacchetti dal repository pubblico my-repo nel progetto my-project e nella località us-west1 utilizzando HTTP, utilizza il seguente comando:

   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. Aggiorna le origini del repository con il seguente comando:

   sudo apt update
   

Ora Apt può connettersi al repository.

Se crei repository Apt aggiuntivi, puoi aggiungerli al file artifact-registry.list e poi eseguire di nuovo sudo apt update per aggiornare le origini dei repository.

Passaggi successivi

• Scopri di più sulla gestione dei pacchetti Debian