Začínáme s balíčky Pythonu v Azure ArtifactsGet started with Python packages in Azure Artifacts

Azure DevOps Services | Azure DevOps Server 2019 – | Azure DevOps Server 2020Azure DevOps Services | Azure DevOps Server 2019 | Azure DevOps Server 2020

Tato příručka vás provede použitím Azure Artifacts k publikování a používání balíčků Pythonu do a z informačního kanálu.This guide will walk you through using Azure Artifacts to publish and consume Python packages to and from your feed.

Vytvoření informačního kanáluCreate a feed

Pomocí Azure Artifacts můžete vytvořit dva typy kanálů: informační kanály v oboru projektu a v rámci organizace.With Azure Artifacts, you can create two types of feeds: project-scoped and organization-scoped feeds. Všechny veřejné informační kanály jsou v oboru projektu a dědí nastavení viditelnosti hostujícího projektu.All public feeds are project-scoped and they inherit the hosting project's visibility settings. Ve výchozím nastavení jsou všechny kanály, které jsou vytvořeny pomocí webového uživatelského rozhraní, informační kanál s oborem projektu, a to následujícím způsobem.By default, any feed that's created by using the web UI is a project-scoped feed, as follows.

  1. V rámci projektu přejděte na Azure Artifacts.From within your project, navigate to Azure Artifacts.

    Přejít na Azure ArtifactsGo to Azure Artifacts

  2. Vyberte vytvořit kanál.Select Create Feed.

    Tlačítko Nový kanálNew feed button

  3. Pojmenujte svůj informační kanál a vyberte jeho viditelnost, nadřazený zdroj a nastavení rozsahu .Give your feed a Name and choose its visibility, upstream sources, and scope settings.

    Dialogové okno nového informačního kanáluNew feed dialog box

  4. Po dokončení vyberte Vytvořit.When you are done, select Create.

Poznámka

Povolením nadřazených zdrojů umožníte využívání balíčků z veřejných registrů a získáte lepší ochranu před výpadky a poškozenými balíčky.Enabling upstream sources allows you to consume packages from public registries and gives you more protection against outages and corrupted packages.

Azure Artifacts je ve výchozím nastavení nainstalován pro zákazníky TFS 2017.Azure Artifacts is installed by default for TFS 2017 customers. Aby bylo možné použít Azure Artifacts, je nutné upgradovat na TFS 2017.You must upgrade to TFS 2017 in order to use Azure Artifacts. Pokud Váš informační kanál poprvé použijete, může se vám zobrazit výzva k přiřazení licence .If this is the first time using your feed, you might be asked to assign a license

  1. Přejít na sestavení & vydání a vyberte balíčky.Go to Build & Release and select Packages.

    Přejít na Azure Artifacts TFSGo to Azure Artifacts TFS

  2. Vyberte + Nový informační kanál.Select + New feed.

    Tlačítko nového kanálu TFSNew feed button TFS

  3. Dejte informačnímu kanálu název, Popis a nastavte, kdo může číst, kdo může přispívat a zda chcete Zahrnout externí balíčky.Give your feed a Name, a Description, and set up who can read, who can contribute and if you want to Include external packages.

    Dialogové okno Nový kanál – dialogové okno TFSNew feed dialog box TFS

Poznámka

Povolením nadřazených zdrojů umožníte využívání balíčků z veřejných registrů a získáte lepší ochranu před výpadky a poškozenými balíčky.Enabling upstream sources allows you to consume packages from public registries and gives you more protection against outages and corrupted packages.

Připojení k informačnímu kanáluConnect to feed

Existují dva hlavní způsoby, jak se připojit k informačnímu kanálu a publikovat nebo využívat balíčky Pythonu:There are two primary ways to connect to a feed to publish or consume your Python packages:

  1. Nainstalujte a použijte balíček artifacts-keyring, který vám automaticky nastaví ověřování.Install and use the artifacts-keyring package, which will automatically set up authentication for you.
  2. Ručně nastavte přihlašovací údaje propip.ini pip.conf pro nabízená oznámení a / .pypirc pro čtení pomocí tokenu PAT.Manually set up credentials for pip.ini/pip.conf for pushes, and .pypirc for pulls with a personal access token (PAT).

Poznámka

Artifacts-keyring se v novějších verzích Ubuntu nepodporuje.artifacts-keyring is not supported on newer versions of Ubuntu.

Nastavení ověřování pomocí klíčů artifacts-keyringUse artifacts-keyring to set up authentication

Balíček artifacts-keyring umožňuje nastavit ověřování pro publikování a používání balíčků Pythonu do a z informačního kanálu.The artifacts-keyring package allows you to set up authentication to publish and consume your Python packages to and from your feed. Pip i twine k vyhledání přihlašovacích údajů používají knihovnu pythonových klíčů.Both pip and twine use the Python keyring library to find credentials.

Důležité

Pokud chcete používat artifacts-keyring, musíte mít pip 19.2 a twine 1.13.0 nebo vyšší.You must have pip 19.2 and twine 1.13.0 or higher to use artifacts-keyring.

  1. V okně příkazového řádku se zvýšenými oprávněními spusťte následující příkaz, který nainstaluje balíček artifacts-keyring:In an elevated command prompt window, run the following command to install the artifacts-keyring package:

    pip install artifacts-keyring
    
  2. Nainstalujte balíčky z informačního kanálu.Install packages from your feed.

    pip install <package-name> --index-url https://pkgs.dev.azure.com/<your-organization-name>/<your-project-name>/_packaging/<your-feed-name>/pypi/simple
    
  3. Publikujte balíčky do informačního kanálu.Publish packages to your feed.

    twine upload --repository-url https://pkgs.dev.azure.com/<your-organization-name>/<your-project-name>/_packaging/<your-feed-name>/pypi/upload
    

Poznámka

Balíček artifacts-keyring je navrstvený nad naší Azure Artifacts Poskytovatel pověření.The artifacts-keyring package is layered on top of our Azure Artifacts Credential Provider. Pokročilejší možnosti konfigurace najdete v úložišti artifacts-credprovider.For more advanced configuration options, check out the artifacts-credprovider repository.

Ruční konfigurace ověřováníManually configure authentication

  1. Vytvořením osobního přístupového tokenu s > oborem čtení pro ověření do Azure DevOps.Create a Personal access token with Packaging > Read scope to authenticate into Azure DevOps.

  2. V rámci vašeho informačního kanálu vyberte připojit k informačnímu kanálu.From within your feed, select Connect to feed.

    Tlačítko připojit k kanálu

  3. V hlavičce Pythonu vyberte PIP .Select pip under the Python header.

    Vyberte PIP, abyste se připojili k vašemu kanálu.

  4. Ujistěte se, že máte nainstalovanou nejnovější verzi Azure Artifacts Správce klíčů v nabídce získat nástroje.Make sure you have installed the latest version of the Azure Artifacts keyring from the "Get the tools" menu.

    Poznámka

    Artefakty-balíček klíčů poskytuje ověřování pro publikování a využívání balíčků Pythonu do a z Azure Artifacts informačních kanálů.The artifacts-keyring package provides authentication for publishing and consuming Python packages to and from Azure Artifacts feeds.

  5. Vytvořte virtualenv, pokud ho ještě nemáte.Create a virtualenv, if you don't already have one.

  6. Přidejte soubor pip.ini (Windows) nebo PIP. conf (Mac/Linux) do virtualenv.Add a pip.ini (Windows) or pip.conf (Mac/Linux) file to your virtualenv. Ujistěte se, že váš osobní přístupový token nekontrolujete ve veřejném úložišti.Make sure you don't check your personal access token into a public repository.

    [global]
    extra-index-url=https://<your-feed-name>:<your-PAT-key>@pkgs.dev.azure.com/<your-organization-name>/<your-project-name>/_packaging/<your-feed-name>/pypi/simple/
    
  7. Spuštěním následujícího příkazu nainstalujte balíček.Run the following command to install a package

    pip install <package-name>
    

Při prvním připojení ke službě Azure DevOps se zobrazí výzva k zadání přihlašovacích údajů.When you connect to Azure DevOps for the first time, you will be prompted for credentials. Do příslušných polí zadejte své uživatelské jméno (libovolný řetězec) a váš osobní přístupový token.Enter your user name(any string) and your personal access token in the appropriate fields. Přihlašovací údaje se uloží do mezipaměti místně a použijí se k automatickému přihlášení při příštím používání služby.The credentials will be cached locally and used to automatically sign you in the next time you use the service.

Poznámka

Pokud chcete nastavit ověřování v Azure Pipelines, použijte k instalaci balíčků úlohu ověřování pomocí Python PIP nebo odešlete úlohu ověřování v Pythonu pro nahrávání do balíčku push.If you want to set up authentication in Azure Pipelines, use the Python Pip Authenticate task to install packages, or the Python Twine Upload Authenticate task to push packages.