Diese Seite wurde von der Cloud Translation API übersetzt.

Mit anderen Artefaktformaten arbeiten

Auf dieser Seite wird beschrieben, wie versionierte, unveränderliche Artefakte gespeichert werden, die keine Sie müssen ein bestimmtes Paketformat im generischen Artifact Registry-Format einhalten Repositories.

Um sich mit dem Speichern generischer Artefakte in Artifact Registry vertraut zu machen, können Sie den Schnellstart ausprobieren.

Generische Artefakte sind Dateien in jedem Format, einschließlich, aber nicht beschränkt auf Folgendes:

Komprimierte Dateien wie TAR- und ZIP-Dateien
Konfigurationsdateien wie YAML- und TOML-Dateien
Textdateien und PDFs
Binärprogramme
Archive
Mediendateien

Im Gegensatz zu anderen Formaten werden Artefakte, die in Repositories für generische Formate gespeichert sind, nicht die von Docker, Paketmanagern oder anderen Clients von Drittanbietern verwendet werden.

Hinweise

Erstellen Sie ein Repository für generisches Format.
Prüfen Sie, ob Sie über die erforderlichen Berechtigungen für die zu erstellen.
(Optional) Konfigurieren Sie Standardeinstellungen für Google Cloud CLI-Befehle.

Erforderliche Rollen

Um die Berechtigungen zu erhalten, die Sie zum Verwalten generischer Artefakte benötigen, bitten Sie Ihren Administrator, Ihnen folgende IAM-Rollen für das Repository:

Artefakte ansehen: Artifact Registry-Leser (roles/artifactregistry.reader)
Artefakte herunterladen: Artifact Registry-Leser (roles/artifactregistry.reader)
Artefakte in ein Repository hochladen: Artifact Registry-Autor (roles/artifactregistry.writer)
Artefakte löschen: Artifact Registry-Repository-Administrator (roles/artifactregistry.repoAdmin)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

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

Generische Artefakte hochladen

Sie können generische Artefakte einzeln nach Datei oder zu mehreren Artefakten hochladen, indem Sie -Verzeichnis. Beim Hochladen müssen ein Paketname und eine Versionsnummer angegeben ist. Sie können auch den Pfad in der Zieldateistruktur angeben, und sie hochladen. Wenn kein Zielpfad angegeben ist, werden Artefakte in diesen Ordner hochgeladen: standardmäßig zur Stammebene.

Führen Sie den folgenden Befehl aus, um generische Artefakte in Ihr Repository hochzuladen:

gcloud

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

PROJECT: Ihr Google Cloud-Team Projekt-ID. Wenn Ihre Projekt-ID einen Doppelpunkt (:) enthält, lesen Sie die Informationen unter Auf Domains beschränkte Projekte

LOCATION: der regionale oder multiregionale Speicherort des Repositorys.

REPOSITORY: der Name des Repositorys, in dem der wird das Artefakt gespeichert.

SOURCE: Speicherort und Name Ihrer Datei wird hochgeladen.

PACKAGE: der Paketname der Datei, die Sie gerade bearbeiten. wird hochgeladen.

VERSION: Die Version der Datei, die Sie hochladen.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud artifacts generic upload \
    --project=PROJECT \
    --source=SOURCE \
    --package=PACKAGE \
    --version=VERSION \
    --location=LOCATION \
    --repository=REPOSITORY

Windows (PowerShell)

gcloud artifacts generic upload `
    --project=PROJECT `
    --source=SOURCE `
    --package=PACKAGE `
    --version=VERSION `
    --location=LOCATION `
    --repository=REPOSITORY

Windows (cmd.exe)

gcloud artifacts generic upload ^
    --project=PROJECT ^
    --source=SOURCE ^
    --package=PACKAGE ^
    --version=VERSION ^
    --location=LOCATION ^
    --repository=REPOSITORY

Beim Hochladen von Artefakten können Sie zusätzliche Flags verwenden:

--destination-path=PATH zum Hochladen in einen bestimmten Ordner im Paket und Version. Außerdem werden Ordner erstellt, die nicht vorhanden sind.
--source-directory=SOURCE_DIR als Ersatz für --source und laden Sie statt einer einzelnen Datei ein Verzeichnis hoch.
--skip-existing, wenn Sie das Flag --source-directory zum Überspringen verwenden bereits vorhandenen Dateien. Andernfalls schlägt der Befehl fehl, wenn versucht wird, eine Datei hochzuladen, die existiert bereits.

API

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT ist Ihre Google Cloud-Projekt-ID. Wenn Ihre Projekt-ID einen Doppelpunkt (:) enthält, lesen Sie die Informationen unter Auf Domains beschränkte Projekte
LOCATION ist das regionale oder Multiregionaler Speicherort des Repositorys.
REPOSITORY ist der Name des Repository, in dem das Artefakt gespeichert ist.
SOURCE ist der Standort und der Name von der hochzuladenden Datei.
PACKAGE ist der Paketname des Datei, die Sie hochladen.
VERSION ist die Version der Datei, die Sie die gerade hochgeladen werden.
NAME ist der neue Name der Datei in der zu erstellen.

HTTP-Methode und URL:

  POST https://artifactregistry.googleapis.com/upload/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/genericArtifacts:create?alt=json

curl (Linux, macOS oder Cloud Shell)

Führen Sie den folgenden Befehl aus, um Ihre Anfrage zu senden:

  curl -v \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -F "meta={'filename':'NAME','package_id':'PACKAGE','version_id':'VERSION'};type=application/json" \
      -F "blob=@SOURCE" \
      https://artifactregistry.googleapis.com/upload/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSTIORY/genericArtifacts:create?alt=json

Artefakte auflisten

Console

Artefakte für Repositories im generischen Format finden Sie in der Google Cloud Console

Öffnen Sie in der Cloud Console die Seite Repositories.

Zur Seite „Repositories“
Wählen Sie das Repository aus der Repository-Liste aus.
Klicke auf den Namen des Pakets.
Um herunterladbare Dateien für alle Paketversionen anzusehen, klicken Sie auf den Tab Dateien. .
Um herunterladbare Dateien für eine bestimmte Version Ihres Pakets anzuzeigen, klicken Sie auf den Versionsnamen und klicken Sie dann auf den Tab Dateien.

gcloud

Sie können Artefakte in einem Repository mit der gcloud artifacts files list auflisten .

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

PROJECT: Ihr Google Cloud-Team Projekt-ID. Wenn Ihre Projekt-ID einen Doppelpunkt (:) enthält, lesen Sie die Informationen unter Auf Domains beschränkte Projekte
LOCATION: der regionale oder multiregionale Speicherort des Repositorys.
REPOSITORY: der Name des Repositorys, in dem der wird das Artefakt gespeichert.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud artifacts files list \
    --project=PROJECT \
    --location=LOCATION \
    --repository=REPOSITORY

Windows (PowerShell)

gcloud artifacts files list `
    --project=PROJECT `
    --location=LOCATION `
    --repository=REPOSITORY

Windows (cmd.exe)

gcloud artifacts files list ^
    --project=PROJECT ^
    --location=LOCATION ^
    --repository=REPOSITORY

Die Antwort enthält die Dateidetails im Format PACKAGE:VERSION:NAME.

FILE: my-package:1.0.0:hello.yaml
CREATE_TIME: 2023-03-09T20:55:07
UPDATE_TIME: 2023-03-09T20:55:07
SIZE (MB): 0.000
OWNER: projects/my-project/locations/us-central1/repositories/quickstart-generic-repo/packages/my-package/versions/1.0.0

Es ist auch möglich, nach Version und Paket zu sortieren, indem Sie eines oder beide der folgende Flags verwenden:

--package=PACKAGE, um nur Dateien eines bestimmten Paket.
--version=VERSION, um nur Dateien eines bestimmten Version.

Generische Artefakte herunterladen

Führen Sie den folgenden Befehl aus, um generische Artefakte aus Ihrem Repository herunterzuladen:

gcloud

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

DESTINATION: Pfad zum Zielordner in Ihrem lokalen Dateisystem. Der Zielordner muss bereits vorhanden sein. Andernfalls wird der Befehl scheitern.
LOCATION: der regionale oder multiregionale Speicherort des Repositorys.
REPOSITORY: der Name des Repositorys, in dem der wird das Artefakt gespeichert.
PACKAGE: das Paket der Datei, die heruntergeladen werden soll.
VERSION: Die Version der herunterzuladenden Datei.
NAME (optional): Der Name der herunterzuladenden Datei. Ohne dieses Flag lädt der Befehl alle Dateien für das angegebene Paket und die angegebene Version als und die erforderlichen Verzeichnisse am Ziel erstellen.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud artifacts generic download \
    --destination=DESTINATION \
    --location=LOCATION \
    --repository=REPOSITORY \
    --package=PACKAGE \
    --version=VERSION \
    --name=NAME

Windows (PowerShell)

gcloud artifacts generic download `
    --destination=DESTINATION `
    --location=LOCATION `
    --repository=REPOSITORY `
    --package=PACKAGE `
    --version=VERSION `
    --name=NAME

Windows (cmd.exe)

gcloud artifacts generic download ^
    --destination=DESTINATION ^
    --location=LOCATION ^
    --repository=REPOSITORY ^
    --package=PACKAGE ^
    --version=VERSION ^
    --name=NAME

API

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT: Ihr Google Cloud-Team Projekt-ID. Wenn die Projekt-ID einen Doppelpunkt (:) enthält, finden Sie weitere Informationen unter Auf Domains beschränkte Projekte.
LOCATION: der regionale oder multiregionale Speicherort des Repositorys.
REPOSITORY: der Name des Repositorys wo das Artefakt gespeichert ist.
DESTINATION: der Pfad zum Zielordner in Ihrem lokalen Dateisystem. Der Zielordner muss bereits vorhanden sein oder der schlägt fehl.
FILE: der URL-codierte Dateiname. Sie können Ermitteln Sie diesen Wert, indem Sie den Befehl gcloud artifacts files list ausführen und den Wert für FILE kopieren. Das muss für diesen Befehl in ein URL-codiertes Format konvertiert, z. B. path/to/file.jar muss als path%2Fto%2Ffile.jar eingegeben werden.

HTTP-Methode und URL:

GET https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Führen Sie folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     --output DESTINATION \
     "https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media"

PowerShell (Windows)

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -OutFile DESTINATION `
    -Uri "https://artifactregistry.googleapis.com/download/v1/projects/PROJECT/locations/LOCATION/repositories/REPOSITORY/files/FILE:download?alt=media"

Der Download sollte sofort beginnen.

Generische Artefakte löschen

Führen Sie den Befehl gcloud artifacts files delete aus, um generische Artefakte aus Ihrem Repository zu löschen. Dieser Befehl ist nur für das allgemeine Format verfügbar Repositories.

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

FILE: der vollständige Dateiname. Sie finden diesen Wert den Befehl gcloud artifacts files list ausführen und den Wert für FILE kopieren.
LOCATION: der regionale oder multiregionale Speicherort des Repositorys.
REPOSITORY: der Name des Repositorys, in dem der wird das Artefakt gespeichert.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud artifacts files delete \
    FILE \
    --location=LOCATION \
    --repository=REPOSITORY

Windows (PowerShell)

gcloud artifacts files delete `
    FILE `
    --location=LOCATION `
    --repository=REPOSITORY

Windows (cmd.exe)

gcloud artifacts files delete ^
    FILE ^
    --location=LOCATION ^
    --repository=REPOSITORY

Nächste Schritte

Kurzanleitung für generisches Repository