Csomagok felhasználása Python-csomagindexből (PyPI)

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

Az Azure Artifacts lehetővé teszi, hogy a fejlesztők egyetlen hírcsatornával üzemeltethessék saját csomagjaikat, valamint a nyilvános adatbázisokból( például PyPI.org) telepített csomagokat. Ha a felsőbb rétegbeli források engedélyezve vannak, az Azure Artifacts automatikusan menti a felsőbb rétegbeli forrásból telepített csomagok másolatát egy közreműködő vagy annál magasabb szintű felhasználó által. Ez a cikk bemutatja a projekt beállítását és a parancssort a Python-csomagok Python-csomagindexből (PyPI) való felhasználásához.

Előfeltételek

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

Új hírcsatorna létrehozása és nyilvános upstreamek hozzáadása

Ha még nem rendelkezik hírcsatornával, az alábbi lépéseket követve hozzon létre egyet, és engedélyezze a felsőbb rétegbeli forrásokat. Ellenkező esetben ugorjon a következő lépésre a PyPI felsőbb rétegbeli forrásként való hozzáadásához.

  1. Jelentkezzen be az Azure DevOpsba, majd lépjen a projekthez.

  2. Válassza az Összetevők lehetőséget, majd válassza a Hírcsatorna létrehozása lehetőséget.

  3. Adjon meg egy leíró nevet a hírcsatornának, és állítsa be annak láthatóságát. Adja meg a hatókört, majd jelölje be a Felsőbb rétegbeli források jelölőnégyzetet a nyilvános adatbázisokból származó csomagok belefoglalásához.

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

    Képernyőkép arról, hogyan hozhat létre szükségcsatornát, és hogyan engedélyezheti a felsőbb rétegbeli forrásokat az Azure Artifactsben.

PyPI hozzáadása felsőbb rétegben

Ha a hírcsatorna létrehozásakor engedélyezte a felsőbb rétegbeli forrásokat , a PyPI-t automatikusan felfelé irányuló forrásként kellett volna hozzáadni. Ellenkező esetben manuálisan is hozzáadhatja az alábbi lépések végrehajtásával:

  1. Jelentkezzen be az Azure DevOpsba, majd lépjen a projekthez.

  2. Válassza az Összetevők lehetőséget, majd válassza a fogaskerék ikont a Hírcsatorna beállításainak megnyitásához.

  3. Válassza a Felsőbb rétegbeli források lehetőséget, majd az Add Upstream (Felsőbb réteg hozzáadása) lehetőséget.

  4. Válassza a Nyilvános forrás lehetőséget, majd a legördülő listából válassza a PyPI (https://pypi.org/) lehetőséget.

  5. Válassza a Hozzáadás lehetőséget, majd a jobb felső sarokban lévő Mentés lehetőséget a módosítások alkalmazásához.

Hitelesítse magát a hírcsatornájával

Győződjön meg arról, hogy az előfeltételek alapján telepítette a Pythont, majd kövesse az alábbi lépéseket a hírcsatornához való csatlakozáshoz:

  1. Futtassa a következő parancsot a Python-csomagkezelő frissítéséhez:

    python -m pip install --upgrade pip
    
  2. Futtassa a következő parancsot az Azure Artifacts-kulcstartó telepítéséhez:

    pip install keyring artifacts-keyring
    
  3. Hozzon létre egy személyes hozzáférési jogkivonatot a Packaging>Read hatókörrel az Azure DevOps-hitelesítéshez. Amikor először csatlakozik az Azure DevOpshoz, a rendszer kérni fogja a hitelesítő adatokat. Adjon meg bármilyen értéket a felhasználónévhez, és használja a PAT-t jelszóként. Ezeket a hitelesítő adatokat a rendszer helyileg gyorsítótárazza, és a következő hitelesítéskor újra felhasználja.

  4. Lépjen a projektkönyvtárba, majd hozzon létre egy virtuális környezetet:

    python -m venv <VIRTUAL_ENVIRONMENT_NAME>
    
  5. A virtuális környezetben hozzon létre egy pip.ini fájlt (Windows) vagy egy pip.conf fájlt (macOS/Linux), majd adja hozzá a következő kódrészletet. Cserélje ki a helyőrzőket a megfelelő értékekre. Ne töltse fel ezt a fájlt nyilvános adattárba, mert az tartalmazza a személyes hozzáférési tokenjét.

    • Projekt hatókörű hírcsatorna:

      [global]
      extra-index-url=https://<FEED_NAME>:<YOUR_PERSONAL_ACCESS_TOKEN>@pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/pypi/simple/
      
    • Szervezeti hatókörű hírcsatorna:

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

Csomagok telepítése a PyPI-ból

Most, hogy hitelesítette a hírcsatornát, telepítheti a csomagokat a PyPI-ból a felsőbb rétegből, ahogyan a pip esetében általában tenné. A telepített csomagokat a rendszer automatikusan menti az Azure Artifacts-hírcsatornába.

Ebben a példában a Python népszerű HTTP-kódtárát, a kéréseket fogja telepíteni.

Megjegyzés:

A csomagok upstream forrásokból való mentéséhez rendelkeznie kell a Hírcsatorna és Upstream olvasó (Közreműködő) szerepkörrel vagy magasabbal. További részletekért tekintse meg a kezelési engedélyeket .

  1. Nyisson meg egy parancssort, és keresse meg a projektkönyvtárat, majd aktiválja a virtuális környezetet. Cserélje le a helyőrzőt a korábban létrehozott virtuális környezet nevére:

    <YOUR_VIRTUAL_ENVIRONMENT_NAME>/Scripts/Activate
    
  2. Futtassa a következő parancsot a requests csomag PyPI-ről való telepítéséhez.

    pip install requests
    
  3. A telepítést követően az Azure Artifacts elmenti a csomag másolatát a csomagtárba. Az alábbi képernyőképen látható módon lépjen a hírcsatornára, és ellenőrizze, hogy a csomag elérhető-e.

    Képernyőkép a PyPI-ról telepített kéréscsomagról.