Aan de slag met Python-pakketten in Azure Artifacts

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Met Behulp van Azure Artifacts kunt u pakketten publiceren en downloaden uit feeds en openbare registers, zoals PyPi. Deze quickstart begeleidt u bij het maken van een feed, het configureren van uw project en het beheren van Python-pakketten in uw Azure Artifacts-feed. In dit artikel leert u het volgende:

• Maak een nieuwe feed.
• Verifieer met uw feed.
• Python-pakketten publiceren.
• Installeer pakketten vanuit uw feed.

Voorwaarden

• Maak een Azure DevOps--organisatie en een project als u dat nog niet hebt gedaan.

• Download en installeer Python.

De code ophalen

1. Als u geen eigen Python-project hebt, kunt u het volgende Python-voorbeeldproject gebruiken:

   https://github.com/microsoft/python-package-template
   

2. Voer de volgende opdrachten uit in de projectmap om uw wiel- en brondistributie te bouwen:

   pip install --upgrade build
   python -m build
   

3. Als uw Python-project een setup.py-bestand heeft, kunt u deze opdracht ook gebruiken om uw pakket te bouwen:

   python setup.py sdist bdist_wheel
   

Een feed maken

1. Meld u aan bij uw Azure DevOps-organisatie en navigeer naar uw project.

2. Selecteer Artefacten selecteer vervolgens Feed maken.

3. Geef een Naam op voor uw feed, kies de optie Zichtbaarheid waarmee wordt gedefinieerd wie uw pakketten kan bekijken, controleer Pakketten opnemen uit gemeenschappelijke openbare bronnen als u pakketten uit bronnen zoals nuget.org of npmjs.comwilt opnemen, en voor Bereik, bepaalt u of de feed moet worden afgestemd op uw project of de hele organisatie.

4. Selecteer maken wanneer u klaar bent.

   

Notitie

Standaard hebben nieuw aangemaakte feeds de waarde van de Build Service van het project ingesteld op Feed en Upstream Reader (Samenwerker).

Verbinding maken met een feed

twine

1. Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.

2. Kies Artefacten, kies uw feed uit het vervolgkeuzemenu en kies vervolgens Verbinding maken met feed.

3. Selecteer twine onder de Python sectie.

4. Als dit de eerste keer is dat u Azure Artifacts met twine gebruikt, selecteert u De benodigde tools ophalen en volgt u de stappen om de benodigdheden te installeren.

5. Voeg een pypirc--bestand toe aan uw basismap en plak het opgegeven fragment. Het bestand moet er als volgt uitzien:

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

Notitie

Als uw .pypirc- bestand al referenties bevat voor de openbare PyPI-index, raden we u aan de sectie [pypi] te verwijderen om onbedoelde publicatie van privépakketten naar PyPI te voorkomen.

pip

1. Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.

2. Selecteer Artefacten, selecteer uw feed in de vervolgkeuzelijst en selecteer vervolgens Verbinden met feed.

3. Selecteer pip onder de sectie Python.

4. Als dit de eerste keer is dat u Azure Artifacts met pip gebruikt, selecteert u De hulpmiddelen ophalen en volgt u de stappen om de vereiste componenten te installeren.

5. Een virtuele omgeving maken.

6. Voeg een pip.ini-bestand (Windows) of pip.conf bestand (Mac/Linux) toe aan uw virtuele omgeving en plak het opgegeven fragment erin. Het bestand moet er ongeveer als volgt uitzien:

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

Pakketten publiceren

1. Voer deze opdracht uit in de projectmap om bron- en wieldistributies te maken:

   python setup.py sdist bdist_wheel
   
   

2. Voer de volgende opdracht uit om uw pakket te publiceren. Gebruik de vlag -r FEED_NAME om ervoor te zorgen dat uw privépakketten niet per ongeluk naar PyPI worden gepubliceerd.

   twine upload -r <FEED_NAME> dist/*
   

Pakketten installeren

1. Voer deze opdracht uit in de projectmap om uw pakketten te installeren:

   pip install
   

2. Als u een specifiek pakket wilt installeren, voert u de volgende opdracht uit en vervangt u de tijdelijke aanduiding door de pakketnaam uit uw feed.

   pip install <PACKAGE_NAME>
   

Volgende stappen

Pakketten uit De Python-pakketindex (PyPI) gebruikenUpstream-bronnen instellenPython-pakketten publiceren met Azure Pipelines