Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Python-Pakete verwalten

Auf dieser Seite wird beschrieben, wie Sie Python-Pakete und -Paketversionen hinzufügen, anzeigen und löschen.

Die Paketverwaltung befindet sich in der Alphaphase. Sie ist nur für Alphanutzer verfügbar und umfasst möglicherweise nicht alle Features der Containerverwaltung. Wenn Sie sich für die Alphaversion anmelden möchten, füllen Sie das Anmeldeformular aus. Weitere Informationen finden Sie unter Voraussetzungen für den Zugriff auf Alphafunktionen.

Hinweis

  1. Prüfen Sie, ob Sie die Artifact Registry API aktiviert und Cloud SDK installiert haben. Anleitungen finden Sie unter Dienst aktivieren und deaktivieren.

    Zum Ausführen von Befehlen für PyPI-Repositories ist die gcloud-Befehlszeilenversion 329.0.0 erforderlich. Sie können die Version mit dem folgenden Befehl prüfen:

    gcloud version
    
  2. Erstellen Sie ein neues PyPI-Repository, wenn das Ziel-Repository nicht vorhanden ist.

  3. Prüfen Sie, ob Python 3 installiert ist. Eine Installationsanleitung finden Sie in der Google Cloud-Anleitung zum Einrichten von Python.

  4. (Optional) Konfigurieren Sie die Standardeinstellungen für gcloud-Befehle.

  5. Wenn Sie die Schlüsselauthentifizierung mit gcloud-Anmeldedaten verwenden, melden Sie sich mit Ihrem Nutzerkonto oder Dienstkonto in Cloud SDK an.

Pakete hinzufügen

Erforderliche Berechtigungen: Artifact Registry-Autor

Wenn Sie ein Python-Projekt erstellen, werden Pakete in einem dist-Unterverzeichnis in Ihrem Projekt gespeichert. Sie können dann Twine verwenden, um Pakete in das Repository hochzuladen. Es wird empfohlen, eindeutige Namen für Ihre privaten Pakete zu verwenden, die nicht mit denen von pypi.org übereinstimmen, insbesondere wenn Ihre pip-Konfiguration mehrere Paketindexe enthält.

  1. Installieren Sie Twine.

    pip install twine
    
  2. Rufen Sie das Python-Projektverzeichnis auf.

  3. Laden Sie die Pakete aus dem Unterverzeichnis dist des Projekts in das Repository hoch. Führen Sie dazu diesen Befehl aus:

    twine upload dist/*
    

    Sie können ein bestimmtes Repository mit dem Flag --repository-url angeben.

    twine upload --repository-url https://LOCATION-pypi.pkg.dev/PROJECT/REPOSITORY/ dist/*
    

Pakete und Versionen ansehen

Erforderliche Berechtigungen: Artifact Registry-Leser

So rufen Sie die Pakete und Paketversionen mit der Google Cloud Console oder gcloud ab:

Console

  1. Öffnen Sie in der 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]

Wo

  • REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.
  • LOCATION ist ein regionaler oder multiregionaler Speicherort. 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.

Um die Versionen für ein Paket aufzurufen, führen Sie folgenden Befehl aus:

gcloud artifacts versions list --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION]

Wo

  • PACKAGE ist die ID des Pakets oder die vollqualifizierte 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 ein regionaler oder multiregionaler Speicherort. 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.

Pakete und Versionen löschen

Erforderliche Berechtigungen: Artifact Registry-Repository-Administrator

So löschen Sie ein Paket:

Console

  1. Öffnen Sie in der 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 folgenden Befehl aus:

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

Wo

  • 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 ein regionaler oder multiregionaler Speicherort. 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.
  • --async wird sofort zurückgegeben, ohne auf den Abschluss des Vorgangs zu warten.

So löschen Sie Versionen eines Pakets:

Console

  1. Öffnen Sie in der 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 folgenden Befehl aus:

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

Wo

  • 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 ein regionaler oder multiregionaler Speicherort. 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.
  • --async wird sofort zurückgegeben, ohne auf den Abschluss des Vorgangs zu warten.

Pakete herunterladen

Erforderliche Berechtigungen: Artifact Registry-Leser

Verwenden Sie den Befehl pip, um Pakete aus dem Repository zu installieren.

Führen Sie dazu diesen Befehl aus:

pip install PACKAGE

Wenn Sie kein Repository angeben, bestimmt die pip-Konfiguration in pip.conf, wie pip nach dem Paket sucht.

  • Wenn Sie das Artifact Registry-Repository mit der Einstellung index-url konfiguriert haben und keine anderen Paketindexe konfiguriert sind, sucht pip nur in Ihrem Artifact Registry-Repository nach dem Paket.
  • Wenn Sie das Repository mit der Einstellung extra-index-url konfiguriert oder mehrere Paketindexe konfiguriert haben, sucht pip nach pypi.org und allen anderen konfigurierten Paketindexen und wählt das neueste Version des Pakets.

Alternativ können Sie das Repository für die Suche angeben, indem Sie dem Befehl das Flag --index-url hinzufügen.

pip install --index-url https://LOCATION-pypi.pkg.dev/PROJECT/REPOSITORY/simple/ PACKAGE

Nächste Schritte