Sdílet prostřednictvím


Rychlý start: Publikování a využívání balíčků Pythonu pomocí Azure Artifacts pomocí příkazového řádku (CLI)

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

V tomto rychlém startu se dozvíte, jak vytvořit informační kanál Azure Artifacts a používat ho k publikování a využívání balíčků Pythonu z příkazového řádku v místním vývojovém prostředí. Po dokončení budete mít balíček Pythonu publikovaný do informačního kanálu a nainstalovaný z informačního kanálu do místního vývojového prostředí.

Pokud chcete publikovat a využívat balíčky ve službě Azure Pipelines, přečtěte si téma Publikování balíčků Pythonu pomocí Azure Pipelines.

Požadavky

Pokud chcete spustit následující kroky, musíte mít:

  • Organizace Azure DevOps. Vytvořte si ho zdarma.
  • Osobní přístupový token (PAT) s oborem čtení balíčku>. Pokud ho chcete vytvořit, přečtěte si téma Vytvoření pat.
  • Projekt Azure DevOps. Pokud ho nemáte, vytvořte projekt.
  • Python 3.8 nebo novější nainstalovaný na místním počítači Stáhněte si Python tady.
  • pip 19.2 a twine 1.13.0 nebo vyšší.
  • Balíček Pythonu pro publikování z místního počítače do informačního kanálu
  • Pokud používáte ukázkový balíček Pythonu:
    • Účet GitHub. Pokud ho ještě nemáte, vytvořte si bezplatný účet GitHubu.
    • Git nainstalovaný na místním počítači.
  • Účet GitHub. Pokud ho ještě nemáte, vytvořte si bezplatný účet GitHubu.
  • Přístup k kolekci Azure DevOps Serveru
  • Osobní přístupový token (PAT) s oborem čtení balíčku>. Pokud ho chcete vytvořit, přečtěte si téma Vytvoření pat.
  • Projekt Azure DevOps. Pokud ho nemáte, vytvořte projekt.
  • Python 3.8 nebo novější nainstalovaný v místním vývojovém prostředí
  • pip 19.2 a twine 1.13.0 nebo vyšší.
  • Pokud používáte ukázkový balíček Pythonu:
    • Účet GitHub. Pokud ho ještě nemáte, vytvořte si bezplatný účet GitHubu.
    • Git nainstalovaný na místním počítači.

Vytvoření místního balíčku Pythonu

K publikování do informačního kanálu potřebujete balíček Pythonu. Pokud balíček nemáte k publikování, můžete naklonovat ukázkový balíček Pythonu z GitHubu.

Klonování ukázkového balíčku Pythonu

Pomocí následujícího postupu použijte ukázkový balíček Pythonu z GitHubu.

  1. Přejděte do následujícího úložiště GitHub:

    https://github.com/microsoft/python-package-template
    
  2. Rozvětvujte úložiště do účtu GitHubu.

  3. Přejděte do rozvětvovaného úložiště a vyberte Kód.

  4. Zkopírujte adresu URL vašeho forku úložiště.

  5. Z rozhraní příkazového řádku na místním počítači naklonujte úložiště pomocí následujícího příkazu pomocí adresy URL, kterou jste zkopírovali z forku úložiště:

    git clone <REPOSITORY_URL>
    
  6. Změňte adresář na klonované úložiště.

    cd python-package-template
    

Sestavení balíčku

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

Pokud má projekt Pythonu setup.py soubor, můžete k sestavení balíčku použít následující příkaz:

python setup.py sdist bdist_wheel

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

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

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

    A screenshot showing how to create a feed.

  3. Do informačního kanálu zadejte následující informace:

    1. Zadejte popisný název informačního kanálu.
    2. Definujte jeho viditelnost (označující, kdo může zobrazit balíčky v informačním kanálu).
    3. Vyberte, jestli se mají používat balíčky z veřejných zdrojů, jako je pypi.org.
    4. Zadejte rozsah informačního kanálu.
  4. Vyberte Vytvořit.

  1. Přejděte do kolekce Azure DevOps a vyberte svůj projekt.

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

    A screenshot showing how to create a feed in DevOps Server.

  3. Do informačního kanálu zadejte následující informace:

    1. Zadejte popisný název informačního kanálu.
    2. Definujte jeho viditelnost (označující, kdo může zobrazit balíčky v informačním kanálu).
    3. Vyberte, jestli se mají používat balíčky z veřejných zdrojů, jako je pypi.org.
    4. Zadejte rozsah informačního kanálu.
  4. Vyberte Vytvořit.

  1. Přejděte do kolekce Azure DevOps a vyberte svůj projekt.

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

  3. Do informačního kanálu zadejte následující informace:

    1. Zadejte popisný název informačního kanálu.
    2. Definujte jeho viditelnost (označující, kdo může zobrazit balíčky v informačním kanálu).
    3. Vyberte, jestli se mají používat balíčky z veřejných zdrojů, jako je pypi.org.
    4. Zadejte rozsah informačního kanálu.
  4. Vyberte Vytvořit.

  1. Přejděte do kolekce Azure DevOps a vyberte svůj projekt.

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

  3. Do informačního kanálu zadejte následující informace:

    1. Zadejte popisný název informačního kanálu.
    2. Definujte jeho viditelnost (označující, kdo může zobrazit balíčky v informačním kanálu).
    3. Zvolte, jestli se mají balíčky používat z veřejných zdrojů, jako je pypi.org.
  4. Vyberte Vytvořit.

Publikování balíčku do informačního kanálu

Pomocí dvojčat nahrajte balíček do informačního kanálu Azure Artifacts.

  1. Přejděte do projektu Azure DevOps a vyberte Artefakty.

  2. Vyberte informační kanál a vyberte Připojení k informačnímu kanálu.

    A screenshot highlighting the connect to feed.

  3. V části Python vyberte dvojčata.

    A screenshot highlighting the twine package type.

  4. Na vývojovém počítači se ujistěte, že je nainstalované dvojče.

    pip install --upgrade twine
    
  5. Postupujte podle pokynů v části Nastavení projektu a nastavte soubor .pypirc .

    A screenshot highlighting the `.pyirc` content.

  6. Abyste nemuseli zadávat osobní přístupový token při každém publikování balíčku, můžete do .pypirc souboru přidat svoje přihlašovací údaje. Ujistěte se, že svůj osobní přístupový token nekontrolujete do veřejného úložiště.

    .pypirc Příklad souboru s přihlašovacími údaji:

    [distutils]
    Index-servers =
        <FEED_NAME>
    
    [<FEED_NAME>]
    Repository = <FEED_URL>
    username = <FEED_NAME>
    password = <YOUR_PERSONAL_ACCESS_TOKEN>
    
  7. Pokud chcete balíček nahrát, spusťte v adresáři projektu následující příkaz a nahraďte <FEED_NAME> názvem informačního kanálu. Ve Windows možná budete muset zadat .pypirc umístění souboru pomocí argumentu --config-file .

    twine upload --repository <FEED_NAME> dist/*
    

Instalace balíčku z informačního kanálu

  1. Přejděte do projektu Azure DevOps a vyberte Artefakty.

  2. Vyberte informační kanál a vyberte Připojení k informačnímu kanálu.

    A screenshot highlighting the connect to feed button.

  3. V části Python vyberte pip.

    A screenshot highlighting the pip package type.

  4. Připravte místní prostředí Pythonu.

    1. Ujistěte se, že je pip nainstalovaný a aktuální:

      python -m pip install --upgrade pip
      
    2. Vytvoření a aktivace virtuálního prostředí Pythonu:

      python -m venv myenv
      myenv/Scripts/activate
      
  5. Přidejte soubor pip.ini (Windows) nebo pip.conf (Mac/Linux) do kořenového adresáře vašeho virtuálního prostředí. Zkopírujte obsah z oddílu Nastavení projektu v Připojení do dialogového okna informačního kanálu a přidejte ho do souboru pip.ini nebo pip.conf.

    A screenshot highlighting the pip.ini file content.

  6. Abyste nemuseli zadávat osobní přístupový token při každé instalaci balíčku z informačního kanálu, můžete své přihlašovací údaje přidat do souboru pip.ini nebo pip.conf . Ujistěte se, že svůj osobní přístupový token nekontrolujete do veřejného úložiště.

    Příklad souboru pip.ini nebo pip.conf s přihlašovacími údaji:

    [global]
    extra-index-url=https://<FEED_NAME>:<YOUR_PERSONAL_ACCESS_TOKEN>@<FEED_URL>
    
  7. Pokud chcete balíček nainstalovat, spusťte následující příkaz, který nahradí <PACKAGE_NAME> názvem balíčku z informačního kanálu.

    pip install <PACKAGE_NAME>
    

Vyčištění prostředků

Až budete s vytvořenými prostředky hotovi, můžete je odstranit, abyste se vyhnuli poplatkům. Když odstraníte projekt, odstraní se všechny informační kanály artefaktů na úrovni projektu.

Odstranění projektu:

  1. Vyberte projekt Nastavení.
  2. Na stránce s podrobnostmi projektu vyberte v dolní části stránky odstranit.
  3. Zadejte název projektu, který chcete potvrdit, a pak vyberte Odstranit.

Pokud chcete informační kanál odstranit jenom:

  1. V rozevírací nabídce vyberte Artefakty a vyberte svůj informační kanál.
  2. Vyberte tlačítko nastavení.
  3. Na kartě Nastavení informačního kanálu vyberte Odstranit informační kanál.
  4. Výběrem možnosti Odstranit potvrdíte akci.

Vyčištění místního vývojového prostředí:

  1. Pokud chcete virtuální prostředí deaktivovat, spusťte následující příkaz:

    deactivate
    
  2. Pokud chcete virtuální prostředí odstranit, odstraňte adresář, ve kterém byl vytvořen.

  3. Odeberte soubor z domovského .pypirc adresáře.

Pokud jste naklonovali ukázkový balíček Pythonu, můžete úložiště odstranit z místního počítače a účtu GitHub.

Další kroky