Introdução aos pacotes do Python no Azure Artifacts

Artigo
12/29/2024

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

Usando o Azure Artifacts, você pode publicar e baixar pacotes de feeds e registros públicos, como PyPi. Este início rápido orientará você na criação de um feed, na configuração do projeto e no gerenciamento de pacotes do Python no feed do Azure Artifacts. Neste artigo, você aprenderá a:

Criar um novo feed.
Autenticar com o seu feed.
Publicar pacotes do Python.
Instale pacotes do seu feed.

Pré-requisitos

Crie uma organização de do Azure DevOps e um projeto de se ainda não tiver feito isso.
Baixe e instale Python.

Obter o código

Se você não tiver seu próprio projeto python, poderá usar o seguinte projeto python de exemplo:
```
https://github.com/microsoft/python-package-template
```
Para criar sua roda e distribuição de origem, execute os seguintes comandos no diretório do projeto:
```
pip install --upgrade build
python -m build
```
Se o projeto python tiver um arquivo setup.py, você também poderá usar este comando para criar seu pacote:
```
python setup.py sdist bdist_wheel
```

Criar um feed

Entre em sua organização do Azure DevOps e navegue até seu projeto.
Selecione Artefatos e, em seguida, selecione Criar Feed.
Forneça um Nome para o feed, escolha a opção de Visibilidade que define quem pode visualizar seus pacotes. Marque a opção Incluir pacotes de fontes públicas comuns se você quiser incluir pacotes de fontes como nuget.org ou npmjs.com. Já para o Escopo, decida se o feed deve ter escopo restrito ao seu projeto ou à organização inteira.
Selecione Criar quando terminar.

Entre no servidor do Azure DevOps e vá para o projeto.
Selecione Artefatos e, em seguida, selecione Criar Feed.
Forneça um Name para seu feed, escolha a opção Visibilidade que define quem pode ver seus pacotes, marque Incluir pacotes de fontes públicas comuns se você quiser incluir pacotes de fontes como nuget.org ou npmjs.come, para Escopo, decida se o feed deve ter escopo delimitado para seu projeto ou para toda a organização.

Selecione Criar quando terminar.

Selecione Criar quando terminar.

Entre no servidor do Azure DevOps e vá para o projeto.
Selecione Artefatos e, em seguida, selecione Novo feed.
Para Nome, insira um nome descritivo para o seu feed.

Para Visibilidade, selecione uma opção para indicar quem pode visualizar pacotes no feed.

Se você quiser incluir pacotes de fontes públicas, selecione a opção Usar pacotes de fontes públicas através desse feed.
Selecione Criar quando terminar.

Nota

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

Entre em sua organização do Azure DevOps e navegue até seu projeto.
Selecione Artefatos, selecione o feed no menu suspenso e, em seguida, selecione Conectar ao feed.
Selecione Twine na seção Python.
Se esta for a primeira vez que você usa o Azure Artifacts com twine, selecione Obtenha as ferramentas e siga as etapas para instalar os pré-requisitos.

Adicione um arquivo pypirc ao diretório base e cole o snippet fornecido. Seu arquivo deve ter esta aparência:

[distutils]
Index-servers =
    FEED_NAME

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

Nota

Se o arquivo .pypirc já contiver credenciais para o índice PyPI público, recomendamos remover a seção para impedir a publicação acidental de pacotes privados no PyPI.

Entre em sua organização do Azure DevOps e navegue até seu projeto.
Selecione Artefatos, selecione o feed no menu suspenso e, em seguida, selecione Conectar ao feed.
Selecione pip na seção Python.
Se esta for a primeira vez que você usa o Azure Artifacts com pip, selecione Obter as ferramentas e siga as etapas para instalar os pré-requisitos.
Criar um ambiente virtual.
Adicione um arquivo pip.ini (Windows) ou arquivo de pip.conf (Mac/Linux) ao seu ambiente virtual e cole o snippet fornecido nele. Seu arquivo deve ser semelhante ao seguinte:
```
[global]
index-url=https://pkgs.dev.azure.com/ORGANIZATION_NAME/PROJECT_NAME/_packaging/FEED_NAME/pypi/simple/
```

Publicar pacotes

Execute este comando no diretório do seu projeto para criar distribuições de source e wheel:
```
python setup.py sdist bdist_wheel
```
Execute o comando a seguir para publicar o pacote. Use o sinalizador -r FEED_NAME para garantir que seus pacotes privados não sejam publicados acidentalmente no PyPI.
```
twine upload -r <FEED_NAME> dist/*
```

Instalar pacotes

Execute este comando no diretório do projeto para instalar seus pacotes:
```
pip install
```
Para instalar um pacote específico, execute o comando a seguir, substituindo o espaço reservado pelo nome do pacote do feed.
```
pip install <PACKAGE_NAME>
```

Próximas etapas

Usar pacotes do PyPI (índice de pacotes do Python)Configurar fontes upstream publicar pacotes python com o Azure Pipelines

Compartilhar via