Apt-Pakete in Artifact Registry speichern

In dieser Kurzanleitung wird gezeigt, wie Sie ein privates Artifact Registry-Apt-Repository einrichten, ein Debian-Paket zum Repository hinzufü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.

Hinweis

  1. Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie noch kein Google Cloud-Konto haben, erstellen Sie ein Konto, um zu sehen, wie sich unsere Produkte in realen Szenarien schlagen. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

  4. Verify that billing is enabled for your Google Cloud project.

  5. Enable the Artifact Registry API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  7. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

  8. Verify that billing is enabled for your Google Cloud project.

  9. Enable the Artifact Registry API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    10.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen und Verwalten von Artifact Registry-Apt-Paket-Repositories benötigen:

  • Artifact Registry-Administrator (roles/artifactregistry.admin)
  • Compute Instance Admin (Version 1) (roles/compute.instanceAdmin.v1) zum Erstellen einer virtuellen Maschine (VM) in Compute Engine:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Cloud Shell starten

Die Google Cloud CLI ist in Cloud Shell vorinstalliert. Die gcloud CLI bietet die primäre Befehlszeile für Google Cloud.

Cloud Shell aufrufen

  1. Zur Google Cloud Console.

    Google Cloud Console

  2. Klicken Sie in der Google Cloud Console auf Cloud Shell aktivieren Button „Cloud Shell aktivieren“.

In einem Frame im unteren Teil der Console wird eine Cloud Shell-Sitzung geöffnet. In dieser Shell führen Sie die gcloud-Befehle aus, um eine VM und ein Repository zu erstellen.

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 Google 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 us-west1 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 Standort us-west1 zu erstellen.

      gcloud artifacts repositories create quickstart-apt-repo \
    --repository-format=apt \
    --location=us-west1 \
    --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 jetzt ein Paket zum Repository hinzufügen. Cloud Shell verwendet ein von Google erstelltes Ubuntu-Image, nicht Debian. Zum Verwalten von Debian-Paketen im Repository verwenden Sie eine VM, die ein Debian-Betriebssystem-Image verwendet.

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-12 \
    --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.

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

    Seite „VM-Instanzen“ öffnen

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

Paket zum 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. Wenn Sie Pakete mit Cloud Build erstellen, kann der Build die Pakete in Cloud Storage speichern, damit Sie sie importieren können.

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

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

  2. Aktualisieren Sie Apt:

    sudo apt update

  3. Laden Sie das Curl-Paket mit dem folgenden Befehl herunter:

    apt download curl

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

    Get:1 file:/etc/apt/mirrors/debian.list Mirrorlist [30 B]
Get:2 https://deb.debian.org/debian bookworm/main amd64 curl amd64 7.88.1-10+deb12u14 [316 kB]
Fetched 316 kB in 0s (3078 kB/s)

    Führen Sie ls aus, um den Dateinamen des Curl-Pakets zu erhalten. Der Dateiname ähnelt curl_7.88.1-10+deb12u14_amd64.deb.

  4. Um die gcloud Befehle zu vereinfachen, legen Sie für das Standard-Repository den Wert quickstart-apt-repo und für den standardmäßigen Standort us-west1 fest. Nachdem die Werte festgelegt wurden, müssen Sie sie nicht mehr in gcloud-Befehlen angeben, die ein Repository oder einen Speicherort erfordern.

    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 us-west1

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

  5. Führen Sie 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 Curl-Paket.

Paket im Repository ansehen

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

Console

  1. Öffnen Sie in der Google 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 die Versionen eines Pakets in quickstart-apt-repo aufzurufen:

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

Paketmanager konfigurieren

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

  1. Installieren Sie den Apt-Anmeldeinformationshelfer auf der VM, damit Apt die Authentifizierung durchführen kann:

    sudo apt install apt-transport-artifact-registry

  2. Konfigurieren Sie Ihre VM für den Zugriff auf Artifact Registry-Pakete:

    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

    Ersetzen Sie PROJECT durch Ihre Google Cloud 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 aus Ihrem Repository.

    sudo apt install curl/quickstart-apt-repo

    Die zurückgegebenen Installationsinformationen sehen so aus:

    Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
Selected version '7.88.1-10+deb12u14' (quickstart-apt-repo:quickstart-apt-repo, Debian:12.12/oldstable [amd64]) for 'curl'
The following additional packages will be installed:
  libcurl3-gnutls libcurl4
The following packages will be upgraded:
  curl libcurl3-gnutls libcurl4
3 upgraded, 0 newly installed, 0 to remove and 77 not upgraded.
Need to get 1093 kB of archives.
After this operation, 0 B of additional disk space will be used.
Do you want to continue? [Y/n] y
Get:1 file:/etc/apt/mirrors/debian.list Mirrorlist [30 B]
Get:2 https://deb.debian.org/debian bookworm/main amd64 libcurl4 amd64 7.88.1-10+deb12u14 [392 kB]
Get:3 https://deb.debian.org/debian bookworm/main amd64 libcurl3-gnutls amd64 7.88.1-10+deb12u14 [386 kB]
Get:4 ar+https://us-west1-apt.pkg.dev/projects/PROJECT quickstart-apt-repo/main amd64 curl amd64 7.88.1-10+deb12u14 [316 kB]
Fetched 1093 kB in 1s (947 kB/s)
Reading changelogs... Done
(Reading database ... 72080 files and directories currently installed.)
Preparing to unpack .../curl_7.88.1-10+deb12u14_amd64.deb ...
Unpacking curl (7.88.1-10+deb12u14) over (7.88.1-10+deb12u12) ...
Preparing to unpack .../libcurl4_7.88.1-10+deb12u14_amd64.deb ...
Unpacking libcurl4:amd64 (7.88.1-10+deb12u14) over (7.88.1-10+deb12u12) ...
Preparing to unpack .../libcurl3-gnutls_7.88.1-10+deb12u14_amd64.deb ...
Unpacking libcurl3-gnutls:amd64 (7.88.1-10+deb12u14) over (7.88.1-10+deb12u12) ...
Setting up libcurl3-gnutls:amd64 (7.88.1-10+deb12u14) ...
Setting up libcurl4:amd64 (7.88.1-10+deb12u14) ...
Setting up curl (7.88.1-10+deb12u14) ...
Processing triggers for man-db (2.11.2-2) ...
Processing triggers for libc-bin (2.36-9+deb12u10) ...

Bereinigen

Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google 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 Google 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