Publicar pacotes Python com o Azure Pipelines

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

O Azure Pipelines permite que os desenvolvedores publiquem pacotes Python em feeds de Artefatos do Azure e registros públicos, como o PyPi. Este artigo irá guiá-lo através de como publicar pacotes Python no seu feed de Artefatos do Azure.

Pré-requisitos

• Uma organização e um projeto do Azure DevOps. Crie uma organização ou um projeto , caso ainda não o tenha feito.

• Um feed de Artefatos do Azure. Crie um feed se ainda não tiver um.

Autenticar com um feed

Para publicar pacotes Python usando o twine, você deve primeiro autenticar com seu feed de Artefatos do Azure. A tarefa TwineAuthenticate fornece credenciais de fio para uma variável de PYPIRC_PATH ambiente. Essa variável é então usada portwine para publicar pacotes diretamente do seu pipeline.

Importante

As credenciais armazenadas na variável de ambiente PYPIRC_PATH têm precedência sobre as dos arquivos .ini e .conf.

Se adicionar várias tarefas TwineAuthenticate em diferentes estágios do seu pipeline, cada execução de tarefa estenderá (não substituirá) a variável de ambiente PYPIRC_PATH existente.

YAML

1. Entre em sua organização do Azure DevOps e navegue até seu projeto.

2. Selecione Pipelinese, em seguida, selecione sua definição de pipeline.

3. Selecione Editare, em seguida, adicione o seguinte trecho ao seu 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>
   

Clássico

1. Entre em sua organização do Azure DevOps e navegue até seu projeto.

2. Selecione Pipelines, selecione sua definição de pipeline e selecione Editar.

3. Selecione o sinal + para adicionar uma nova tarefa e, em seguida, adicione a tarefa Usar versão do Python e a tarefa Autenticar upload do Python twine à sua definição de pipeline. Você pode deixar a tarefa UsePythonVersion@0 com as configurações padrão e configurar o TwineAuthenticate@1 da seguinte maneira:

   1. Selecione seu feed no menu suspenso Meu nome do feed. Para autenticar num feed fora da sua organização, selecione um Feed de organizações externas e crie uma nova conexão de serviço.

   

Publicar pacotes Python em um feed

Nota

Para publicar os seus pacotes em um feed usando o Azure Pipelines, certifique-se de que tanto o Serviço de Compilação da Coleção de Projetos quanto as identidades do Serviço de Compilação do seu projeto recebam a função de Editor de Feed (Colaborador) nas configurações do seu feed. Consulte Gerenciar permissões para obter detalhes.

YAML

1. Entre em sua organização do Azure DevOps e navegue até seu projeto.

2. Selecione Pipelinese, em seguida, selecione sua definição de pipeline.

3. Selecione Editare, em seguida, adicione o seguinte trecho ao seu 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'
   

Clássico

1. Entre em sua organização do Azure DevOps e navegue até seu projeto.

2. Selecione Pipelines, selecione sua definição de pipeline e selecione Editar.

3. Selecione o sinal + para adicionar uma nova tarefa, depois adicione a tarefa Usar versão Python ao seu pipeline. Neste exemplo, estamos definindo a especificação Version como >.

4. Adicione a tarefa linha de comando ao pipeline e cole os seguintes comandos na caixa de texto Script para instalar de compilação e de fio no seu agente:

   pip install build
   pip install twine
   

5. Adicione outra tarefa de de linha de comando ao pipeline e, em seguida, cole o seguinte comando na caixa de texto Script para criar seu projeto:

   python -m build -w
   

6. Adicione a tarefa Twine Authenticate ao seu pipeline e selecione o seu feed no menu suspenso o nome do meu feed.

7. Adicione outra tarefa de linha de comando ao seu pipeline e cole o seguinte comando na caixa de texto Script para publicar o seu pacote no seu feed, substituindo o marcador de posição pelo nome do seu feed:

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

   

Conteúdo relacionado

• Publicar e baixar artefatos de pipeline
• Configurar fontes de origem
• Use o arquivo .artifactignore