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
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Artifact Registry API aktivieren.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Artifact Registry API aktivieren.
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
Rufen Sie die Google Cloud Console auf.
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.
Führen Sie den folgenden Befehl aus, um ein neues Python-Paket-Repository im aktuellen Projekt mit dem Namen
quickstart-python-repo
am Standortus-central1
zu erstellen.gcloud artifacts repositories create quickstart-python-repo \ --repository-format=python \ --location=us-central1 \ --description="Python package repository"
Führen Sie den folgenden Befehl aus, um zu prüfen, ob Ihr Repository erstellt wurde:
gcloud artifacts repositories list
Um die
gcloud
-Befehle zu vereinfachen, legen Sie für das Standard-Repository den Wertquickstart-python-repo
und für den Standard-Speicherortus-central1
fest. Nachdem Sie die Werte festgelegt haben, müssen Sie diese nicht mehr ingcloud
-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
undtwine
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.
Erstellen Sie einen Python-Projektordner mit dem Namen
python-quickstart
.mkdir python-quickstart
Erstellen Sie ein Unterverzeichnis mit dem Namen
dist
und wechseln Sie dann zum Verzeichnis.mkdir python-quickstart/dist cd python-quickstart/dist
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ängigkeitpeppercorn
heruntergeladen.
Paket in das Repository hochladen
Verwenden Sie Twine, um Ihre Pakete in Ihr Repository hochzuladen.
Wechseln Sie vom Verzeichnis
dist
zum übergeordneten Verzeichnispython-quickstart
.cd ..
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 Befehltwine
im Systempfad befindet, können Sie ihn ohnepython3 -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:
Führen Sie den folgenden Befehl aus, um das Repository
quickstart-python-repo
zu löschen:gcloud artifacts repositories delete quickstart-python-repo
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
- Authentifizierung konfigurieren
- Repositories verwalten
- Pakete verwalten
- Lesen Sie unser Infomaterial zu DevOps und informieren Sie sich über unser Forschungsprogramm.