Sdílet prostřednictvím

Použití balíčků z indexu balíčků Pythonu (PyPI)

  • Článek

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

Pomocí Azure Artifacts můžou vývojáři publikovat a využívat balíčky z informačních kanálů Azure Artifacts a externích registrů, jako je pypi.org. Tento článek vás provede nastavením projektu a použitím příkazového řádku k efektivnímu využívání balíčků Pythonu z PyPI.

V tomto článku se naučíte:

  • Povolení upstreamových zdrojů pro váš informační kanál
  • Přidání PyPI jako nadřazeného zdroje
  • Nastavení projektu
  • Instalace balíčků z indexu balíčků Pythonu

Požadavky

Povolení upstreamových zdrojů

Pokud jste informační kanál ještě nevytvořili, vytvořte ho podle následujících kroků. Nezapomeňte zaškrtnout políčko pro upstreamové zdroje , abyste povolili nadřazené zdroje. Pokud už informační kanál máte, přejděte k dalšímu kroku a přidejte PyPI jako nadřazený zdroj.

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

  2. Vyberte Artifacts (Artefakty) a pak vyberte Create Feed (Vytvořit informační kanál ) a vytvořte nový informační kanál.

  3. Zadejte popisný název informačního kanálu a definujte jeho viditelnost (označující, kdo může zobrazit balíčky v informačním kanálu). Zadejte obor informačního kanálu a potom zaškrtněte políčko Upstreamové zdroje, abyste zahrnuli balíčky z veřejných registrů.

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

    A screenshot showing how to create a need feed.

Přidání upstreamu PyPI

Pokud jste při vytváření informačního kanálu vybrali políčko upstreamových zdrojů, měl by být PyPI automaticky zahrnutý jako nadřazený zdroj. Pokud ne, můžete ho přidat ručně pomocí následujícího postupu:

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

  2. Vyberte Artefakty a pak výběrem ikonygear iconozubeného kola přejděte na informační kanál Nastavení.

  3. Vyberte upstreamové zdroje a pak vyberte Přidat upstream a přidejte nový nadřazený zdroj.

  4. Vyberte Veřejný zdroj a pak v rozevírací nabídce vyberte PyPI (https://pypi.org/).

  5. Až skončíte, vyberte Uložit a pak v pravém horním rohu vyberte Uložit ještě jednou, aby se změny uložily.

Ověření pomocí informačního kanálu

  1. Ujistěte se, že jste stáhli Python, a pak spuštěním následujícího příkazu upgradujte správce balíčků Pythonu:

    python -m pip install --upgrade pip

  2. Spuštěním následujícího příkazu nainstalujte keyring Azure Artifacts:

    pip install keyring artifacts-keyring

  3. Vytvořte osobní přístupový token s oborem Čtení balíčku>pro ověření pomocí Azure DevOps. Při prvním připojení k Azure DevOps budete muset po zobrazení výzvy zadat svoje přihlašovací údaje. Do určených polí zadejte své uživatelské jméno (libovolný řetězec) a váš osobní přístupový token. Tyto přihlašovací údaje se uloží do mezipaměti místně a automaticky se použijí k přihlášení při příštím použití služby.

  4. Přejděte do složky projektu a spuštěním následujícího příkazu vytvořte nové virtuální prostředí:

    python -m venv <VIRTUAL_ENVIRONMENT_NAME>

  5. Ve virtuálním prostředí vytvořte nový soubor pip.ini (Windows) nebo soubor pip.conf (Mac/Linux) a vložte do souboru následující fragment kódu. Nezapomeňte zástupné symboly nahradit odpovídajícími informacemi a buďte opatrní, abyste tento soubor nepotvářeli do veřejného úložiště, protože obsahuje váš osobní přístupový token.

    • Informační kanál s oborem projektu:

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

    • Informační kanál s oborem organizace:

      [global]
extra-index-url=https://<FEED_NAME>:<YOUR_PERSONAL_ACCESS_TOKEN>@pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/pypi/simple/

Instalace balíčků z PyPI

Teď, když jsme nakonfigurovali náš projekt pro ověření v informačním kanálu, můžeme začít instalovat balíčky z upstreamu PyPI. V tomto příkladu nainstalujeme Flask:

  1. V okně příkazového řádku přejděte do složky projektu a spuštěním následujícího příkazu aktivujte virtuální prostředí. Zástupný symbol nahraďte názvem virtuálního prostředí, které jste vytvořili dříve:

    <YOUR_VIRTUAL_ENVIRONMENT_NAME>/Scripts/Activate.ps1

  2. Spuštěním následujícího příkazu zkontrolujte balíčky nainstalované ve vašem virtuálním prostředí:

    pip list

  3. Spuštěním následujícího příkazu nainstalujte Flask.

    pip install -U Flask

  4. Jakmile je balíček nainstalovaný, Azure Artifacts uloží kopii tohoto balíčku do informačního kanálu. Balíček by měl být k dispozici v informačním kanálu, jak je znázorněno na následujícím snímku obrazovky.

    A screenshot showing packages installed from PyPI upstream.