Andere Formate in Artifact Registry speichern

Informationen zum Einrichten eines Artifact Registry-Repositorys im generischen Format und zum Hochladen einer YAML-Datei

Hinweis

  1. Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. 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 IAM-Rolle Artifact Registry Administrator (roles/artifactregistry.admin) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen und Verwalten von Artifact Registry-Paket-Repositories benötigen. 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

Aktivieren Sie Cloud Shell in der Google Cloud Console.

Cloud Shell aktivieren

Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

In dieser Kurzanleitung verwenden Sie Cloud Shell zum Ausführen von gcloud-Befehlen.

Allgemeines Repository erstellen

  1. Führen Sie den folgenden Befehl aus, um ein Repository im generischen Format mit dem Namen quickstart-generic-repo am Speicherort us-central1 mit der Beschreibung Generic repository zu erstellen:

    gcloud artifacts repositories create quickstart-generic-repo \
    --repository-format=generic \
    --location=us-central1 \
    --description="Generic repository"

  2. Führen Sie den folgenden Befehl aus, um zu prüfen, ob Ihr Repository erstellt wurde:

    gcloud artifacts repositories list

  3. Um die gcloud-Befehle zu vereinfachen, führen Sie die folgenden Befehle aus, um das Standard-Repository auf quickstart-generic-repo und den Standard-Speicherort auf us-central1 festzulegen.

    1. Führen Sie den folgenden Befehl aus, um das Standard-Repository auf quickstart-generic-repo festzulegen:

      gcloud config set artifacts/repository quickstart-generic-repo

    2. Führen Sie den folgenden Befehl aus, um den Standardspeicherort auf us-central1 festzulegen:

      gcloud config set artifacts/location us-central1

    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.

Artefakt in das Repository hochladen

  1. Erstellen Sie in Ihrem Basisverzeichnis eine Datei, die Sie in Ihr Repository hochladen möchten:

    echo "hello world" > hello.yaml

  2. Führen Sie den folgenden Befehl aus, um die Datei als Artefakt in das Repository hochzuladen:

    gcloud artifacts generic upload \
    --source=hello.yaml \
    --package=my-package \
    --version=1.0.0

    Wobei:

    • hello.yaml ist der Pfad der hochzuladenden Datei.
    • my-package ist das Paket, das hochgeladen werden soll.
    • 1.0.0 ist die Version des Artefakts. Sie können eine vorhandene Version im Repository nicht überschreiben.

Artefakte im Repository ansehen

So prüfen Sie, ob das Artefakt dem Repository hinzugefügt wurde:

gcloud artifacts files list

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

Im folgenden Beispiel ist hello.yaml die FILE_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

Allgemeines Artefakt herunterladen

Führen Sie den folgenden Befehl aus, um ein generisches Artefakt aus Ihrem Repository herunterzuladen:

gcloud artifacts generic download \
    --name=hello.yaml \
    --package=my-package \
    --version=1.0.0 \
    --destination=DESTINATION

Wobei:

  • hello.yaml ist der Name der Datei, die heruntergeladen werden soll.
  • my-package ist das Paket, das heruntergeladen werden soll.
  • 1.0.0 ist die Version des Artefakts.

Ersetzen Sie DESTINATION durch das Verzeichnis in Ihrem lokalen Dateisystem, in dem Sie den Download speichern möchten. Der Zielordner muss bereits vorhanden sein, da der Befehl sonst fehlschlägt.

Bereinigen

Damit Ihrem Google Cloud Konto die in dieser Anleitung verwendeten Ressourcen nicht in Rechnung gestellt werden, können Sie entweder das Projekt löschen, das die Ressourcen enthält, oder das Projekt beibehalten und das Repository löschen.

Projekt löschen

    Google Cloud -Projekt löschen:

    gcloud projects delete PROJECT_ID

Repository löschen

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

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

    gcloud artifacts repositories delete quickstart-generic-repo

  2. Wenn Sie die Einstellungen für das Standard-Repository und den Standard-Speicherort 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

Nächste Schritte