Freigeben über


Schnellstart: Veröffentlichen und Nutzen von Python-Paketen mit Azure Artifacts mithilfe der Befehlszeile (CLI)

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

In dieser Schnellstartanleitung erfahren Sie, wie Sie einen Azure Artifacts-Feed erstellen und Ihren Feed verwenden, um Python-Pakete über die Befehlszeile in Ihrer lokalen Entwicklungsumgebung zu veröffentlichen und zu nutzen. Wenn Sie fertig sind, haben Sie ein Python-Paket in Ihrem Feed veröffentlicht und von Ihrem Feed in Ihre lokale Entwicklungsumgebung installiert.

Informationen zum Veröffentlichen und Nutzen von Paketen in Ihren Azure-Pipelines finden Sie unter Veröffentlichen von Python-Paketen mit Azure-Pipelines.

Voraussetzungen

Um die folgenden Schritte auszuführen, müssen Sie folgendes haben:

  • Eine Azure DevOps-Organisation. Erstellen Sie ein kostenloses Konto.
  • Ein persönliches Zugriffstoken (PAT) mit Verpackungslesebereich>. Informationen zum Erstellen finden Sie unter "Erstellen eines PAT".
  • Ein Azure DevOps-Projekt. Wenn Sie kein Projekt haben, erstellen Sie ein Projekt.
  • Python 3.8 oder höher auf Ihrem lokalen Computer installiert. Laden Sie Python hier herunter.
  • Pip 19.2 und Twine 1.13.0 oder höher.
  • Ein Python-Paket, das von Ihrem lokalen Computer in Ihrem Feed veröffentlicht werden soll.
  • Bei Verwendung des Python-Beispielpakets:
    • Ein GitHub-Konto. Sofern nicht bereits geschehen, können Sie ein kostenloses GitHub-Konto erstellen.
    • git installed on your local machine.
  • Ein GitHub-Konto. Sofern nicht bereits geschehen, können Sie ein kostenloses GitHub-Konto erstellen.
  • Zugriff auf eine Azure DevOps Server-Sammlung.
  • Ein persönliches Zugriffstoken (PAT) mit Verpackungslesebereich>. Informationen zum Erstellen finden Sie unter "Erstellen eines PAT".
  • Ein Azure DevOps-Projekt. Wenn Sie kein Projekt haben, erstellen Sie ein Projekt.
  • Python 3.8 oder höher in Ihrer lokalen Entwicklungsumgebung installiert.
  • Pip 19.2 und Twine 1.13.0 oder höher.
  • Bei Verwendung des Python-Beispielpakets:
    • Ein GitHub-Konto. Sofern nicht bereits geschehen, können Sie ein kostenloses GitHub-Konto erstellen.
    • git installed on your local machine.

Erstellen eines lokalen Python-Pakets

Sie benötigen ein Python-Paket, um sie in Ihrem Feed zu veröffentlichen. Wenn Sie kein Paket zum Veröffentlichen haben, können Sie ein Python-Beispielpaket von GitHub klonen.

Klonen des Python-Beispielpakets

Führen Sie die folgenden Schritte aus, um das Python-Beispielpaket von GitHub zu verwenden.

  1. Wechseln Sie zum folgenden GitHub-Repository:

    https://github.com/microsoft/python-package-template
    
  2. Fork des Repositorys zu Ihrem GitHub-Konto

  3. Wechseln Sie zu Ihrem Verzweigungs-Repository, und wählen Sie "Code" aus.

  4. Kopieren Sie die URL Ihres Verzweigungs-Repositorys.

  5. Klonen Sie von einer CLI auf Ihrem lokalen Computer das Repository mit dem folgenden Befehl unter Verwendung der URL, die Sie aus Ihrem Verzweigungs-Repository kopiert haben:

    git clone <REPOSITORY_URL>
    
  6. Ändern Sie das Verzeichnis in das geklonte Repository.

    cd python-package-template
    

Erstellen Des Pakets

Führen Sie zum Erstellen des Rads und der Quellverteilung die folgenden Befehle in Ihrem Projektverzeichnis aus:

pip install --upgrade build
python -m build

Wenn Ihr Python-Projekt über eine setup.py Datei verfügt, können Sie den folgenden Befehl verwenden, um Ihr Paket zu erstellen:

python setup.py sdist bdist_wheel

Einen Feed erstellen

  1. Melden Sie sich bei Ihrer Azure DevOps-Organisation an, und wechseln Sie dann zu Ihrem Projekt.

  2. Wählen Sie Artefakte und dann Ihren Feed erstellen aus.

    A screenshot showing how to create a feed.

  3. Geben Sie die folgenden Informationen für Ihren Feed ein:

    1. Geben Sie einen beschreibenden Namen für Ihren Feed ein.
    2. Definieren Sie die Sichtbarkeit (die angibt, wer Pakete innerhalb des Feeds anzeigen kann).
    3. Wählen Sie aus, ob Pakete aus öffentlichen Quellen wie pypi.org verwendet werden sollen.
    4. Geben Sie den Bereich Ihres Feeds an.
  4. Klicken Sie auf Erstellen.

  1. Wechseln Sie zu Ihrer Azure DevOps-Sammlung, wählen Sie Ihr Projekt aus.

  2. Wählen Sie Artefakte und dann Ihren Feed erstellen aus.

    A screenshot showing how to create a feed in DevOps Server.

  3. Geben Sie die folgenden Informationen für Ihren Feed ein:

    1. Geben Sie einen beschreibenden Namen für Ihren Feed ein.
    2. Definieren Sie die Sichtbarkeit (die angibt, wer Pakete innerhalb des Feeds anzeigen kann).
    3. Wählen Sie aus, ob Pakete aus öffentlichen Quellen wie pypi.org verwendet werden sollen.
    4. Geben Sie den Bereich Ihres Feeds an.
  4. Klicken Sie auf Erstellen.

  1. Wechseln Sie zu Ihrer Azure DevOps-Sammlung, wählen Sie Ihr Projekt aus.

  2. Wählen Sie Artefakte und dann "Feed erstellen" aus, um einen neuen Feed zu erstellen.

  3. Geben Sie die folgenden Informationen für Ihren Feed ein:

    1. Geben Sie einen beschreibenden Namen für Ihren Feed ein.
    2. Definieren Sie die Sichtbarkeit (die angibt, wer Pakete innerhalb des Feeds anzeigen kann).
    3. Wählen Sie aus, ob Pakete aus öffentlichen Quellen wie pypi.org verwendet werden sollen.
    4. Geben Sie den Bereich Ihres Feeds an.
  4. Klicken Sie auf Erstellen.

  1. Wechseln Sie zu Ihrer Azure DevOps-Sammlung, wählen Sie Ihr Projekt aus.

  2. Wählen Sie Artefakte und dann "Feed erstellen" aus, um einen neuen Feed zu erstellen.

  3. Geben Sie die folgenden Informationen für Ihren Feed ein:

    1. Geben Sie einen beschreibenden Namen für Ihren Feed ein.
    2. Definieren Sie die Sichtbarkeit (die angibt, wer Pakete innerhalb des Feeds anzeigen kann).
    3. Wählen Sie aus, ob Pakete aus öffentlichen Quellen wie pypi.org verwendet werden sollen.
  4. Klicken Sie auf Erstellen.

Veröffentlichen Ihres Pakets in Ihrem Feed

Verwenden Sie Twine, um Ihr Paket in Ihren Azure Artifacts-Feed hochzuladen.

  1. Wechseln Sie zu Ihrem Azure DevOps-Projekt, und wählen Sie Artefakte aus.

  2. Wählen Sie Ihren Feed aus, und wählen Sie Verbinden zum Feed aus.

    A screenshot highlighting the connect to feed.

  3. Wählen Sie "Twine " unter dem Abschnitt "Python " aus.

    A screenshot highlighting the twine package type.

  4. Stellen Sie auf Ihrem Entwicklungscomputer sicher, dass Twine installiert ist.

    pip install --upgrade twine
    
  5. Befolgen Sie die Anweisungen im Abschnitt "Project-Setup ", um Die .pypirc Datei einzurichten.

    A screenshot highlighting the `.pyirc` content.

  6. Um zu vermeiden, dass Sie jedes Mal, wenn Sie ein Paket veröffentlichen, Ihr persönliches Zugriffstoken eingeben müssen, können Sie ihre Anmeldeinformationen zur .pypirc Datei hinzufügen. Stellen Sie sicher, dass Sie Ihr persönliches Zugriffstoken nicht in einem öffentliches Repository überprüfen.

    Beispiel für eine .pypirc Datei mit Anmeldeinformationen:

    [distutils]
    Index-servers =
        <FEED_NAME>
    
    [<FEED_NAME>]
    Repository = <FEED_URL>
    username = <FEED_NAME>
    password = <YOUR_PERSONAL_ACCESS_TOKEN>
    
  7. Führen Sie zum Hochladen des Pakets den folgenden Befehl in Ihrem Projektverzeichnis aus, indem <Sie FEED_NAME> durch Ihren Feednamen ersetzen. Unter Windows müssen Sie möglicherweise den .pypirc Dateispeicherort mit dem --config-file Argument angeben.

    twine upload --repository <FEED_NAME> dist/*
    

Installieren eines Pakets aus Ihrem Feed

  1. Wechseln Sie zu Ihrem Azure DevOps-Projekt, und wählen Sie Artefakte aus.

  2. Wählen Sie Ihren Feed aus, und wählen Sie Verbinden zum Feed aus.

    A screenshot highlighting the connect to feed button.

  3. Wählen Sie "Pip" unter dem Abschnitt "Python" aus.

    A screenshot highlighting the pip package type.

  4. Bereiten Sie Ihre lokale Python-Umgebung vor.

    1. Stellen Sie sicher, dass Pip installiert ist und auf dem neuesten Stand ist:

      python -m pip install --upgrade pip
      
    2. Erstellen und Aktivieren einer virtuellen Python-Umgebung:

      python -m venv myenv
      myenv/Scripts/activate
      
  5. Fügen Sie dem Stammverzeichnis Ihrer virtuellen Umgebung eine pip.ini (Windows) oder eine Pip.conf-Datei (Mac/Linux) hinzu. Kopieren Sie den Inhalt aus dem Abschnitt "Project-Setup" des Verbinden zum Feeddialogfeld, und fügen Sie ihn ihrer datei pip.ini oder pip.conf hinzu.

    A screenshot highlighting the pip.ini file content.

  6. Um zu vermeiden, dass Sie jedes Mal, wenn Sie ein Paket aus Ihrem Feed installieren, Ihr persönliches Zugriffstoken eingeben müssen, können Sie Ihre Anmeldeinformationen zur Datei pip.ini oder pip.conf hinzufügen. Stellen Sie sicher, dass Sie Ihr persönliches Zugriffstoken nicht in einem öffentliches Repository überprüfen.

    Beispiel für eine pip.ini - oder pip.conf-Datei mit Anmeldeinformationen:

    [global]
    extra-index-url=https://<FEED_NAME>:<YOUR_PERSONAL_ACCESS_TOKEN>@<FEED_URL>
    
  7. Führen Sie zum Installieren des Pakets den folgenden Befehl aus, indem Sie PACKAGE_NAME> durch den Paketnamen aus Ihrem Feed ersetzen<.

    pip install <PACKAGE_NAME>
    

Bereinigen von Ressourcen

Wenn Sie mit den von Ihnen erstellten Ressourcen fertig sind, können Sie sie löschen, um Gebühren zu vermeiden. Wenn Sie ein Projekt löschen, werden alle Feeds auf Projektebene gelöscht.

So löschen Sie ein Projekt:

  1. Klicken auf Project Settings (Projekteinstellungen).
  2. Wählen Sie auf der Seite " Projektdetails " die Option "Löschen" am unteren Rand der Seite aus.
  3. Geben Sie den Namen des zu bestätigenden Projekts ein, und wählen Sie dann "Löschen" aus.

Wenn Sie nur den Feed löschen möchten:

  1. Wählen Sie Artefakte aus, und wählen Sie Ihren Feed aus dem Dropdownmenü aus.
  2. Wählen Sie die Schaltfläche "Einstellungen" aus.
  3. Wählen Sie auf der Registerkarte "Feedeinstellungen " die Option "Feed löschen" aus.
  4. Wählen Sie zur Bestätigung Löschen aus.

So sauber Sie Ihre lokale Entwicklungsumgebung auf:

  1. Führen Sie den folgenden Befehl aus, um Ihre virtuelle Umgebung zu deaktivieren:

    deactivate
    
  2. Um Ihre virtuelle Umgebung zu löschen, löschen Sie das Verzeichnis, in dem sie erstellt wurde.

  3. Entfernen Sie die .pypirc Datei aus Ihrem Startverzeichnis.

Wenn Sie das Python-Beispielpaket geklont haben, können Sie das Repository von Ihrem lokalen Computer und Ihrem GitHub-Konto löschen.

Nächste Schritte