Archiviare i pacchetti Apt in Artifact Registry

Archiviare i pacchetti Apt in Artifact Registry

Questa guida rapida illustra come configurare un repository Apt Artifact Registry privato, aggiungere un pacchetto Debian al repository e installare il pacchetto su una VM Compute Engine che esegue un sistema operativo basato su Debian.

Per scoprire di più sulla gestione dei pacchetti Debian, consulta Utilizzo dei pacchetti Debian.

Prima di iniziare

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Artifact Registry API.

   Enable the API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Artifact Registry API.

   Enable the API

Avvia Cloud Shell

Cloud Shell è preinstallato con Google Cloud CLI. Gcloud CLI fornisce l'interfaccia a riga di comando principale per Google Cloud.

Avvia Cloud Shell:

1. Vai alla console Google Cloud .

   Console

2. Nella console Google Cloud , fai clic su Attiva Cloud Shell .

Una sessione di Cloud Shell si apre in un frame nella parte inferiore della console. Utilizzerai questa shell per eseguire i comandi gcloud per creare una VM e un repository.

Crea un repository

Crea il repository per i tuoi artefatti.

1. Crea il repository:

   Console

   1. Apri la pagina Repository nella console Google Cloud .

      Apri la pagina Repository

   2. Fai clic su Crea repository.

   3. Specifica quickstart-apt-repo come nome del repository.

   4. Seleziona Apt come formato.

   5. In Tipo di località, seleziona Regione, quindi scegli la localitàus-west1.

   6. Fai clic su Crea.

   Il repository viene aggiunto all'elenco dei repository.

   gcloud

   1. In Cloud Shell, esegui il comando seguente per creare un nuovo repository Apt nel progetto corrente denominato quickstart-apt-repo nella posizione us-west1.

      gcloud artifacts repositories create quickstart-apt-repo \
          --repository-format=apt \
          --location=us-west1 \
          --description="Apt repository"
      

   2. Esegui questo comando per verificare che il repository sia stato creato:

      gcloud artifacts repositories list
      

Ora puoi aggiungere un pacchetto al repository.

Aggiungere un pacchetto al repository

Puoi caricare un pacchetto in un repository utilizzando Google Cloud CLI oppure puoi importarne uno archiviato in Cloud Storage. Se crei pacchetti utilizzando Cloud Build, la compilazione può archiviarli in Cloud Storage per consentirti di importarli.

Per questa guida rapida, carichi un file di esempio utilizzando il comando gcloud artifacts apt upload.

1. In Cloud Shell, scarica il foglio di riferimento rapido di Apt con il comando:

   apt download apt-dpkg-ref
   

   Apt scarica la versione più recente del pacchetto disponibile dai tuoi repository Apt configurati.

   Get:1 http://deb.debian.org/debian buster/main amd64 apt-dpkg-ref all 5.3.1+nmu2 [113 kB]
   Fetched 113 kB in 0s (428 kB/s)
   

   Esegui ls per ottenere il nome del file del foglio di riferimento rapido di Apt. Il nome del file è simile a apt-dpkg-ref_5.3.1+nmu2_all.deb.

2. Per semplificare i comandi gcloud, imposta il repository predefinito su quickstart-apt-repo e la posizione predefinita su us-west1. Una volta impostati i valori, non è necessario specificarli nei comandi gcloud che richiedono un repository o una posizione.

   Per impostare il repository, esegui il comando:

   gcloud config set artifacts/repository quickstart-apt-repo
   

   Per impostare la località, esegui il comando:

   gcloud config set artifacts/location us-west1
   

   Per ulteriori informazioni su questi comandi, consulta la documentazione di gcloud config set.

3. Esegui gcloud artifacts apt upload per caricare il pacchetto nel repository:

   gcloud artifacts apt upload quickstart-apt-repo \
       --source=FILE_NAME
   

   Sostituisci FILE_NAME con il percorso del foglio di riferimento rapido di Apt.

Visualizza il pacchetto nel repository

Verifica che il pacchetto sia stato aggiunto al repository.

Console

1. Apri la pagina Repository nella console Google Cloud .

   Apri la pagina Repository

2. Nell'elenco dei repository, fai clic sul repository quickstart-apt-repo.

   La pagina Pacchetti elenca i pacchetti nel repository.

gcloud

Per elencare i pacchetti nel repository quickstart-apt-repo, esegui il comando:

 gcloud artifacts packages list

Per visualizzare le versioni di un pacchetto in quickstart-apt-repo, esegui il comando:

gcloud artifacts versions list --package=apt-dpkg-ref

Crea una VM

Crea una nuova VM Compute Engine in cui installare il pacchetto di esempio.

In Cloud Shell, esegui il comando seguente per creare un'istanza VM chiamata quickstart-apt-vm:

gcloud compute instances create quickstart-apt-vm \
    --image-family=debian-10 \
    --image-project=debian-cloud \
    --scopes=cloud-platform

Per impostazione predefinita, la VM non dispone degli ambiti di accesso necessari per lavorare con il repository. Il flag --scopes imposta l'ambito di accesso per la VM su cloud-platform.

Configura il gestore dei pacchetti

Per installare un pacchetto sulla VM, aggiungi il repository che hai creato al file di configurazione di Apt che definisce i repository dei pacchetti.

Nota: la VM creata in questa guida introduttiva utilizza un'immagine del sistema operativo Debian creata da Google, preconfigurata con alcune impostazioni per accedere ai repository Artifact Registry. Se vuoi configurare una VM Compute Engine che utilizza un'immagine Ubuntu creata da Google, una VM che utilizza un'immagine del sistema operativo non creata da Google o una VM al di fuori di Google Cloud, sono necessari ulteriori passaggi di configurazione. Per maggiori dettagli, consulta le istruzioni complete per la configurazione della VM.

1. Vai alla pagina delle istanze VM.

   Apri la pagina Istanze VM

2. Nella riga della VM, fai clic su SSH. Si apre una nuova finestra con una sessione del terminale sulla VM.

3. Esegui gcloud init per inizializzare Google Cloud CLI sulla VM.

4. Aggiorna Apt:

   sudo apt update
   

5. Installa lo strumento di assistenza per le credenziali Apt sulla VM per consentire ad Apt di eseguire l'autenticazione:

   sudo apt install apt-transport-artifact-registry
   

6. Configura la VM in modo che acceda ai pacchetti di Artifact Registry:

   echo 'deb ar+https://us-west1-apt.pkg.dev/projects/PROJECT quickstart-apt-repo main' | sudo tee -a  /etc/apt/sources.list.d/artifact-registry.list
   

   Sostituisci PROJECT con il tuo ID progetto Google Cloud.

Installa il pacchetto

Installa il pacchetto che hai aggiunto al repository.

1. Aggiorna l'elenco dei pacchetti disponibili:

   sudo apt update
   

2. Installa il pacchetto nel tuo repository.

   sudo apt install apt-dpkg-ref/quickstart-apt-repo
   

   Le informazioni di installazione restituite sono simili all'esempio seguente:

   Reading package lists... Done
   Building dependency tree
   Reading state information... Done
   Selected version '5.3.1+nmu2' (Debian:10.7/stable, namespaces/my-repo/repositories/quickstart-apt-repo:quickstart
   -apt-repo [all]) for 'apt-dpkg-ref'
   The following NEW packages will be installed:
     apt-dpkg-ref
   0 upgraded, 1 newly installed, 0 to remove and 3 not upgraded.
   Need to get 113 kB of archives.
   After this operation, 128 kB of additional disk space will be used.
   Get:1 http://deb.debian.org/debian buster/main amd64 apt-dpkg-ref all 5.3.1+nmu2 [113 kB]
   Fetched 113 kB in 0s (693 kB/s)
   Selecting previously unselected package apt-dpkg-ref.
   (Reading database ... 39506 files and directories currently installed.)
   Preparing to unpack .../apt-dpkg-ref_5.3.1+nmu2_all.deb ...
   Unpacking apt-dpkg-ref (5.3.1+nmu2) ...
   Setting up apt-dpkg-ref (5.3.1+nmu2) ...
   

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

Prima di rimuovere il repository, assicurati che tutti i pacchetti che vuoi conservare siano disponibili in un'altra posizione.

Per eliminare il repository:

Console

1. Apri la pagina Repository nella console Google Cloud .

   Apri la pagina Repositori

2. Nell'elenco dei repository, seleziona il repository quickstart-apt-repo.

3. Fai clic su Elimina.

gcloud

1. Per eliminare il repository quickstart-apt-repo, esegui questo comando:

   gcloud artifacts repositories delete quickstart-apt-repo
   

2. Se vuoi rimuovere il repository predefinito e le impostazioni di posizione configurate per la configurazione gcloud attiva, esegui i comandi seguenti:

   gcloud config unset artifacts/repository
   gcloud config unset artifacts/location
   

Per eliminare la VM che hai creato, esegui il seguente comando:

gcloud compute instances delete quickstart-apt-vm

Passaggi successivi

• Scopri di più sull'utilizzo dei pacchetti Deb.
• Scopri di più su DevOps ed esplora il programma di ricerca DevOps.