Auf dieser Seite wird beschrieben, wie Sie Debian-Pakete in Apt-Repositories hinzufügen, aufrufen und löschen.
Hinweis
- Wenn das Ziel-Apt-Repository nicht vorhanden ist, erstellen Sie ein neues Repository.
- Konfigurieren Sie VMs für den Zugriff auf das Repository.
- (Optional) Konfigurieren Sie die Standardeinstellungen für gcloud-Befehle.
- 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. Berechtigungen
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, können die Pakete im Rahmen des Builds in Cloud Storage gespeichert werden, damit Sie sie importieren können.
Sehr lange Import- oder Uploadvorgänge überschreiten möglicherweise den Ablaufzeitraum für das Token, 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:
REPOSITORYist der Name des Artifact Registry-Repositorys.-
LOCATIONist der regionale Speicherort des Repositorys. PACKAGESist der Pfad zum Paket.
So laden Sie beispielsweise das Paket my-package.deb in das Apt-Repository my-repo am Speicherort u-france-east1 hoch:
gcloud artifacts apt upload my-repo \
--location=u-france-east1 \
--source=my-package.deb
Cloud Storage
- So laden Sie die Pakete in Cloud Storage hoch:
- Führen Sie dazu diesen Befehl aus:
gcloud artifacts apt import REPOSITORY \ --location=LOCATION \ --gcs-source=PACKAGES
Ersetzen Sie die folgenden Werte:
REPOSITORYist der Name des Artifact Registry-Repositorys.-
LOCATIONist der regionale Speicherort des Repositorys. PACKAGESist 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.debund alle Pakete im Verzeichnisdirectoryaus dem Bucketmy-bucketin das Apt-Repositorymy-repoam Speicherortu-france-east1hochladen möchten, führen Sie folgenden Befehl aus:gcloud artifacts apt import my-repo \ --location=u-france-east1 \ --gcs-source=gs://my-bucket/path/to/package.deb,gs://my-bucket/directory*
Nach Abschluss des Upload- oder Importvorgangs können Sie dieCloud de Confiance -Konsole 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 mehrere Minuten dauern, bis der Paketindex neu generiert wird, sodass die neuen Pakete für den Apt-Client sichtbar sind.
Pakete ansehen
Repository-Modi:StandardZum Aufrufen von Paketen benötigen Sie die Berechtigungen in der Rolle „Artifact Registry Reader“. In Artifact Registry werden keine Dateien in Paketen aufgeführt.
So rufen Sie die Pakete und Paketversionen mit der Cloud de Confiance -Konsole oder gcloud ab:
Console
Öffnen Sie in der Cloud de Confiance Console die Seite Repositories.
Klicken Sie in der Liste der Repositories auf das entsprechende Repository.
Auf der Seite Pakete sind die Pakete des Repositorys aufgeführt.
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:
REPOSITORYist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.-
LOCATIONist der regionale Speicherort des Repositorys. 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:
PACKAGEist die ID des Pakets oder die vollqualifizierte Kennzeichnung für das Paket.REPOSITORYist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.-
LOCATIONist der regionale Speicherort des Repositorys. 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:StandardPrüfen Sie vor der Installation von Paketen, ob Sie den Paketmanager und das Repository richtig konfiguriert haben.
So installieren Sie ein Paket im Repository:
Aktualisieren Sie die Liste der verfügbaren Pakete:
sudo apt updateInstallieren Sie das Paket und geben Sie den Namen des in Apt konfigurierten Repository an.
sudo apt install PACKAGE/REPOSITORYErsetzen Sie die folgenden Werte:
PACKAGEist der Paketname.REPOSITORYist der Name des Artifact Registry-Repositorys.
Wenn Sie beispielsweise das Paket
my-packageaus dem Repositorymy-repoinstallieren möchten, führen Sie den folgenden Befehl aus:sudo apt install my-package -t my-repo
Pakete löschen
Repository-Modi:Standard
Before you delete a package or package version, verify that any you have communicated or addressed any important dependencies on it.
To delete a package:
Console
Open the Repositories page in the Cloud de Confiance console.
In the repository list, click the appropriate repository.
The Packages page lists the packages in the repository.
Select the package that you want to delete.
Click DELETE.
In the confirmation dialog box, click DELETE.
gcloud
Run the following command:
gcloud artifacts packages delete PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION] [--async]
Replace the following:
PACKAGEis the name of the package in the repository.REPOSITORYis the name of the repository. If you configured a default repository, then you can omit this flag to use the default.-
LOCATIONis the regional location of the repository. Use this flag to view repositories in a specific location. If you configured a default location, then you can omit this flag to use the default.
The --async flag causes the command to return immediately,
without waiting for the operation in progress to complete.
To delete versions of a package:
Console
Open the Repositories page in the Cloud de Confiance console.
In the repository list, click the appropriate repository.
The Packages page lists the packages in the repository.
Click a package to view versions of that package.
Select versions that you want to delete.
Click DELETE.
In the confirmation dialog box, click DELETE.
gcloud
Run the following command:
gcloud artifacts versions delete VERSION \
--package=PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION] \
[--async]
Replace the following:
VERSIONis the name of the version to delete.PACKAGEis the name of the package in the repository.REPOSITORYis the name of the repository. If you configured a default repository, then you can omit this flag to use the default.-
LOCATIONis the regional location of the repository. Use this flag to view repositories in a specific location. If you configured a default location, then you can omit this flag to use the default.
The --async flag causes the command to return immediately,
without waiting for the operation in progress to complete.
Bei großen Repositories kann es einige Minuten dauern, bis der Apt-Paketindex neu generiert wird, um Löschungen zu berücksichtigen.