Začínáme s balíčky Pythonu v Azure Artifacts

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

Pomocí Azure Artifacts můžete publikovat a stahovat balíčky z informačních kanálů a veřejných registrů, jako je PyPi. Tento rychlý start vás provede vytvořením informačního kanálu, konfigurací projektu a správou balíčků Pythonu v informačním kanálu Azure Artifacts. V tomto článku se naučíte:

• Vytvořte nový informační kanál.
• Ověřte se pomocí informačního kanálu.
• Publikování balíčků Pythonu
• Nainstalujte balíčky ze zdroje.

Požadavky

• Pokud jste to ještě neudělali, vytvořte organizaci Azure Dev Ops a projekt .

• Stáhněte a nainstalujte Python .

Získání kódu

1. Pokud nemáte vlastní projekt Pythonu, můžete použít následující ukázkový projekt Pythonu:

   https://github.com/microsoft/python-package-template
   

2. Pokud chcete vytvořit kolo a zdrojová distribuce, spusťte v adresáři projektu následující příkazy:

   pip install --upgrade build
   python -m build
   

3. Pokud má projekt Pythonu soubor setup.py, můžete balíček sestavit také pomocí tohoto příkazu:

   python setup.py sdist bdist_wheel
   

Vytvoření informačního kanálu

1. Přihlaste se ke své organizaci Azure DevOps a přejděte k projektu.

2. Vyberte Artefaktya pak vyberte Vytvořit informační kanál.

3. Zadejte Název informačního kanálu, zvolte možnost Viditelnost, která definuje, kdo může balíčky zobrazit, zaškrtněte Zahrnout balíčky z běžných veřejných zdrojů,, pokud chcete zahrnout balíčky ze zdrojů, jako jsou nuget.org nebo npmjs.com, a pro Rozsah, rozhodněte, jestli má být informační kanál vymezen pro váš projekt nebo celou organizaci.

4. Až budete hotovi, vyberte Vytvořit.

   

Poznámka

Nově vytvořené informační kanály mají ve výchozím nastavení hodnotu svého projektu Build Service nastavenou na hodnotu Informační kanál a Upstream Reader (Spolupracovník).

Připojit se k kanálu

provázek

1. Přihlaste se ke své organizaci Azure DevOps a přejděte k projektu.

2. Vyberte Artefakty, z rozevíracího seznamu zvolte svůj informační kanál a poté vyberte Připojit k informačnímu kanálu.

3. V části Python vyberte twine.

4. Pokud používáte Azure Artifacts s twine poprvé, vyberte Získat nástroje a postupujte podle pokynů k instalaci požadovaných součástí.

5. Přidejte do svého domovského adresáře pypirc soubor a vložte zadaný fragment kódu. Soubor by měl vypadat takto:

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

Poznámka

Pokud váš soubor .pypirc již obsahuje přihlašovací údaje pro veřejný index PyPI, doporučujeme odebrat oddíl [pypi], aby nedošlo k náhodnému publikování privátních balíčků do PyPI.

pip

1. Přihlaste se ke své organizaci Azure DevOps a přejděte k projektu.

2. Vyberte Artefakty, z rozevírací nabídky vyberte váš informační kanál, a poté zvolte Připojit k informačnímu kanálu.

3. V části Pythonu vyberte pip.

4. Pokud používáte Azure Artifacts s pipem poprvé, vyberte Získat nástroje a podle pokynů nainstalujte požadované součásti.

5. Vytvoření virtuálního prostředí.

6. Přidejte do svého virtuálního prostředí soubor pip.ini (Windows) nebo pip.conf (Mac/Linux) a vložte do něj zadaný fragment kódu. Soubor by měl vypadat přibližně takto:

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

Publikování balíčků

1. Spusťte tento příkaz v adresáři projektu pro vytvoření zdrojových a wheel distribucí.

   python setup.py sdist bdist_wheel
   
   

2. Spuštěním následujícího příkazu publikujte balíček. Pomocí příznaku -r FEED_NAME se ujistěte, že se vaše privátní balíčky nechtěně nepublikují do PyPI.

   twine upload -r <FEED_NAME> dist/*
   

Instalace balíčků

1. Spuštěním tohoto příkazu v adresáři projektu nainstalujte balíčky:

   pip install
   

2. Pokud chcete nainstalovat konkrétní balíček, spusťte následující příkaz a nahraďte zástupný text názvem balíčku z vašeho informačního kanálu.

   pip install <PACKAGE_NAME>
   

Další kroky

Použití balíčků z indexu balíčků Pythonu (PyPI)Nastavení upstreamových zdrojůpublikování balíčků Pythonu pomocí služby Azure Pipelines