Python-Pakete in Artifact Registry speichern

In dieser Kurzanleitung erfahren Sie, wie Sie ein privates Artifact Registry-Python-Repository einrichten, ein Paket hochladen und dann das Paket installieren.

Hinweise

  1. Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch 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. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  3. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

  4. Artifact Registry API aktivieren.

    Aktivieren Sie die API

    5.

  5. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  6. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

  7. Artifact Registry API aktivieren.

    Aktivieren Sie die API

    8.

Cloud Shell starten

In dieser Kurzanleitung verwenden Sie Cloud Shell, eine Shell-Umgebung zum Verwalten von Ressourcen, die in Google Cloud gehostet werden.

Die Google Cloud CLI und Python sind in Cloud Shell vorinstalliert. Die gcloud CLI bietet die primäre Befehlszeile für Google Cloud.

Cloud Shell aufrufen

  1. Rufen Sie die Google Cloud Console auf.

    Google Cloud Console

  2. Klicken Sie in der Symbolleiste der Google Cloud Console auf Cloud Shell aktivieren:

In einem Frame im unteren Teil der Console wird eine Cloud Shell-Sitzung geöffnet. Mit dieser Shell führen Sie gcloud-Befehle aus.

Erforderliche Pakete installieren

Twine ist ein Tool zum Veröffentlichen von Python-Paketen. Mit Twine laden Sie ein Paket in Artifact Registry hoch.

In dieser Kurzanleitung verwenden Sie die in Cloud Shell enthaltene Python-Installation. Diese Standardinstallation umfasst das Artifact Registry-Schlüsselbund-Back-End für die Authentifizierung mit Artifact Registry. Wenn Sie eine virtuelle Umgebung erstellen oder Python außerhalb von Cloud Shell einrichten, müssen Sie das Schlüsselbund-Back-End für die Authentifizierung installieren. Weitere Informationen finden Sie unter Mit Schlüsselbund authentifizieren.

Führen Sie den folgenden Befehl aus, um Twine zu installieren:

pip install twine

Sie können Artifact Registry jetzt einrichten.

Repository erstellen

Erstellen Sie das Repository für Ihre Pakete.

  1. Führen Sie den folgenden Befehl aus, um ein neues Python-Paket-Repository im aktuellen Projekt mit dem Namen quickstart-python-repo am Standort us-central1 zu erstellen.

    gcloud artifacts repositories create quickstart-python-repo \
    --repository-format=python \
    --location=us-central1 \
    --description="Python package 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, legen Sie für das Standard-Repository den Wert quickstart-python-repo und für den Standard-Speicherort us-central1 fest. 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.

    Um das Repository festzulegen, führen Sie folgenden Befehl aus:

    gcloud config set artifacts/repository quickstart-python-repo

    Führen Sie den folgenden Befehl aus, um den Standort festzulegen:

    gcloud config set artifacts/location us-central1

    Weitere Informationen zu diesen Befehlen finden Sie in der Dokumentation zu gcloud config set.

Authentifizierung konfigurieren

Das Artifact Registry-Schlüsselbund-Back-End sucht Ihre Anmeldedaten mithilfe der Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC), einer Strategie, die nach Anmeldedaten in Ihrer Umgebung sucht.

In dieser Kurzanleitung werden Sie:

  • Nutzeranmeldedaten für ADC generieren In einer Produktionsumgebung sollten Sie ein Dienstkonto verwenden und Anmeldedaten mit der Umgebungsvariablen GOOGLE_APPLICATION_CREDENTIALS angeben.
  • Fügen Sie die Artifact Registry-Repository-URL in die Befehle pip und twine ein, damit Sie pip und Twine nicht mit der Repository-URL konfigurieren müssen.

Führen Sie den folgenden Befehl aus, um Anmeldedaten für ADC zu generieren:

gcloud auth application-default login

Weitere Informationen zu Authentifizierungsmethoden und zum Hinzufügen von Repositories zur pip- und Twine-Konfiguration finden Sie unter Authentifizierung bei Python-Paket-Repositories einrichten.

Beispielpaket abrufen

Wenn Sie ein Python-Projekt erstellen, werden Distributionsdateien in einem dist-Unterverzeichnis in Ihrem Python-Projekt gespeichert. Laden Sie vorgefertigte Paketdateien herunter, um diese Kurzanleitung zu vereinfachen.

  1. Erstellen Sie einen Python-Projektordner mit dem Namen python-quickstart.

    mkdir python-quickstart

  2. Erstellen Sie ein Unterverzeichnis mit dem Namen dist und wechseln Sie dann zum Verzeichnis.

    mkdir python-quickstart/dist
cd python-quickstart/dist

  3. Laden Sie die Python-Beispielpakete herunter, die in der Anleitung Python-Projekte verpacken in der Anleitung zur Python-Paketerstellung verwendet werden.

    pip download sampleproject

    Mit dem Befehl werden das sampleproject-Paket und seine Abhängigkeit peppercorn heruntergeladen.

Paket in das Repository hochladen

Verwenden Sie Twine, um Ihre Pakete in Ihr Repository hochzuladen.

  1. Wechseln Sie vom Verzeichnis dist zum übergeordneten Verzeichnis python-quickstart.

    cd ..

  2. Laden Sie die Pakete aus Ihrem dist-Verzeichnis in das Repository hoch.

    python3 -m twine upload --repository-url https://us-central1-python.pkg.dev/PROJECT_ID/quickstart-python-repo/ dist/*

    Wenn Sie den Befehl mit python3 -m ausführen, sucht Python den Twine und führt den Befehl aus. Wenn sich der Befehl twine im Systempfad befindet, können Sie ihn ohne python3 -m ausführen.

Twine lädt sowohl sampleproject als auch peppercorn in Ihr Repository hoch.

Paket im Repository ansehen

Wenn Sie prüfen möchten, ob Ihr Paket hinzugefügt wurde, listen Sie die Pakete im Repository quickstart-python-repo auf.

Führen Sie dazu diesen Befehl aus:

gcloud artifacts packages list --repository=quickstart-python-repo

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

gcloud artifacts versions list --package=PACKAGE

Dabei ist PACKAGE die Paket-ID.

Paket installieren

Führen Sie den folgenden Befehl aus, um das Paket zu installieren:

pip install --index-url https://us-central1-python.pkg.dev/PROJECT_ID/quickstart-python-repo/simple/ sampleproject

Fehlerbehebung

Standardmäßig geben Tools wie „pip“ und „Twine“ keine detaillierten Fehlermeldungen zurück. Wenn ein Fehler auftritt, führen Sie den Befehl mit dem Flag --verbose noch einmal aus, um eine detailliertere Ausgabe zu erhalten. Weitere Informationen finden Sie unter Fehlerbehebung für Python-Pakete.

Bereinigen

Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud-Konto die auf dieser Seite verwendeten Ressourcen in Rechnung gestellt werden:

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

So löschen Sie das Repository:

  1. Führen Sie den folgenden Befehl aus, um das Repository quickstart-python-repo zu löschen:

    gcloud artifacts repositories delete quickstart-python-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