Introdução aos pacotes Python nos Artefatos do Azure

Artigo
12/21/2024

Serviços de DevOps do Azure | 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 o PyPi. Este início rápido irá guiá-lo através da criação de um feed, configuração do seu projeto e gestão de pacotes Python no seu feed de Artefactos do Azure. Neste artigo, você aprenderá a:

Crie um novo feed.
Autentique-se com o seu feed.
Publique pacotes Python.
Instale pacotes a partir do seu feed.

Pré-requisitos

Crie uma organização do Azure DevOps e um projeto se ainda não o fez.
Baixe e instale o 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 construir sua distribuição de roda e origem, execute os seguintes comandos no diretório do projeto:
```
pip install --upgrade build
python -m build
```
Se seu projeto Python tiver um arquivo setup.py, você também pode usar este comando para construir 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 Artefatose, em seguida, selecione Criar feed.
Forneça um Nome para o seu feed, escolha a opção Visibilidade que define quem pode visualizar os seus pacotes, marque Incluir pacotes de fontes públicas comuns se quiser incluir pacotes de fontes como nuget.org ou npmjs.com, e, para Escopo, decida se o feed deve ter o escopo definido para o seu projeto ou para toda a organização.
Selecione Criar quando terminar.

Inicie sessão no seu servidor Azure DevOps e, em seguida, aceda ao seu projeto.
Selecione Artefatose, em seguida, selecione Criar feed.
Forneça um de Nome para seu feed, escolha a opção de Visibilidade que define quem pode visualizar seus pacotes, marque Incluir pacotes de fontes públicas comuns se quiser incluir pacotes de fontes como nuget.org ou npmjs.come, para Escopo, decida se o feed deve ter escopo para seu projeto ou para toda a organização.

Selecione Criar quando terminar.

Selecione Criar quando terminar.

Inicie sessão no seu servidor Azure DevOps e, em seguida, aceda ao seu projeto.
Selecione Artefatose, em seguida, selecione Novo fluxo.
No campo Nome, insira um nome descritivo para o seu feed.

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

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

Observação

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

Conectar-se a um feed

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

Adicione um ficheiro pypirc ao seu diretório inicial e cole o trecho fornecido. O seu ficheiro deve ter o seguinte aspeto:

[distutils]
Index-servers =
    FEED_NAME

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

Observação

Se o seu arquivo de .pypirc já contiver credenciais para o índice público do PyPI, recomendamos remover a seção para evitar 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 seu feed no menu suspenso e, em seguida, selecione Conectar ao feed.
Selecione pip na seção Python.
Se esta for a primeira vez que utiliza 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 pip.conf (Mac/Linux) ao seu ambiente virtual e cole o trecho 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 projeto para criar distribuições de origem e roda:
```
python setup.py sdist bdist_wheel
```
Execute o seguinte comando para publicar seu 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 os pacotes:
```
pip install
```
Para instalar um pacote específico, execute o seguinte comando, substituindo o espaço reservado pelo nome do pacote do seu feed.
```
pip install <PACKAGE_NAME>
```

Próximos passos

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

Partilhar via