Debian-Pakete verwalten

Mit Apt-Repositories in Artifact Registry können Sie Ihre Debian-Pakete zentral verwalten und konsistente Softwareabhängigkeiten für Ihre Linux-Arbeitslasten beibehalten. Sie können Pakete hinzufügen, ansehen und löschen oder auf Ihren konfigurierten VMs installieren.

Hinweis

1. Wenn das Apt-Ziel-Repository nicht vorhanden ist, erstellen Sie ein neues Repository.
2. Konfigurieren Sie VMs für den Zugriff auf das Repository.
3. (Optional) Konfigurieren Sie die Standardeinstellungen für gcloud-Befehle.
4. Achten Sie darauf, dass die Paketnamen in den Metadaten den Debian-Paketnamensstandards entsprechen.

Pakete hinzufügen

Repository-Modi: Standard

Sie benötigen sowohl Lese- als auch Schreibberechtigungen für das Repository, um Pakete hinzuzufügen.

Sie können ein Paket mit der Google Cloud CLI in ein Repository hochladen oder ein in Cloud Storage gespeichertes Paket importieren. Wenn Sie Pakete mit Cloud Build erstellen, können die Pakete in Cloud Storage gespeichert werden, damit Sie sie importieren können.

Sehr lange Import- oder Uploadvorgänge können die Ablaufzeit des Tokens überschreiten, das die gcloud CLI zum Aufrufen der API verwendet. Wenn Sie eine sehr große Anzahl von Paketen hinzufügen möchten, sollten Sie sie in kleineren Batches hinzufügen, damit jeder Upload- oder Importvorgang in kürzerer Zeit abgeschlossen werden kann. Weitere Informationen finden Sie in der Dokumentation zur Fehlerbehebung bei Betriebssystempaketen.

Direkter Upload

Verwenden Sie den Befehl gcloud artifacts apt upload, um ein Paket in ein Apt-Repository hochzuladen:

gcloud artifacts apt upload REPOSITORY \
    --location=LOCATION \
    --source=PACKAGES

Ersetzen Sie die folgenden Werte:

• REPOSITORY ist der Name des Artifact Registry-Repositorys.
• LOCATION ist der regionale oder multiregionale Speicherort des Repositorys.
• PACKAGES ist der Pfad zum Paket.

Wenn Sie beispielsweise das Paket my-package.deb in das Apt-Repository my-repo am Standort us-west1 hochladen möchten, führen Sie folgenden Befehl aus:

gcloud artifacts apt upload my-repo \
    --location=us-west1 \
    --source=my-package.deb

Cloud Storage

1. Laden Sie die Pakete in Cloud Storage hoch. Gehen Sie dazu so vor:
   • Laden Sie Pakete direkt in einen Cloud Storage-Bucket hoch.
   • Pakete mit Cloud Build erstellen und in einem Bucket speichern
2. Führen Sie dazu diesen Befehl aus:

   gcloud artifacts apt import REPOSITORY \
     --location=LOCATION \
     --gcs-source=PACKAGES
   

   Ersetzen Sie die folgenden Werte:

   • REPOSITORY ist der Name des Artifact Registry-Repositorys.
   • LOCATION ist der regionale oder multiregionale Speicherort des Repositorys.
   • PACKAGES ist eine durch Kommas getrennte Liste von Paketen in Cloud Storage. Wenn Sie alle Pakete aus einem Verzeichnis hochladen möchten, verwenden Sie einen Verzeichnisplatzhalter (*) oder einen rekursiven Verzeichnisplatzhalter (**), um alle Pakete in allen Unterverzeichnissen hochzuladen.

   Wenn Sie beispielsweise das Paket package.deb und alle Pakete im Verzeichnis directory aus dem Bucket my-bucket in das Apt-Repository my-repo am Standort us-west1 hochladen möchten, führen Sie folgenden Befehl aus:

   gcloud artifacts apt import my-repo \
     --location=us-west1 \
     --gcs-source=gs://my-bucket/path/to/package.deb,gs://my-bucket/directory*
   

Wenn der Upload- oder Importvorgang abgeschlossen ist, können Sie dieGoogle Cloud Console oder die gcloud CLI verwenden, um Pakete im Repository anzusehen und zu bestätigen, dass sie erfolgreich hochgeladen wurden.

Wenn Sie ein großes Repository mit vielen Paketen haben, kann es einige Minuten dauern, bis der Paketindex neu generiert wurde, sodass die neuen Pakete für den Apt-Client sichtbar sind.

Pakete ansehen

Repository-Modi: Standard, Remote (Vorabversion)

Zum Ansehen von Paketen benötigen Sie die Berechtigungen der Rolle „Artifact Registry-Leser“. Artifact Registry listet keine Dateien in Paketen auf.

So rufen Sie die Pakete und Paketversionen mit der Google Cloud console oder gcloudab:

Console

1. Öffnen Sie in der Google Cloud console die Seite Repositories.

   Zur Seite „Repositories“

2. Klicken Sie in der Liste der Repositories auf das entsprechende Repository.

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

3. Klicken Sie auf das Paket, um die Versionen des Pakets aufzurufen.

gcloud

Führen Sie den folgenden Befehl aus, um die Pakete in einem Repository aufzulisten:

gcloud artifacts packages list [--repository=REPOSITORY] [--location=LOCATION]

Ersetzen Sie Folgendes:

• REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.
• LOCATION ist der regionale oder multiregionale Speicherort für das Repository. Wenn Sie einen Standard Speicherort konfiguriert haben, wird bei Weglassen dieses Flags dieser Standardwert verwendet.

Um die Versionen für ein Paket aufzurufen, führen Sie folgenden Befehl aus:

gcloud artifacts versions list --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION]

Ersetzen Sie Folgendes:

• PACKAGE ist die ID des Pakets oder die voll qualifizierte Kennzeichnung für das Paket.
• REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.
• LOCATION ist der regionale oder multiregionale Speicherort für das Repository. Verwenden Sie dieses Flag, um Repositories an einem bestimmten Speicherort aufzurufen. Wenn Sie einen Standard Speicherort konfiguriert haben, wird bei Weglassen dieses Flags dieser Standardwert verwendet.

Pakete installieren

Repository-Modi: Standard, Remote (Vorabversion)

Prüfen Sie vor der Installation von Paketen, ob Sie den Paketmanager und das Repository richtig konfiguriert haben.

So installieren Sie ein Paket im Repository:

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

   sudo apt update
   

2. Installieren Sie das Paket und geben Sie den Namen des in Apt konfigurierten Repositorys an.

   sudo apt install PACKAGE/REPOSITORY
   

   Ersetzen Sie die folgenden Werte:

   • PACKAGE ist der Paketname.
   • REPOSITORY ist der Name des Artifact Registry-Repositorys. Verwenden Sie für Remote-Repositories den Namen des Standard-Upstream-Repositorys.

   Führen Sie beispielsweise den folgenden Befehl aus, um das Paket my-package aus dem Repository my-repo zu installieren:

   sudo apt install my-package -t my-repo
   

Hinweis: Nach dem Hinzufügen oder Löschen von Paketen kann es einige Minuten dauern, bis der Paketindex neu generiert wird, insbesondere wenn das Repository groß ist. Wenn Sie ein Paket, das dem Repository vor Kurzem hinzugefügt wurde, nicht installieren können, warten Sie einige Minuten und versuchen Sie es dann noch einmal. Weitere Informationen finden Sie in der Dokumentation zur Fehlerbehebung bei Betriebssystempaketen.

Pakete löschen

Repository-Modi: Standard

Bevor Sie ein Paket oder eine Paketversion löschen, prüfen Sie, ob Sie alle wichtigen Abhängigkeiten davon kommuniziert oder behoben haben.

So löschen Sie ein Paket:

Console

1. Öffnen Sie in der Google Cloud console die Seite Repositories.

   Zur Seite „Repositories“

2. Klicken Sie in der Liste der Repositories auf das entsprechende Repository.

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

3. Wählen Sie das Paket aus, das Sie löschen möchten.

4. Klicken Sie auf Löschen.

5. Klicken Sie im Bestätigungsdialogfeld auf Löschen.

gcloud

Führen Sie dazu diesen Befehl aus:

gcloud artifacts packages delete PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] [--async]

Ersetzen Sie Folgendes:

• PACKAGE ist der Name des Pakets im Repository.
• REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.
• LOCATION ist der regionale oder multiregionale Standort des Repositorys. Verwenden Sie dieses Flag, um Repositories an einem bestimmten Speicherort aufzurufen. Wenn Sie einen Standardstandort konfiguriert haben, wird bei Weglassen dieses Flags dieser Standardwert verwendet.

Das Flag --async bewirkt, dass der Befehl sofort zurückgegeben wird, ohne auf den Abschluss des Vorgangs zu warten.

So löschen Sie Versionen eines Pakets:

Console

1. Öffnen Sie in der Google Cloud console die Seite Repositories.

   Zur Seite „Repositories“

2. Klicken Sie in der Liste der Repositories auf das entsprechende Repository.

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

3. Klicken Sie auf das Paket, um die Versionen des Pakets aufzurufen.

4. Wählen Sie die Versionen aus, die Sie löschen möchten.

5. Klicken Sie auf Löschen.

6. Klicken Sie im Bestätigungsdialogfeld auf Löschen.

gcloud

Führen Sie dazu diesen Befehl aus:

gcloud artifacts versions delete VERSION \
    --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] \
    [--async]

Ersetzen Sie Folgendes:

• VERSION ist der Name der zu löschenden Version.
• PACKAGE ist der Name des Pakets im Repository.
• REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.
• LOCATION ist der regionale oder multiregionale Standort des Repositorys. Verwenden Sie dieses Flag, um Repositories an einem bestimmten Speicherort aufzurufen. Wenn Sie einen Standardstandort konfiguriert haben, wird bei Weglassen dieses Flags dieser Standardwert verwendet.

Das Flag --async bewirkt, dass der Befehl sofort zurückgegeben wird, ohne auf den Abschluss des Vorgangs zu warten.

Bei großen Repositories kann es einige Minuten dauern, bis der Apt-Paketindex neu generiert wird, um Löschungen widerzuspiegeln.

Nächste Schritte

• Informationen zum Verwalten von RPM-Paketen
• Einzelne Dateien in einem Paket herunterladen