Python-csomagok közzététele és letöltése az Azure Artifacts használatával

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Az Azure Artifacts használatával csomagokat tehet közzé és tölthet le hírcsatornákból és nyilvános nyilvántartásokból, például a PyPi-ból. Ez a rövid útmutató végigvezeti egy hírcsatorna létrehozásán, a projekt konfigurálásán és a Python-csomagok Azure Artifacts-csatornán való kezelésén.

Előfeltételek

termék	Követelmények
Azure DevOps	- Egy Azure DevOps szervezet. - Azure DevOps-projekt. - Töltse le és telepítse Python.

A kód lekérése

1. Ha nem rendelkezik saját Python-projektel, az alábbi Python-mintaprojektet használhatja. Ellenkező esetben a következő szakaszra ugorhat:

   https://github.com/Azure-Samples/azure-stack-hub-flask-hello-world
   

2. A Wheel csomag és a forráscsomag összeállításához futtassa a következő parancsokat a projektkönyvtárában:

   pip install --upgrade build
   python -m build
   

3. Ha a Python-projekt setup.py fájllal rendelkezik, a csomagot az alábbiak használatával is létrehozhatja:

   python setup.py sdist bdist_wheel
   

Hírcsatorna létrehozása

1. Jelentkezzen be az Azure DevOps-szervezetbe, és lépjen a projekthez.

2. Válassza a Artefaktumoklehetőséget, majd válassza a Csatorna létrehozásalehetőséget.

3. Adjon meg egy név a hírcsatornához, válassza a Láthatóság lehetőséget, amely meghatározza, hogy ki tekintheti meg a csomagokat, ellenőrizze A közös nyilvános forrásokból származó csomagok belefoglalása, ha olyan forrásokból származó csomagokat szeretne felvenni, mint a nuget.org vagy a npmjs.com, és Hatóköresetében döntse el, hogy a hírcsatorna hatóköre a projektre vagy az egész szervezetre kiterjed-e.

4. Ha elkészült, válassza létrehozása lehetőséget.

   

Jegyzet

Alapértelmezés szerint a projekt Build Szolgáltatása(például: projectName Build Service (orgName)) új hírcsatorna létrehozásakor a Feed és Felülolvasó (Közreműködő) szerepkörhöz van hozzárendelve.

Csatlakozás a hírcsatornához

zsineg

1. Jelentkezzen be az Azure DevOps-szervezetbe, és lépjen a projekthez.

2. Válassza Artefaktumok, válassza ki a(z) hírcsatornát a legördülő menüből, majd válassza a Csatlakozás a hírcsatornához.

3. A Python szakaszban válassza a twine lehetőséget.

4. Ha ez az első alkalom, hogy az Azure Artifacts-t zsineggel használja, válassza az Eszközök lekérése lehetőséget, és kövesse az utasításokat a Python letöltéséhez és a Twine és az összetevők kulcstartójának telepítéséhez.

5. Hozzon létre egy pypirc-fájlt a kezdőkönyvtárban, és illessze be a Project beállítási szakaszában megadott kódrészletet. A fájlnak így kell kinéznie:

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

Jegyzet

Ha a .pypirc fájl már tartalmaz hitelesítő adatokat a nyilvános PyPI-indexhez, javasoljuk, hogy távolítsa el a [pypi] szakaszt, nehogy véletlenül privát csomagokat tegyen közzé a PyPI-ben.

mag

1. Jelentkezzen be az Azure DevOps-szervezetbe, és lépjen a projekthez.

2. Válassza Artefaktumok, válassza ki a(z) hírcsatornát a legördülő menüből, majd válassza a Csatlakozás a hírcsatornához.

3. A Python szakaszban válassza a pipet.

4. Ha először használja az Azure Artifactst pip használatával, válassza az Eszközök lekérése lehetőséget, és kövesse az utasításokat a Python letöltéséhez, a pip frissítéséhez és a kulcstartó telepítéséhez.

5. Virtuális környezet létrehozása.

6. Adjon hozzá egypip.ini fájlt (Windows) vagy pip.conf fájlt (Mac/Linux) a virtuális környezethez, és illessze be a megadott kódrészletet. A fájlnak a következőhöz hasonlónak kell lennie:

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

Csomagok közzététele a hírcsatornában

1. A projektkönyvtárban futtassa a következő parancsot a forrás- és kerékeloszlások létrehozásához:

   python setup.py sdist bdist_wheel
   
   

2. A csomag közzétételéhez használja az alábbi parancsot. Ügyeljen arra, hogy a -r FEED_NAME jelző használatával elkerülje a PyPI-ben való véletlen közzétételt:

   twine upload -r <FEED_NAME> dist/*
   

Csomagok telepítése a hírcsatornából

1. Ha csomagokat szeretne telepíteni a hírcsatornából, futtassa a következő parancsot a projektkönyvtárban:

   pip install
   

2. Egy adott csomag telepítéséhez cserélje le a helyőrzőt a csomag nevére a hírcsatornából:

   pip install <PACKAGE_NAME>
   

Kapcsolódó tartalom

• Felsőbb rétegbeli források beállítása

• Csomagok használata Python-csomagindexből (PyPI)

• Python-csomagok közzététele az Azure Pipelines YAML/Classic használatával