Publicera och använda Python-paket med hjälp av kommandoraden (CLI)

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

Med Azure Artifacts kan du skapa, vara värd för och dela Python-paket med ditt team eller din organisation. Du kan publicera och använda Python-paket med hjälp av en Azure Artifacts-feed från kommandoraden i din lokala utvecklingsmiljö.

I den här artikeln lär du dig hur du:

• Skapa en Azure Artifacts-feed.
• Konfigurera autentisering med antingen Python artifacts-keyring-paketet eller en personlig åtkomsttoken (PAT).
• Publicera Python-paket i feeden.
• Använda Python-paket från feeden.

Information om hur du publicerar och använder paket i azure-pipelines finns i Publicera Python-paket med Azure Pipelines.

Förutsättningar

Om du vill köra följande steg måste du ha:

Skapa en Azure Artifacts-feed

Om du inte har någon feed använder du följande steg för att skapa en.

Skapa ett lokalt Python-paket

Du behöver ett Python-paket för att publicera till feeden. Om du inte har något paket att publicera kan du klona ett Python-exempelpaket från GitHub.

Klona Python-exempelpaketet

Använd följande steg för att använda Python-exempelpaketet från GitHub.

1. Gå till följande GitHub-lagringsplats:

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

2. Förgrena lagringsplatsen till ditt GitHub-konto.

3. Gå till din förgrenade lagringsplats och välj Kod.

4. Kopiera URL:en för din förgrenade lagringsplats.

5. Från en CLI på den lokala datorn klonar du lagringsplatsen till den lokala datorn med hjälp av url:en som du kopierade från din förgrenade lagringsplats.

   git clone <REPOSIORY_URL>
   

6. Ändra katalog till den klonade lagringsplatsen.

   cd python-package-template
   

Skapa ditt paket

Om du vill skapa hjul- och källdistributionen kör du följande kommandon i projektkatalogen:

pip install --upgrade build
python -m build

Om Python-projektet har en setup.py fil kan du använda följande kommando för att skapa paketet:

python setup.py sdist bdist_wheel

Anslut att mata

Det finns två huvudsakliga sätt att ansluta till en feed för att publicera eller använda dina Python-paket:

1. Använd paketet artifacts-keyring som automatiskt konfigurerar autentisering åt dig.
2. Konfigurera autentiseringsuppgifter manuellt med en PAT.

Konfigurera artifacts-keyring för autentisering

Paketet artifacts-keyring fungerar med Python-nyckelringspaketet så att du kan konfigurera autentisering för att publicera och använda dina Python-paket till och från ditt flöde. Både pip och twine använder Python-nyckelringspaketet för att hitta autentiseringsuppgifter.

Om du väljer att använda artifacts-keyring måste du installera paketet innan du kan använda det.

I ett fönster med upphöjd kommandotolk kör du följande kommando för att installera paketet artifacts-keyring:

pip install artifacts-keyring

Publicera Python-paket

Du kan publicera Python-paket i feeden med hjälp av paketet artifacts-keyring eller PAT-autentisering.

Publicera paket med artifacts-keyring

1. Välj Anslut som ska matas från feeden.

   

2. Välj twine och kopiera lagringsplatsens URL från avsnittet Projektkonfiguration .

   

3. Om du vill publicera ett paket i feeden kör du följande kommando för att <ersätta FEED_URL> med lagringsplatsens URL som du kopierade från Anslut för att mata dialogrutan:

   twine upload --repository-url <FEED_URL> dist/*
   

Publicera paket med PAT-autentisering

Använd twine för att ladda upp paketet till din Azure Artifacts-feed.

1. Gå till ditt Azure DevOps-projekt och välj Artefakter.

2. Välj din feed och välj Anslut som ska matas.

   

3. Välj tvilling under avsnittet Python .

   

4. Kontrollera att tvillingen är installerad på utvecklingsdatorn.

   pip install --upgrade twine
   

5. Följ anvisningarna i avsnittet Project setup (Projektkonfiguration) för att konfigurera .pypirc filen.

   

6. För att undvika att behöva ange din personliga åtkomsttoken varje gång du publicerar ett paket kan du lägga till dina autentiseringsuppgifter i .pypirc filen. Kontrollera att du inte kontrollerar din personliga åtkomsttoken till en offentlig lagringsplats.

   Exempel på en .pypirc fil med autentiseringsuppgifter:

   [distutils]
   Index-servers =
       <FEED_NAME>
   
   [<FEED_NAME>]
   Repository = <FEED_URL>
   username = <FEED_NAME>
   password = <YOUR_PERSONAL_ACCESS_TOKEN>
   

7. Om du vill ladda upp paketet kör du följande kommando i projektkatalogen och <ersätter FEED_NAME> med ditt flödesnamn. I Windows kan du behöva ange pypirc filplatsen med alternativet --config-file .

   twine upload --repository <FEED_NAME> dist/*
   

Använda Python-paket

Du kan använda Python-paket från flödet med hjälp av paketet artifacts-keyring eller PAT-autentisering.

Använda paket med artifacts-keyring

1. I projektet väljer du Artefakter och sedan din feed.

2. Välj Anslut som ska matas.

   

3. Välj pip under avsnittet Python .

   

4. Förbered din lokala Python-miljö.

   • Windows
   • Linux och macOS

   1. Kontrollera att pip är installerat och uppdaterat:

      python -m pip install --upgrade pip
      

   2. Så här skapar och aktiverar du en virtuell Python-miljö:

      python -m venv myenv
      myenv/Scripts/activate
      

5. index-url Kopiera från avsnittet Projektkonfiguration i dialogrutan Anslut för att mata in.

   

6. Om du vill installera ett paket från feeden kör du följande kommando och <ersätter PACKAGE_NAME> med paketnamnet från feeden och <INDEX_URL> med index-URL:en som du kopierade från Anslut för att mata dialogrutan:

   pip install <PACKAGE_NAME> --index-url <INDEX_URL>
   

När du ansluter till Azure DevOps för första gången uppmanas du att ange autentiseringsuppgifter. Ange ditt användarnamn (valfri sträng) och din personliga åtkomsttoken i lämpliga fält. Autentiseringsuppgifterna cachelagras lokalt och används för att automatiskt logga in dig nästa gång du använder tjänsten.

Använda paket med PAT-autentisering

1. Gå till ditt Azure DevOps-projekt och välj Artefakter.

2. Välj din feed och välj Anslut som ska matas.

   

3. Välj pip under avsnittet Python .

   

4. Förbered din lokala Python-miljö.

   • Windows
   • Linux och macOS

   1. Kontrollera att pip är installerat och uppdaterat:

      python -m pip install --upgrade pip
      

   2. Skapa och aktivera en virtuell Python-miljö:

      python -m venv myenv
      myenv/Scripts/activate
      

5. Lägg till en pip.ini (Windows) eller en pip.conf-fil (Mac/Linux) i rotkatalogen i den virtuella miljön. Kopiera innehållet från avsnittet Project setup i Anslut för att mata dialogrutan och lägga till det i din pip.ini- eller pip.conf-fil.

   

6. För att undvika att behöva ange din personliga åtkomsttoken varje gång du installerar ett paket från feeden kan du lägga till dina autentiseringsuppgifter i filen pip.ini eller pip.conf . Kontrollera att du inte kontrollerar din personliga åtkomsttoken till en offentlig lagringsplats.

   Exempel på en pip.ini - eller pip.conf-fil med autentiseringsuppgifter:

   [global]
   index-url=https://<FEED_NAME>:<YOUR_PERSONAL_ACCESS_TOKEN>@<FEED_URL>
   

7. Installera paketet genom att köra följande kommando och <ersätta PACKAGE_NAME> med paketnamnet från feeden.

   pip install <PACKAGE_NAME>
   

Relaterade artiklar

• Konfigurera behörigheter
• Förstå överordnade källor
• Publicera Python-paket med Azure Pipelines