Veröffentlichen von Python-Paketen mit Azure Pipelines

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

Mithilfe von Azure Pipelines können Entwickler*innen Python-Pakete in Azure Artifacts-Feeds, öffentlichen Registrierungen veröffentlichen oder als Pipelineartefakte speichern. In diesem Artikel erfahren Sie, wie Sie:

• Installieren der erforderlichen Komponenten
• Eine Verbindung mit einem Azure Artifacts-Feed herstellen
• Veröffentlichen von Python-Paketen in einem Azure Artifacts-Feed

Voraussetzungen

• Ein Azure DevOps-organization und ein Projekt. Erstellen Sie ein organization oder ein Projekt, falls noch nicht geschehen.

• Ein Azure Artifacts-Feed. Erstellen Sie einen Feed , wenn Sie noch keinen haben.

Authentifizieren mit Azure Artifacts

Um mit twine Ihre Python-Pakete zu veröffentlichen, müssen Sie sich zuerst mit Ihrem Azure Artifacts-Feed authentifizieren. Die TwineAuthenticate-Aufgabe bietet Twine-Anmeldeinformationen in einer PYPIRC_PATH-Umgebungsvariablen. Diese Variable wird dann vontwine verwendet, um die Veröffentlichung Ihrer Pakete direkt aus Ihrer Pipeline zu erleichtern.

YAML

- task: TwineAuthenticate@1
  inputs:
    artifactFeed: <PROJECT_NAME/FEED_NAME>     ## For an organization-scoped feed, artifactFeed: <FEED_NAME>

Klassisch

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

2. Wählen Sie Pipelines, Ihre Pipelinedefinition und dann Bearbeiten aus.

3. Wählen Sie + aus, um eine neue Aufgabe hinzuzufügen. Suchen Sie nach der Aufgabe Python-Authentifizierung mit Twine-Upload, und wählen Sie dann Hinzufügen aus, um sie Ihrer Pipeline hinzuzufügen.

4. Wählen Sie Ihren Feed aus dem Dropdownmenü Mein Feedname aus, oder wählen Sie einen Feed aus externen Organisationen aus, wenn Sie sich mit einem Feed außerhalb Ihrer Organisation authentifizieren möchten.

   

Wichtig

Die in der Umgebungsvariablen PYPIRC_PATH gespeicherten Anmeldeinformationen ersetzen die Anmeldeinformationen in Ihren .ini- und .conf-Dateien.

Wenn Sie mehrere TwineAuthenticate-Aufgaben in verschiedenen Stages ihrer Pipeline hinzufügen, wird die vorhandene Umgebungsvariable PYPIRC_PATH durch jede zusätzliche Aufgabenausführung erweitert (nicht außer Kraft gesetzt).

Veröffentlichen von Python-Paketen in einem Azure Artifacts-Feed

YAML

- script: |
    pip install build
    pip install twine
  displayName: 'Install build and twine'

- script: |
    python -m build -w
  displayName: 'Python build'

- task: TwineAuthenticate@1
  inputs:
    artifactFeed: <PROJECT_NAME/FEED_NAME>
  displayName: 'Twine Authenticate'

- script: |
    python -m twine upload -r <FEED_NAME> --config-file $(PYPIRC_PATH) dist/*.whl
  displayName: 'Upload to feed'

Klassisch

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

2. Wählen Sie Pipelines, Ihre Pipelinedefinition und dann Bearbeiten aus.

3. Wählen Sie + aus, um eine neue Aufgabe hinzuzufügen. Suchen Sie nach der Aufgabe Python-Version verwenden, und wählen Sie dann Hinzufügen aus, um sie Ihrer Pipeline hinzuzufügen. In diesem Beispiel legen wir die Versionsspezifikation auf >= 3,7 fest.

4. Wählen Sie + aus, um eine neue Aufgabe hinzuzufügen. Suchen Sie nach der Aufgabe Befehlszeile, und wählen Sie dann Hinzufügen aus, um sie Ihrer Pipeline hinzuzufügen. Fügen Sie die folgenden Befehle in das Textfeld Skript ein, um Build und Twine auf Ihrem Agent zu installieren:

   pip install build
   pip install twine
   

5. Wählen Sie + aus, um eine neue Aufgabe hinzuzufügen. Suchen Sie nach der Aufgabe Befehlszeile, und wählen Sie dann Hinzufügen aus, um sie Ihrer Pipeline hinzuzufügen. Fügen Sie den folgenden Befehl in das Textfeld Skript ein, um Ihr Projekt zu erstellen:

   python -m build -w
   

6. Wählen Sie + aus, um eine neue Aufgabe hinzuzufügen. Suchen Sie nach der Aufgabe Twine-Authentifizierung, und wählen Sie dann Hinzufügen aus, um sie Ihrer Pipeline hinzuzufügen. Wählen Sie Ihren Feed im Dropdownmenü die Option Mein Feedname aus.

7. Wählen Sie + aus, um eine neue Aufgabe hinzuzufügen. Suchen Sie nach der Aufgabe Befehlszeile, und wählen Sie dann Hinzufügen aus, um sie Ihrer Pipeline hinzuzufügen. Fügen Sie den folgenden Befehl in das Textfeld Skript ein, um Ihr Paket in Ihrem Feed zu veröffentlichen, und ersetzen Sie den Platzhalter durch Ihren Feednamen:

   python -m twine upload -r <FEED_NAME> --config-file $(PYPIRC_PATH) dist/*.whl
   

   

Hinweis

Um Ihre Pakete mithilfe von Azure Pipelines in einem Feed zu veröffentlichen, muss sowohl demBuilddienst für die Projektsammlung als auch den Builddienstidentitäten Ihres Projekts in Ihren Feedeinstellungen die Rolle Feedherausgeber (Mitwirkender) zugewiesen sein. Details finden Sie unter Verwalten von Berechtigungen.

Verwandte Artikel

• Veröffentlichen und Herunterladen von Python-Paket-CLI
• Suchen nach Paketen in Upstream Quellen
• Konfigurieren von Berechtigungen