Publish Python packages with Azure Pipelines

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

Azure Pipelines enables developers to publish Python packages to Azure Artifacts feeds and public registries such as PyPi. This article will guide you through how to publish Python packages to your Azure Artifacts feed.

Prerequisites

• An Azure DevOps organization and a project. Create an organization or a project if you haven't already.

• An Azure Artifacts feed. Create a feed if you don't have one already.

Authenticate with a feed

To publish Python packages using twine, you must first authenticate with your Azure Artifacts feed. The TwineAuthenticate task provides twine credentials to a PYPIRC_PATH environment variable. This variable is then used bytwine to publish packages directly from your pipeline.

Important

The credentials stored in the PYPIRC_PATH environment variable take precedence over those in the .ini and .conf files.

If you add multiple TwineAuthenticate tasks at different stages in your pipeline, each task execution will extend (not override) the existing PYPIRC_PATH environment variable.

YAML

1. Sign in to your Azure DevOps organization, and then navigate to your project.

2. Select Pipelines, and then select your pipeline definition.

3. Select Edit, and then add the following snippet to your YAML pipeline.

   YAML

   steps:
   - task: UsePythonVersion@0
     displayName: 'Use Python 3.x'
   
   - task: TwineAuthenticate@1
     inputs:
       artifactFeed: <PROJECT_NAME/FEED_NAME>     ## For an organization-scoped feed, use: artifactFeed: <FEED_NAME>
   

Classic

1. Sign in to your Azure DevOps organization, and then navigate to your project.

2. Select Pipelines, select your pipeline definition, and then select Edit.

3. Select the + sign to add a new task, then add the Use Python version and the Python twine upload authenticate tasks to your pipeline definition. You can leave the UsePythonVersion@0 task with the default settings and configure the TwineAuthenticate@1 as follows:

   1. Select your feed from the My feed name dropdown menu. To authenticate with a feed outside your organization, select a Feed from external organizations and create a new service connection.

   

Publish Python packages to a feed

Note

To publish your packages to a feed using Azure Pipelines, make sure that both the Project Collection Build Service and your project's Build Service identities are assigned the Feed Publisher (Contributor) role in your feed settings. See Manage permissions for details.

YAML

1. Sign in to your Azure DevOps organization, and then navigate to your project.

2. Select Pipelines, and then select your pipeline definition.

3. Select Edit, and then add the following snippet to your YAML pipeline.

   YAML

   steps:
   - task: UsePythonVersion@0
     displayName: 'Use Python 3.x'
   
   - 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>                ## For an organization-scoped feed, use: artifactFeed: <FEED_NAME>
     displayName: 'Twine Authenticate'
   
   - script: |
       python -m twine upload -r <FEED_NAME> --config-file $(PYPIRC_PATH) dist/*.whl
     displayName: 'Upload to feed'
   

Classic

1. Sign in to your Azure DevOps organization, and then navigate to your project.

2. Select Pipelines, select your pipeline definition, and then select Edit.

3. Select the + sign to add a new task, then add the Use Python version task to your pipeline. In this example we're setting the Version spec to >= 3.7.

4. Add the Command line task to your pipeline, and paste the following commands into the Script textbox to install build and twine on your agent:

   command

   pip install build
   pip install twine
   

5. Add another Command line task to your pipeline, and then paste the following command into the Script textbox to build your project:

   command

   python -m build -w
   

6. Add for the Twine Authenticate task to your pipeline, and select your feed from the My feed name dropdown menu.

7. Add another Command line task to your pipeline, and paste the following command into the Script textbox to publish your package to your feed, replacing the placeholder with your feed's name:

   command

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

   

Related content

• Publish and download pipeline artifacts
• Set up upstream sources
• Use the .artifactignore file