Megosztás a következőn keresztül:


Rövid útmutató: Python-csomagok közzététele és felhasználása az Azure Artifacts használatával a parancssor (CLI) használatával

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

Ebben a rövid útmutatóban megtudhatja, hogyan hozhat létre Azure Artifacts-hírcsatornát, és hogyan használhatja a hírcsatornát Python-csomagok közzétételére és felhasználására a helyi fejlesztési környezet parancssorából. Ha végzett, egy Python-csomag van közzétéve a hírcsatornában, és telepítve van a hírcsatornából a helyi fejlesztési környezetbe.

Ha csomagokat szeretne közzétenni és felhasználni az Azure Pipelinesban, olvassa el a Python-csomagok közzététele az Azure Pipelines használatával című témakört.

Előfeltételek

A következő lépések futtatásához a következő lépésekkel kell rendelkeznie:

Helyi Python-csomag létrehozása

Egy Python-csomagra van szüksége a hírcsatornában való közzétételhez. Ha nincs közzéteendő csomagja, klónozhat egy Python-mintacsomagot a GitHubról.

A Python-mintacsomag klónozása

A GitHubról származó Python-mintacsomagot az alábbi lépésekkel használhatja.

  1. Nyissa meg a következő GitHub-adattárat:

    https://github.com/microsoft/python-package-template
    
  2. Tárház elágazása a GitHub-fiókba.

  3. Nyissa meg az elágazott adattárat, és válassza a Kód lehetőséget.

  4. Másolja ki az elágazott adattár URL-címét.

  5. A helyi gépen lévő parancssori felületről klónozza az adattárat a következő paranccsal az elágazott adattárból másolt URL-cím használatával:

    git clone <REPOSITORY_URL>
    
  6. Módosítsa a könyvtárat a klónozott adattárra.

    cd python-package-template
    

A csomag összeállítása

A kerék és a forráseloszlás összeállításához futtassa a következő parancsokat a projektkönyvtárban:

pip install --upgrade build
python -m build

Ha a Python-projekt rendelkezik fájllal setup.py , a következő paranccsal hozhatja létre a csomagot:

python setup.py sdist bdist_wheel

Hírcsatorna létrehozása

  1. Jelentkezzen be az Azure DevOps-szervezetbe, majd lépjen a projektjéhez.

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

    A screenshot showing how to create a feed.

  3. Adja meg a következő adatokat a hírcsatornához:

    1. Adjon meg egy leíró nevet a hírcsatornának.
    2. Határozza meg a láthatóságát (azt jelzi, hogy ki tekintheti meg a csomagokat a hírcsatornán belül).
    3. Válassza ki, hogy nyilvános forrásokból( például pypi.org) származó csomagokat szeretne-e használni.
    4. Adja meg a hírcsatorna hatókörét .
  4. Válassza a Létrehozás lehetőséget.

  1. Nyissa meg az Azure DevOps-gyűjteményt, és válassza ki a projektet.

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

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

  3. Adja meg a következő adatokat a hírcsatornához:

    1. Adjon meg egy leíró nevet a hírcsatornának.
    2. Határozza meg a láthatóságát (azt jelzi, hogy ki tekintheti meg a csomagokat a hírcsatornán belül).
    3. Válassza ki, hogy nyilvános forrásokból( például pypi.org) származó csomagokat szeretne-e használni.
    4. Adja meg a hírcsatorna hatókörét .
  4. Válassza a Létrehozás lehetőséget.

  1. Nyissa meg az Azure DevOps-gyűjteményt, és válassza ki a projektet.

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

  3. Adja meg a következő adatokat a hírcsatornához:

    1. Adjon meg egy leíró nevet a hírcsatornának.
    2. Határozza meg a láthatóságát (azt jelzi, hogy ki tekintheti meg a csomagokat a hírcsatornán belül).
    3. Válassza ki, hogy nyilvános forrásokból( például pypi.org) származó csomagokat szeretne-e használni.
    4. Adja meg a hírcsatorna hatókörét .
  4. Válassza a Létrehozás lehetőséget.

  1. Nyissa meg az Azure DevOps-gyűjteményt, és válassza ki a projektet.

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

  3. Adja meg a következő adatokat a hírcsatornához:

    1. Adjon meg egy leíró nevet a hírcsatornának.
    2. Határozza meg a láthatóságát (azt jelzi, hogy ki tekintheti meg a csomagokat a hírcsatornán belül).
    3. Döntse el, hogy nyilvános forrásokból( például pypi.org) származó csomagokat szeretne-e használni.
  4. Válassza a Létrehozás lehetőséget.

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

A twine használatával töltse fel a csomagot az Azure Artifacts-hírcsatornába.

  1. Nyissa meg az Azure DevOps Projectet, és válassza az Összetevők lehetőséget.

  2. Válassza ki a hírcsatornát, és válassza a Csatlakozás a hírcsatornához.

    A screenshot highlighting the connect to feed.

  3. Válassza a twine lehetőséget a Python szakasz alatt.

    A screenshot highlighting the twine package type.

  4. A fejlesztői gépen győződjön meg arról, hogy a twine telepítve van.

    pip install --upgrade twine
    
  5. A fájl beállításához kövesse a Project beállítási szakaszának utasításait .pypirc .

    A screenshot highlighting the `.pyirc` content.

  6. Annak érdekében, hogy ne kelljen minden csomag közzétételekor megadnia a személyes hozzáférési jogkivonatát, hozzáadhatja a hitelesítő adatait a .pypirc fájlhoz. Győződjön meg arról, hogy nem ellenőrzi a személyes hozzáférési jogkivonatát egy nyilvános adattárban.

    Példa hitelesítő .pypirc adatokkal rendelkező fájlra:

    [distutils]
    Index-servers =
        <FEED_NAME>
    
    [<FEED_NAME>]
    Repository = <FEED_URL>
    username = <FEED_NAME>
    password = <YOUR_PERSONAL_ACCESS_TOKEN>
    
  7. A csomag feltöltéséhez futtassa a következő parancsot a projektkönyvtárban az F Enterprise kiadás D_NAME> helyett <a hírcsatorna nevére. Windows rendszeren előfordulhat, hogy meg kell adnia a .pypirc fájl helyét az --config-file argumentummal.

    twine upload --repository <FEED_NAME> dist/*
    

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

  1. Nyissa meg az Azure DevOps Projectet, és válassza az Összetevők lehetőséget.

  2. Válassza ki a hírcsatornát, és válassza a Csatlakozás a hírcsatornához.

    A screenshot highlighting the connect to feed button.

  3. Válassza ki a Pip elemet a Python szakasz alatt.

    A screenshot highlighting the pip package type.

  4. Készítse elő a helyi Python-környezetet.

    1. Győződjön meg arról, hogy a pip telepítve van és naprakész:

      python -m pip install --upgrade pip
      
    2. Python virtuális környezet létrehozása és aktiválása:

      python -m venv myenv
      myenv/Scripts/activate
      
  5. Adjon hozzá egy pip.ini (Windows) vagy egy pip.conf (Mac/Linux) fájlt a virtuális környezet gyökérkönyvtárához. Másolja a tartalmat a Csatlakozás Project beállítási szakaszából a hírcsatorna párbeszédpanelre, és adja hozzá a pip.ini vagy pip.conf fájlhoz.

    A screenshot highlighting the pip.ini file content.

  6. Annak érdekében, hogy ne kelljen minden alkalommal megadnia a személyes hozzáférési jogkivonatát, amikor csomagot telepít a hírcsatornából, hozzáadhatja a hitelesítő adatait a pip.ini vagy a pip.conf fájlhoz. Győződjön meg arról, hogy nem ellenőrzi a személyes hozzáférési jogkivonatát egy nyilvános adattárban.

    Példa egy hitelesítő adatokkal rendelkező pip.ini vagy pip.conf fájlra:

    [global]
    extra-index-url=https://<FEED_NAME>:<YOUR_PERSONAL_ACCESS_TOKEN>@<FEED_URL>
    
  7. A csomag telepítéséhez futtassa a következő parancsot, amely <lecseréli a PACKAGE_NAME> a csomag nevére a hírcsatornából.

    pip install <PACKAGE_NAME>
    

Az erőforrások eltávolítása

Ha végzett a létrehozott erőforrásokkal, törölheti őket a díjak elkerülése érdekében. Amikor töröl egy projektet, az összes projektszintű összetevő hírcsatornája törlődik.

Projekt törlése:

  1. Válassza a Project Gépház lehetőséget.
  2. A Projekt részletei lapon válassza a Lap alján található Törlés lehetőséget.
  3. Adja meg a megerősítendő projekt nevét, majd válassza a Törlés lehetőséget.

Ha csak a hírcsatornát szeretné törölni:

  1. Válassza az Összetevők lehetőséget, és válassza ki a hírcsatornát a legördülő menüből.
  2. Válassza a Beállítások gombot.
  3. A Hírcsatorna beállításai lapon válassza a Hírcsatorna törlése lehetőséget.
  4. A megerősítéshez válassza a Törlés lehetőséget.

A helyi fejlesztési környezet megtisztításához:

  1. A virtuális környezet inaktiválásához futtassa a következő parancsot:

    deactivate
    
  2. A virtuális környezet törléséhez törölje azt a könyvtárat, amelyben létrehozta.

  3. Távolítsa el a fájlt a .pypirc kezdőkönyvtárból.

Ha klónozta a Python-mintacsomagot, törölheti az adattárat a helyi gépről és a GitHub-fiókjából.

Következő lépések