Conda-Pakete verwalten

Nachdem Sie ein Conda-Repository in Artifact Registry erstellt haben, können Sie Conda-Pakete in Ihrem neuen Repository installieren. Auf dieser Seite wird beschrieben, wie Sie Ihre Conda-Pakete installieren, ansehen und löschen.

Hinweis

  1. Installieren und initialisieren Sie die Google Cloud CLI.

    Für die Ausführung von Befehlen für Conda-Repositories ist die Google Cloud CLI-Version 354.0.0 oder höher erforderlich. Sie können die Version mit dem folgenden Befehl prüfen:

    gcloud version

  2. Wenn Sie die Conda-Befehlszeile in Ihrer Google Cloud -Umgebung verwenden möchten, installieren Sie einen der folgenden Conda-Paketmanager:

  3. Wenn Sie kein Conda-Repository in Artifact Registry haben, erstellen Sie ein Conda-Paket-Repository.

  4. (Optional) Standardwerte für gcloud-Befehle festlegen.

Artifact Registry unterstützt Standard- und Remote-Conda-Repositories. Sie können eine der folgenden Adressen für Ihre Remote-Repositories verwenden.

  • https://repo.anaconda.com/pkgs/main
  • https://repo.anaconda.com/pkgs/r
  • https://repo.anaconda.com/pkgs/msys2
  • https://conda.anaconda.org/conda-forge
  • https://conda.anaconda.org/bioconda

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Repository zuzuweisen, damit Sie die nötigen Berechtigungen zum Verwalten von Conda-Paketen haben:

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.

Conda-Pakete verwalten

Nachdem Sie Ihrem Artifact Registry-Repository ein Conda-Paket hinzugefügt haben, können Sie das Paket in Ihrer Conda-Umgebung installieren und mit Google CloudDetails zum Paket aufrufen.

Pakete einem Artifact Registry-Repository hinzufügen

Führen Sie den folgenden Befehl aus, um Ihrem Artifact Registry-Repository ein Conda-Paket hinzuzufügen:

gcloud artifacts files upload \
    --source=PACKAGE_NAME \
    --repository=REPO_NAME\
    --project=PROJECT \
    --location=LOCATION

Wobei:

  • REPO_NAME ist die ID des Repositorys.
  • PROJECT ist die ID des Projekts, das das Repository enthält.
  • LOCATION ist der regionale oder multiregionale Standort für das Repository.

So fügen Sie mehrere Pakete gleichzeitig hinzu:

gcloud artifacts files upload \
    --source-directory=DIRECTORY \
    --repository=REPO_NAME\
    --project=PROJECT \
    --location=LOCATION

Wobei:

  • DIRECTORY ist die Adresse eines lokalen Ordners, der Ihre Conda-Pakete enthält.

Pakete installieren

Repository-Modi:Standard, Remote

Führen Sie den folgenden Befehl aus, um die aktuelle stabile Version eines Pakets in Ihrer Conda-Umgebung zu installieren:

Conda

conda install -n ENVIRONMENT_NAME PACKAGE_NAME

Miniforge

conda install -n ENVIRONMENT_NAME PACKAGE_NAME

Mamba

mamba install -n ENVIRONMENT_NAME PACKAGE_NAME

Micromamba

micromamba install -n ENVIRONMENT_NAME PACKAGE_NAME

Wobei:

  • ENVIRONMENT_NAME ist der Name Ihrer Conda-Umgebung. Wenn Sie bereits eine Umgebung aktiviert haben und das Paket direkt in der Umgebung installieren, können Sie -n ENVIRONMENT_NAME weglassen.

  • PACKAGE_NAME ist der Name Ihres Conda-Pakets.

    Wenn Sie eine bestimmte Version eines Pakets in Ihrer Conda-Umgebung installieren möchten, fügen Sie VERSION nach dem Paketnamen ein.

Bei Standard-Repositories laden Sie ein Paket direkt aus dem Repository herunter.

Bei einem Remote-Repository laden Sie eine im Cache gespeicherte Kopie des Pakets und seiner Abhängigkeiten herunter. Wenn keine Kopie im Cache vorhanden ist, lädt das Remote-Repository das Paket von der Upstream-Quelle herunter und speichert es im Cache, bevor es an Sie gesendet wird. Sie können prüfen, ob das Remote-Repository die Pakete aus der Upstream-Quelle abgerufen hat, indem Sie die Liste der Pakete im Repository aufrufen.

Pakete und Versionen ansehen

Repository-Modi:Standard, Remote

So rufen Sie die Pakete und Paketversionen mit der Google Cloud console oder gcloudab:

Console

  1. Öffnen Sie in der Google Cloud console die Seite Repositories.

    Zur Seite „Repositories“

  2. Klicken Sie in der Liste der Repositories auf das entsprechende Repository.

    Auf der Seite Pakete sind die Pakete des Repositorys aufgeführt.

  3. 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:

  • REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.
  • LOCATION ist der regionale oder multiregionale Speicherort für das Repository. 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:

  • PACKAGE ist die ID des Pakets oder die voll qualifizierte Kennzeichnung für das Paket.
  • REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.
  • LOCATION ist der regionale oder multiregionale Speicherort für das Repository. 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.

Bei Remote-Repositories enthält die zurückgegebene Liste nur zwischengespeicherte Pakete.

Dateien auflisten

Repository-Modi:Standard, Remote

Bei Remote-Repositories enthält die zurückgegebene Liste nur im Cache gespeicherte Conda-Pakete und Indexdateien.

Sie können Dateien in einem Repository, Dateien in allen Versionen eines angegebenen Pakets oder Dateien in einer bestimmten Version eines Pakets auflisten.

Für alle folgenden Befehle können Sie eine maximale Anzahl von zurückzugebenden Dateien festlegen, indem Sie dem Befehl das Flag --limit hinzufügen.

So listen Sie alle Dateien im Standardprojekt, im Standard-Repository und am Standard-Speicherort auf, wenn die Standardwerte konfiguriert sind:

gcloud artifacts files list

Führen Sie den folgenden Befehl aus, um Dateien in einem angegebenen Projekt, Repository und Speicherort aufzulisten:

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

So listen Sie Dateien für alle Versionen eines bestimmten Pakets auf:

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

So listen Sie Dateien für eine bestimmte Paketversion auf:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --version=VERSION

Ersetzen Sie die folgenden Werte:

  • LOCATION: der regionale oder multiregionale Speicherort für das Repository.
  • PROJECT: Ihre Google Cloud Projekt-ID. Wenn die Projekt-ID einen Doppelpunkt (:) enthält, finden Sie weitere Informationen unter Auf Domains beschränkte Projekte.
  • REPOSITORY: der Name des Repositorys, in dem das Image gespeichert ist.
  • PACKAGE: der Name des Pakets.
  • VERSION: die Version des Pakets.

Beispiele

Beachten Sie die folgenden Paketinformationen:

  • Projekt: my-project
  • Repository: my-repo
  • Speicherort des Repositorys: us-west1
  • Paket: my-app

Mit dem folgenden Befehl werden alle Dateien im Repository my-repo am Speicherort us-west1 im Standardprojekt aufgelistet:

gcloud artifacts files list \
    --location=us-west1 \
    --repository=my-repo
Mit dem folgenden Befehl werden die Dateien in Version 1.0 des Pakets aufgelistet.

gcloud artifacts files list \
    --project=my-project \
    --location=us-west1 \
    --repository=my-repo \
    --package=my-app \
    --version=1.0

Pakete und Versionen löschen

Repository-Modi:Standard, Remote

Sie können ein Paket und alle seine Versionen oder eine bestimmte Version löschen. Gelöschte Pakete können nicht wiederhergestellt werden.

Bevor Sie ein Paket oder eine Paketversion löschen, prüfen Sie, ob Sie alle wichtigen Abhängigkeiten davon kommuniziert oder behoben haben.

So löschen Sie ein Paket:

Console

  1. Öffnen Sie in der Google Cloud console die Seite Repositories.

    Zur Seite „Repositories“

  2. Klicken Sie in der Liste der Repositories auf das entsprechende Repository.

    Auf der Seite Pakete sind die Pakete des Repositorys aufgeführt.

  3. Wählen Sie das Paket aus, das Sie löschen möchten.

  4. Klicken Sie auf Löschen.

  5. Klicken Sie im Bestätigungsdialogfeld auf Löschen.

gcloud

Führen Sie dazu diesen Befehl aus:

gcloud artifacts packages delete PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] [--async]

Ersetzen Sie Folgendes:

  • PACKAGE ist der Name des Pakets im Repository.
  • REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.
  • LOCATION ist der regionale oder multiregionale Standort des Repositorys. Verwenden Sie dieses Flag, um Repositories an einem bestimmten Speicherort aufzurufen. Wenn Sie einen Standardstandort konfiguriert haben, wird bei Weglassen dieses Flags dieser Standardwert verwendet.

Das Flag --async bewirkt, dass der Befehl sofort zurückgegeben wird, ohne auf den Abschluss des Vorgangs zu warten.

So löschen Sie Versionen eines Pakets:

Console

  1. Öffnen Sie in der Google Cloud console die Seite Repositories.

    Zur Seite „Repositories“

  2. Klicken Sie in der Liste der Repositories auf das entsprechende Repository.

    Auf der Seite Pakete sind die Pakete des Repositorys aufgeführt.

  3. Klicken Sie auf das Paket, um die Versionen des Pakets aufzurufen.

  4. Wählen Sie die Versionen aus, die Sie löschen möchten.

  5. Klicken Sie auf Löschen.

  6. Klicken Sie im Bestätigungsdialogfeld auf Löschen.

gcloud

Führen Sie dazu diesen Befehl aus:

gcloud artifacts versions delete VERSION \
    --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] \
    [--async]

Ersetzen Sie Folgendes:

  • VERSION ist der Name der zu löschenden Version.
  • PACKAGE ist der Name des Pakets im Repository.
  • REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.
  • LOCATION ist der regionale oder multiregionale Standort des Repositorys. Verwenden Sie dieses Flag, um Repositories an einem bestimmten Speicherort aufzurufen. Wenn Sie einen Standardstandort konfiguriert haben, wird bei Weglassen dieses Flags dieser Standardwert verwendet.

Das Flag --async bewirkt, dass der Befehl sofort zurückgegeben wird, ohne auf den Abschluss des Vorgangs zu warten.

Bei Remote-Repositories löscht Artifact Registry die Caching-Daten für die ausgewählten Pakete, einschließlich Paketversionen und Dateien.

Nächste Schritte