Apt-Pakete in Artifact Registry speichern

In dieser Kurzanleitung wird gezeigt, wie Sie ein privates Apt-Repository für Artifact Registry einrichten, ein Debian-Paket in das Repository einfügen und das Paket auf einer Compute Engine-VM installieren, auf der ein Debian-basiertes Betriebssystem ausgeführt wird.

Weitere Informationen zum Verwalten von Debian-Paketen finden Sie unter Mit Debian-Paketen arbeiten.

Hinweise

  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. gcloud-CLI installieren

    1. Installieren und initialisieren Sie die Google Cloud CLI, falls sie noch nicht installiert ist. Aktualisieren Sie für eine vorhandene Installation die Komponenten der Google Cloud CLI mit dem Befehl:

      gcloud components update
      

      Führen Sie den folgenden Befehl aus, um die Version der gcloud CLI zu prüfen:

      gcloud version
      

    Repository erstellen

    Erstellen Sie das Repository für Ihre Artefakte.

    1. Im Folgenden wird gezeigt, wie Sie das Repository anlegen.

      Console

      1. Öffnen Sie in der Trusted Cloud Console die Seite Repositories.

        Zur Seite „Repositories“

      2. Klicken Sie auf Repository erstellen.

      3. Geben Sie quickstart-apt-repo als Repository-Namen an.

      4. Wählen Sie Apt als Format aus.

      5. Wählen Sie unter Standorttyp die Option Region und dann den Standort u-france-east1 aus.

      6. Klicken Sie auf Erstellen.

      Das Repository wird der Repository-Liste hinzugefügt.

      gcloud

      1. Führen Sie in Cloud Shell den folgenden Befehl aus, um ein neues Apt-Repository im aktuellen Projekt mit dem Namen quickstart-apt-repo am Speicherort u-france-east1 zu erstellen.

        gcloud artifacts repositories create quickstart-apt-repo \
            --repository-format=apt \
            --location=u-france-east1 \
            --description="Apt repository"
        
      2. Führen Sie den folgenden Befehl aus, um zu prüfen, ob Ihr Repository erstellt wurde:

        gcloud artifacts repositories list
        

    Sie können dem Repository jetzt ein Paket hinzufügen.

    Paket dem Repository hinzufügen

    Sie können ein Paket mit der Google Cloud CLI in ein Repository hochladen oder ein Paket importieren, das in Cloud Storage gespeichert ist.

    In dieser Kurzanleitung laden Sie eine Beispieldatei mit dem Befehl gcloud artifacts apt upload hoch.

    1. Laden Sie in Cloud Shell die Apt-Kurzübersicht mit dem folgenden Befehl herunter:

      apt download apt-dpkg-ref
      

      Apt lädt die neueste Version des Pakets herunter, die in den konfigurierten Apt-Repositories verfügbar ist.

      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)
      

      Führen Sie ls aus, um den Dateinamen des Apt-Kurzübersichtsblatts zu erhalten. Der Dateiname ähnelt apt-dpkg-ref_5.3.1+nmu2_all.deb.

    2. Um die gcloud-Befehle zu vereinfachen, legen Sie für das Standard-Repository den Wert quickstart-apt-repo und für den Standard-Speicherort u-france-east1 fest. Nachdem Sie die Werte festgelegt haben, müssen Sie diese nicht mehr in gcloud-Befehlen angeben, für die ein Repository oder Speicherort erforderlich ist.

      Führen Sie den folgenden Befehl aus, um das Repository festzulegen:

      gcloud config set artifacts/repository quickstart-apt-repo
      

      Führen Sie den folgenden Befehl aus, um den Standort festzulegen:

      gcloud config set artifacts/location u-france-east1
      

      Weitere Informationen zu diesen Befehlen finden Sie in der Dokumentation zu gcloud config set.

    3. Führen Sie den Befehl gcloud artifacts apt upload aus, um das Paket in das Repository hochzuladen:

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

      Ersetzen Sie FILE_NAME durch den Pfad zum Apt-Kurzübersicht.

    Paket im Repository ansehen

    Prüfen Sie, ob Ihr Paket dem Repository hinzugefügt wurde.

    Console

    1. Öffnen Sie in der Trusted Cloud Console die Seite Repositories.

      Zur Seite „Repositories“

    2. Klicken Sie in der Repository-Liste auf das Repository quickstart-apt-repo.

      Auf der Seite Pakete sind die Pakete des Repositorys aufgeführt.

    gcloud

    Führen Sie den folgenden Befehl aus, um die Pakete im Repository quickstart-apt-repo aufzulisten:

     gcloud artifacts packages list
    

    Führen Sie den folgenden Befehl aus, um Versionen für ein Paket in quickstart-apt-repo aufzurufen:

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

    VM erstellen

    Erstellen Sie eine neue Compute Engine-VM, auf der Sie das Beispielpaket installieren.

    Führen Sie in Cloud Shell den folgenden Befehl aus, um eine VM-Instanz mit dem Namen quickstart-apt-vm zu erstellen:

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

    Standardmäßig hat die VM nicht die erforderlichen Zugriffsbereiche für die Arbeit mit dem Repository. Mit dem Flag --scopes wird der Zugriffsbereich für die VM auf cloud-platform festgelegt.

    Paketmanager konfigurieren

    Wenn Sie ein Paket auf der VM installieren möchten, fügen Sie das von Ihnen erstellte Repository der Apt-Konfigurationsdatei hinzu, in der Paket-Repositories definiert sind.

    1. Gehen Sie zur Seite "VM-Instanzen".

      Seite „VM-Instanzen“ aufrufen

    2. Klicken Sie in der Zeile mit Ihrer VM auf SSH. Ein neues Fenster mit einer Terminalsitzung auf der VM wird geöffnet.

    3. Führen Sie gcloud init aus, um die Google Cloud CLI auf Ihrer VM zu initialisieren.

    4. Update Apt:

      sudo apt update
      
    5. Installieren Sie den Apt-Anmeldeinformationshelfer auf der VM, damit Apt die Authentifizierung durchführen kann:

      sudo apt install apt-transport-artifact-registry
      
    6. VM für den Zugriff auf Artifact Registry-Pakete konfigurieren:

      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
      

      Ersetzen Sie PROJECT durch Ihre Trusted Cloud by S3NS Projekt-ID.

    Paket installieren

    Installieren Sie das Paket, das Sie dem Repository hinzugefügt haben.

    1. Aktualisieren Sie die Liste der verfügbaren Pakete:

      sudo apt update
      
    2. Installieren Sie das Paket in Ihrem Repository.

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

      Die zurückgegebenen Installationsinformationen sehen so aus:

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

    Bereinigen

    Mit den folgenden Schritten vermeiden Sie, dass Ihrem Trusted Cloud -Konto die auf dieser Seite verwendeten Ressourcen in Rechnung gestellt werden:

    Prüfen Sie vor dem Entfernen des Repositorys, ob alle Pakete, die Sie beibehalten möchten, an einem anderen Speicherort verfügbar sind.

    So löschen Sie das Repository:

    Console

    1. Öffnen Sie in der Trusted Cloud Console die Seite Repositories.

      Zur Seite „Repositories“

    2. Wählen Sie in der Repository-Liste das Repository quickstart-apt-repo aus.

    3. Klicken Sie auf Löschen.

    gcloud

    1. Um das Repository quickstart-apt-repo zu löschen, führen Sie folgenden Befehl aus:

      gcloud artifacts repositories delete quickstart-apt-repo
      
    2. Wenn Sie die Standardeinstellungen für das Repository und den Standort entfernen möchten, die Sie für die aktive gcloud-Konfiguration festgelegt haben, führen Sie die folgenden Befehle aus:

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

    Führen Sie den folgenden Befehl aus, um die erstellte VM zu löschen:

    gcloud compute instances delete quickstart-apt-vm
    

    Nächste Schritte