Andere Formate in Artifact Registry speichern

In generischen Artifact Registry-Repositories können Sie beliebige Dateien, Konfigurationen und benutzerdefinierte Binärdateien speichern und versionieren, die kein Standardpaketformat verwenden. In dieser Kurzanleitung erstellen Sie ein generisches Repository und laden eine YAML-Datei hoch.

Hinweis

  1. Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie einfach 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, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). 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, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). 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.

Generisches 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 und 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. Führen Sie die folgenden Befehle aus, um gcloud-Befehle zu vereinfachen, indem Sie das Standardrepository auf quickstart-generic-repo und den standardmäßigen Standort auf us-central1 festlegen.

    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 die Werte festgelegt wurden, müssen Sie sie nicht mehr in gcloud-Befehlen angeben, für die ein Repository oder ein 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

Wenn Sie prüfen möchten, ob Ihr Artefakt dem Repository hinzugefügt wurde, können Sie alle Artefakte mit dem folgenden Befehl auflisten:

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 Datei, die heruntergeladen werden soll.
  • my-package ist das Paket, das heruntergeladen werden muss.
  • 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

    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