Pakketten gebruiken uit de Python-pakketindex (PyPI)

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

Met Azure Artifacts kunnen ontwikkelaars één feed gebruiken om hun eigen pakketten en pakketten te hosten die zijn geïnstalleerd vanuit openbare registers, zoals PyPI.org. Wanneer upstream-bronnen zijn ingeschakeld, slaat Azure Artifacts automatisch een kopie op van elk pakket dat is geïnstalleerd vanuit een upstream-bron door een samenwerker of hoger. Dit artikel begeleidt u bij het instellen van uw project en het gebruik van de opdrachtregel om Python-pakketten uit de Python Package Index (PyPI) te gebruiken.

Vereisten

Een nieuwe feed maken en openbare upstreams toevoegen

Als u nog geen feed hebt, volgt u de onderstaande stappen om er een te maken en Upstream-bronnen in te schakelen. Ga anders verder met de volgende stap om PyPI toe te voegen als een upstream-bron.

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

2. Selecteer Artefacten en selecteer vervolgens Feed maken.

3. Voer een beschrijvende naam in voor uw feed en stel de zichtbaarheid ervan in. Geef het bereik op en schakel vervolgens het selectievakje Upstream-bronnen in om pakketten uit openbare registers op te nemen.

4. Selecteer Maken wanneer u klaar bent.

   

PyPI upstream toevoegen

Als u Upstream-bronnen hebt ingeschakeld bij het maken van uw feed, zou PyPI automatisch moeten worden toegevoegd als een upstream-bron. Anders kunt u deze handmatig toevoegen door de volgende stappen uit te voeren:

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

2. Selecteer Artefacten en selecteer het om Feedinstellingen te openen.

3. Selecteer Upstream-bronnen en selecteer Vervolgens Upstream toevoegen.

4. Selecteer Openbare bron en kies vervolgens PyPI (https://pypi.org/) in de vervolgkeuzelijst.

5. Selecteer Toevoegen en selecteer vervolgens Opslaan in de rechterbovenhoek om uw wijzigingen toe te passen.

Verifiëren met uw feed

Zorg ervoor dat u Python hebt geïnstalleerd op basis van de vereisten en voer vervolgens de volgende stappen uit om verbinding te maken met uw feed:

1. Voer de volgende opdracht uit om uw Python-pakketbeheer bij te werken:

   python -m pip install --upgrade pip
   

2. Voer de volgende opdracht uit om de Azure Artifacts-sleutelring te installeren:

   pip install keyring artifacts-keyring
   

3. Maak een persoonlijk toegangstoken met de scope Packaging>Lezen om te verifiëren met Azure DevOps. De eerste keer dat u verbinding maakt met Azure DevOps, wordt u gevraagd om referenties. Voer een waarde in voor de gebruikersnaam en gebruik uw PAT als wachtwoord. Deze referenties worden lokaal in de cache opgeslagen en opnieuw gebruikt wanneer u zich de volgende keer verifieert.

4. Navigeer naar uw projectmap en maak vervolgens een virtuele omgeving:

   python -m venv <VIRTUAL_ENVIRONMENT_NAME>
   

5. Maak in uw virtuele omgeving een pip.ini bestand (Windows) of een pip.conf-bestand (macOS/Linux) en voeg vervolgens het volgende fragment toe. Vervang de tijdelijke aanduidingen door de juiste waarden. Voer dit bestand niet door naar een openbare opslagplaats, omdat het uw persoonlijke toegangstoken bevat.

   • Projectgebaseerde feed

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

   • Feed voor de gehele organisatie:

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

Pakketten installeren vanuit PyPI

Nu u bent geverifieerd met uw feed, kunt u pakketten installeren vanuit de PyPI upstream zoals u normaal gesproken zou doen met pip. Elk pakket dat u installeert, wordt automatisch opgeslagen in uw Azure Artifacts-feed.

In dit voorbeeld installeert u aanvragen, een populaire HTTP-bibliotheek voor Python.

1. Open een opdrachtprompt en navigeer naar uw projectmap en activeer vervolgens uw virtuele omgeving. Vervang de tijdelijke aanduiding door de naam van de virtuele omgeving die u eerder hebt gemaakt:

   <YOUR_VIRTUAL_ENVIRONMENT_NAME>/Scripts/Activate
   

2. Voer de volgende opdracht uit om het aanvraagpakket vanuit PyPI te installeren.

   pip install requests
   

3. Zodra de installatie is voltooid, slaat Azure Artifacts een kopie van het pakket op in uw feed. Navigeer naar uw feed om te controleren of het pakket beschikbaar is, zoals wordt weergegeven in de volgende schermopname.

   

Verwante inhoud

• Python-pakketten (CLI) publiceren

• Upstream-bronnen gebruiken in een openbare feed

• Python-pakketten publiceren met Azure Pipelines