Archiviare i pacchetti Apt in Artifact Registry

Questa guida rapida mostra come configurare un repository Apt privato di Artifact Registry, 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 la sezione Utilizzo dei pacchetti Debian.

Prima di iniziare

  1. In the Trusted Cloud console, on the project selector page, select or create a Trusted Cloud project.

    Go to project selector

  2. Verify that billing is enabled for your Trusted Cloud project.

  3. Enable the Artifact Registry API.

    Enable the API

  4. Installa gcloud CLI

    1. Installa e inizializza Google Cloud CLI se non è già installata. Per un'installazione esistente, aggiorna i componenti di Google Cloud CLI con il comando:

      gcloud components update
      

      Per controllare la versione di gcloud CLI, esegui il comando:

      gcloud version
      

    Crea un repository

    Crea il repository per gli artefatti.

    1. Crea il repository:

      Console

      1. Apri la pagina Repository nella console Trusted Cloud .

        Apri la pagina Repositori

      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à u-france-east1.

      6. Fai clic su Crea.

      Il repository viene aggiunto all'elenco dei repository.

      gcloud

      1. In Cloud Shell, esegui questo comando per creare un nuovo repository Apt nel progetto corrente denominato quickstart-apt-repo nella posizione u-france-east1.

        gcloud artifacts repositories create quickstart-apt-repo \
            --repository-format=apt \
            --location=u-france-east1 \
            --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 importare un pacchetto archiviato in Cloud Storage.

    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 l'ultima versione del pacchetto disponibile dai 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 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 u-france-east1. Una volta impostati i valori, non devi 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 u-france-east1
      

      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 Trusted Cloud .

      Apri la pagina Repositori

    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 di Compute Engine in cui installare il pacchetto di esempio.

    In Cloud Shell, esegui questo comando per creare un'istanza VM denominata 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 richiesti per utilizzare 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 Apt che definisce i repository dei pacchetti.

    1. Vai alla pagina Istanze VM.

      Apri la pagina Istanze VM

    2. Nella riga della tua 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 tua VM.

    4. Aggiornamento dell'appartamento:

      sudo apt update
      
    5. Installa l'helper delle credenziali Apt sulla VM per consentire ad Apt di eseguire l'autenticazione:

      sudo apt install apt-transport-artifact-registry
      
    6. Configura la VM per accedere ai pacchetti Artifact Registry:

      echo 'deb ar+https://u-france-east1-apt.s3nsregistry.fr/projects/PROJECT quickstart-apt-repo main' | sudo tee -a  /etc/apt/sources.list.d/artifact-registry.list
      

      Sostituisci PROJECT con l'ID progetto Trusted Cloud by S3NS.

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

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

      Le informazioni di installazione restituite sono simili al seguente esempio:

      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 Trusted 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 Trusted Cloud .

      Apri la pagina Repository

    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 questo comando:

    gcloud compute instances delete quickstart-apt-vm
    

    Passaggi successivi