Publicar e instalar pacotes Python (CLI)

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

O Azure Artifacts permite que os desenvolvedores gerenciem suas dependências de um único feed. Você pode publicar e instalar pacotes do Python de e para seu feed usando a linha de comando. Neste artigo, você aprenderá como:

• Crie um novo feed.
• Publique pacotes do Python em um feed.
• Instale pacotes Python de um feed.

Pré-requisitos

• Uma organização do Azure DevOps. Crie um gratuitamente.

• Um projeto do Azure DevOps. Crie um projeto se ainda não tiver um.

• Baixe e instale o Python.

Criar um feed

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

2. Selecione Artefatos e, em seguida, selecione Criar Feed.

3. Forneça um Nome para o feed, escolha a opção Visibilidade que define quem pode exibir seus pacotes, marque Incluir pacotes de fontes públicas comuns se quiser incluir pacotes de fontes como nuget.org ou npmjs.com e, em Escopo, decida se o feed deve ter o escopo do seu projeto ou de toda a organização.

4. Selecione Criar quando terminar.

   

Observação

Por padrão, os feeds recém-criados têm o valor do Serviço de Compilação do projeto definido como Feed e Leitor Upstream (Colaborador).

Publicar pacotes

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

2. Selecione Artefatos e, em seguida, selecione Conectar ao feed.

3. Selecione barbante na área de navegação à esquerda. Se esta for a primeira vez que você usa o Azure Artifacts com twine, certifique-se de instalar os pré-requisitos selecionando Obter as ferramentas e seguindo as etapas fornecidas.

4. Adicione um arquivo .pypirc ao seu diretório inicial e cole o snippet fornecido nele. Seu arquivo deve ser semelhante ao snippet a seguir. Se você já tiver um .pypirc que contenha credenciais para o índice PyPI público, recomendamos remover a seção [pypi] para evitar a publicação acidental de pacotes privados no PyPI.

   [distutils]
   Index-servers =
   FEED_NAME
   
   [FEED_NAME]
   Repository = https://pkgs.dev.azure.com/ORGANIZATION_NAME/PROJECT_NAME/_packaging/FEED_NAME/pypi/upload/
   

5. Execute o comando a seguir no diretório do projeto para criar distribuições de origem e wheel.

   python setup.py sdist bdist_wheel
   

6. Execute o comando a seguir para publicar seu pacote. Use o sinalizador -r REPOSITORY_NAME para garantir que seus pacotes privados não sejam publicados acidentalmente no PyPI.

   twine upload -r REPOSITORY_NAME dist/*
   

Importante

Você deve ter twine 1.13.0 ou superior para usar artefacts-keyring. Consulte Requisitos de uso para obter mais detalhes.

Instalar Pacotes

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

2. Selecione Artefatos e, em seguida, selecione Conectar ao feed.

3. Selecione pip na área de navegação à esquerda. Se esta for a primeira vez que você usa o Azure Artifacts com pip, certifique-se de instalar os pré-requisitos selecionando Obter as ferramentas e seguindo as etapas fornecidas.

4. Crie um ambiente virtual.

5. Adicione um arquivo pip.ini (Windows) ou pip.conf (Mac/Linux) ao seu virtualenv e cole o snippet fornecido nele. Seu arquivo deve ser semelhante ao seguinte snippet:

   [global]
   index-url=https://pkgs.dev.azure.com/ORGANIZATION_NAME/PROJECT_NAME/_packaging/FEED_NAME/pypi/simple/
   

6. Execute este comando no diretório do projeto para instalar os pacotes:

   pip install
   

Importante

Você deve ter pip 19.2 ou superior para usar artifacts-keyring. Consulte Requisitos de uso para obter mais detalhes.

Conteúdo relacionado

• Usar pacotes do PyPi
• Publicar pacotes Python com o Azure Pipelines
• Configurar permissões