Andere Formate in Artifact Registry speichern

Hier erfahren Sie, wie Sie ein Repository im generischen Format für Artifact Registry einrichten und eine YAML-Datei hochladen.

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 Artifact Registry Administrator (roles/artifactregistry.admin) IAM-Rolle für Ihr Projekt zu erteilen, um die Berechtigungen zu erhalten, die Sie zum Erstellen und Verwalten von Paket-Repositories in Artifact Registry 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.

Generisches Repository erstellen

  1. Führen Sie den folgenden Befehl aus, um ein Repository im generischen Format mit dem Namen quickstart-generic-repo am Standort us-central1 und 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 gcloud-Befehle zu vereinfachen, führen Sie die folgenden Befehle aus, um das Standard-Repository auf quickstart-generic-repo und den standardmäßigen Standort 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 standardmäßigen Standort 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 hochzuladende Paket.
    • 1.0.0 ist die Version des Artefakts. Eine vorhandene Version im Repository kann nicht überschrieben werden.

Artefakte im Repository ansehen

Führen Sie den folgenden Befehl aus, um alle Artefakte aufzulisten und zu prüfen, ob Ihr 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 der 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

Generisches 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 herunterzuladenden Datei.
  • my-package ist das herunterzuladende Paket.
  • 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, sonst schlägt der Befehl fehl.

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

    So löschen Sie ein Google Cloud Projekt:

    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. Führen Sie den folgenden Befehl aus, um das Repository quickstart-generic-repo zu löschen:

    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