Publicación de paquetes de Python con Azure Pipelines

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

Azure Pipelines permite a los desarrolladores publicar paquetes de Python en fuentes de Azure Artifacts y registros públicos, como PyPi. Este artículo le guiará a través de cómo publicar paquetes de Python en la fuente de Azure Artifacts.

Requisitos previos

• Una organización de Azure DevOps y un proyecto. Cree una organización o un proyecto si aún no lo ha hecho.

• Una fuente de Azure Artifacts. Cree una fuente si aún no tiene una.

Autenticarse con un feed

Para publicar paquetes de Python usando twine, primero debe autenticarse con el feed de Azure Artifacts. La tarea TwineAuthenticate proporciona credenciales gemelas en una variable de entorno PYPIRC_PATH. Esta variable se utiliza paratwine publicar paquetes directamente desde su pipeline.

Importante

Las credenciales almacenadas en la variable de entorno PYPIRC_PATH tienen prioridad sobre las de los archivos .ini y .conf.

Si agrega varias tareas TwineAuthenticate en distintas fases de la canalización, cada ejecución de tareas adicional extenderá (no invalidará) la variable de entorno existente PYPIRC_PATH.

YAML

1. Inicie sesión en su organización de Azure DevOps y vaya a su proyecto.

2. Seleccione Pipelines y elija la definición correspondiente.

3. Seleccione Editary agregue el siguiente fragmento de código a la canalización de 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>
   

Clásico

1. Inicie sesión en su organización de Azure DevOps y vaya a su proyecto.

2. Seleccione Canalizaciones, seleccione la definición de canalización y, a continuación, seleccione Editar.

3. Seleccione el signo + para agregar una nueva tarea, luego agregue las tareas Usar la versión de Python y Subir con autenticación de Python twine a la definición de su canalización. Puede dejar la tarea de UsePythonVersion@0 con los valores predeterminados y configurar el TwineAuthenticate@1 de la siguiente manera:

   1. Seleccione la fuente en el menú desplegable Nombre de mi fuente. Para autenticarse con un feed externo a su organización, seleccione un Fuente de organizaciones externas y cree una nueva conexión de servicio.

   

Publicar paquetes Python en una fuente

Nota:

Para publicar los paquetes en una fuente mediante Azure Pipelines, asegúrese de que tanto el Servicio de compilación de colecciones de proyectos como las identidades de Servicio de compilación del proyecto tengan el rol de Publicador de fuentes (colaborador) asignado en la configuración de la fuente. Consulte Administración de permisos para obtener más información.

YAML

1. Inicie sesión en su organización de Azure DevOps y vaya a su proyecto.

2. Seleccione Pipelines y elija la definición correspondiente.

3. Seleccione Editary agregue el siguiente fragmento de código a la canalización de 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'
   

Clásico

1. Inicie sesión en su organización de Azure DevOps y vaya a su proyecto.

2. Seleccione Canalizaciones, seleccione la definición de canalización y, a continuación, seleccione Editar.

3. Seleccione el signo + para añadir una nueva tarea, luego añada la tarea Usar versión de Python a su pipeline. En este ejemplo, estableceremos la Especificación de versión en >= 3.7.

4. Agregue la tarea Línea de comandos a la canalización y pegue los siguientes comandos en el cuadro de texto Script para instalar compilación y twine en el agente.

   pip install build
   pip install twine
   

5. Agregue otra tarea de línea de comandos a su pipeline y, a continuación, pegue el siguiente comando en el cuadro de texto Script para compilar su proyecto.

   python -m build -w
   

6. Agregue la tarea Autenticar twine a la canalización y seleccione su fuente en el menú desplegable El nombre de mi fuente.

7. Agregue otra tarea de Línea de comandos a la canalización y pegue el siguiente comando en el cuadro de texto Script para publicar el paquete en su fuente, reemplazando el marcador de posición por el nombre de su fuente:

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

   

Contenido relacionado

• Publicación y descarga de artefactos de canalización
• Configurar orígenes de nivel superior
• Usa el archivo .artifactignore