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

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

I den här snabbstarten lär du dig hur du skapar ett Azure Artifacts-flöde och använder ditt flöde för att publicera och använda Python-paket från kommandoraden i din lokala utvecklingsmiljö. När du är klar har du ett Python-paket publicerat i feeden och installerat från feeden till din lokala utvecklingsmiljö.

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 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 med följande kommando med hjälp av URL:en som du kopierade från din förgrenade lagringsplats:

   git clone <REPOSITORY_URL>
   

6. Ändra katalogen 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

Skapa en feed

Publicera paketet i feeden

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 --config-file argumentet .

   twine upload --repository <FEED_NAME> dist/*
   

Installera ett paket från feeden

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]
   extra-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>
   

Rensa resurser

När du är klar med de resurser som du har skapat kan du ta bort dem för att undvika avgifter. När du tar bort ett projekt tas alla artefakter på projektnivå bort.

Så här tar du bort ett projekt:

1. Välj Projekt Inställningar.
2. På sidan Projektinformation väljer du Ta bort längst ned på sidan.
3. Ange namnet på projektet som ska bekräftas och välj sedan Ta bort.

Om du bara vill ta bort feeden:

1. Välj Artefakter och välj din feed från den nedrullningsbara menyn.
2. Välj inställningsknappen.
3. På fliken Flödesinställningar väljer du Ta bort feed.
4. Välj Ta bort för att bekräfta.

Så här rensar du din lokala utvecklingsmiljö:

1. Om du vill inaktivera den virtuella miljön kör du följande kommando:

   deactivate
   

2. Ta bort den virtuella miljön genom att ta bort katalogen där den skapades.

3. .pypirc Ta bort filen från din hemkatalog.

Om du klonade Python-exempelpaketet kan du ta bort lagringsplatsen från din lokala dator och ditt GitHub-konto.

Nästa steg

• Använda flödesvyer för att dela paket

• Publicera Python-paket med Azure Pipelines

• Skapa Python-appar

Relaterade artiklar

• Nyckelring för artefakter

• Virtuell Python-miljö