Dela via

Skapa och publicera en Python-app

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

I den här snabbstarten skapar du en pipeline som skapar och testar en Python-app. Du ser hur du använder Azure Pipelines för att skapa, testa och distribuera Python-appar och -skript som en del av ditt SYSTEM för kontinuerlig integrering och kontinuerlig leverans (CI/CD).

Förutsättningar

Python är förinstallerat på agenter som är Microsoft-värdbaserade för Linux, macOS och Windows. Du behöver inte konfigurera något mer för att skapa Python-projekt. Information om vilka Python-versioner som är förinstallerade finns i Programvara.

Produkt Krav
Azure DevOps – Ett Azure DevOps-projekt.
– En möjlighet att köra pipelines på Microsoft-hanterade agenter. Du kan antingen köpa ett parallellt jobb eller begära en kostnadsfri nivå.
– Grundläggande kunskaper om YAML och Azure Pipelines. Mer information finns i Skapa din första pipeline.
- behörigheter:
     – Om du vill skapa en pipeline: du måste vara i gruppen Deltagare och gruppen måste ha behörigheten Skapa byggpipeline inställd på Tillåt. Medlemmar i gruppen Projektadministratörer kan hantera pipelines.
    – För att skapa tjänstanslutningar: Du måste ha rollen Administratör eller Skapare för tjänstanslutningar.
GitHub – Ett GitHub- konto.
– En GitHub-tjänstanslutning för att auktorisera Azure Pipelines.
Produkt Krav
Azure DevOps – Ett Azure DevOps-projekt.
– En lokalt installerad agent med Python 3.12 eller någon annan Python-version installerad. Information om hur du skapar en finns i Lokalt installerade agenter.
– Grundläggande kunskaper om YAML och Azure Pipelines. Mer information finns i Skapa din första pipeline.
- behörigheter:
    – Om du vill skapa en pipeline: du måste vara i gruppen Deltagare och gruppen måste ha behörigheten Skapa byggpipeline inställd på Tillåt. Medlemmar i gruppen Projektadministratörer kan hantera pipelines.
    – För att skapa tjänstanslutningar: Du måste ha rollen Administratör eller Skapare för tjänstanslutningar.
GitHub – Ett GitHub- konto.
– En GitHub-tjänstanslutning för att auktorisera Azure Pipelines.

Viktigt!

GitHub-procedurer kan kräva att du vidtar en eller flera av följande åtgärder i GitHub:

  • Logga in.
  • Auktorisera Azure Pipelines.
  • Autentisera till GitHub-organisationer.
  • Installera Azure Pipelines-appen.

Följ anvisningarna för att slutföra de processer som krävs. Mer information finns i Åtkomst till GitHub-lagringsplatser.

Förgrena exempelkoden

Förgrena Python-exempellagringsplatsen till ditt GitHub-konto.

  1. Gå till kodförrådet python-sample-vscode-flask-tutorial.
  2. Välj Förgrening längst upp till höger.
  3. Kontrollera att ditt GitHub-kontonamn har valts under Ägare och välj Skapa förgrening. Förgreningen heter samma som den överordnade lagringsplatsen som standard, men du kan ge den ett annat namn.

Skapa din pipeline

  1. I ditt Azure DevOps-projekt väljer du Pipelines i den vänstra navigeringsmenyn och väljer sedan Ny pipeline eller Skapa pipeline om den här pipelinen är den första i projektet.
  2. På skärmen Var är din kod väljer du GitHub som plats för källkoden.
  3. På skärmen Välj en lagringsplats väljer du din förgrenade Python-exempellagringsplats.
  4. På skärmen Konfigurera pipeline väljer du Startpipeline.

Anpassa ditt processflöde

På skärmen för att granska din YAML-pipeline, ersätt de genererade innehållet i azure-pipelines.yml-filen med följande kod. Koden utför följande åtgärder på tre olika versioner av Python:

  1. Installerar nödvändig Python-version och beroenden.
  2. Paket skapar artefakter till ett ZIP-arkiv.
  3. Publicerar arkivet till din pipeline.
  4. Utför tester.
trigger:
- main

pool:
  vmImage: ubuntu-latest

strategy:
  matrix:
    Python310:
      python.version: '3.10'
    Python311:
      python.version: '3.11'
    Python312:
      python.version: '3.12'

steps:
  - task: UsePythonVersion@0
    inputs:
      versionSpec: '$(python.version)'
    displayName: 'Use Python $(python.version)'

  - script: |
      python -m pip install --upgrade pip
      pip install -r requirements.txt
    displayName: 'Install dependencies'

  - task: ArchiveFiles@2
    displayName: 'Archive files'
    inputs:
      rootFolderOrFile: $(System.DefaultWorkingDirectory)
      includeRootFolder: false
      archiveType: zip
      archiveFile: $(Build.ArtifactStagingDirectory)/$(Build.BuildId)-$(python.version).zip
      replaceExistingArchive: true

  - task: PublishBuildArtifacts@1
    inputs:
      PathtoPublish: '$(Build.ArtifactStagingDirectory)'
      ArtifactName: 'drop'
      publishLocation: 'Container'

  - script: |
      pip install pytest pytest-azurepipelines
      pytest
    displayName: 'pytest'

På skärmen för att granska din YAML-pipeline, ersätt de genererade innehållet i azure-pipelines.yml-filen med följande kod. Koden utför följande åtgärder:

  1. Installerar nödvändig Python-version och beroenden.
  2. Paket skapar artefakter till ett ZIP-arkiv.
  3. Publicerar arkivet till din pipeline.
  4. Utför tester.

Anpassa azure-pipelines.yml för att matcha projektkonfigurationen.

  • Om du har en annan agentpool ersätter du platshållaren för poolen name med ditt poolnamn eller default.
  • Om det behövs ändrar du Python versionSpec till en version som är installerad på din lokalt installerade agent.
  trigger:
  - main

  pool: 
    name: '<your-pool-name or default>'

  steps:
  - task: UsePythonVersion@0
    inputs:
      versionSpec: '3.12'
    displayName: 'Use Python 3.12'  

  - script: |
      python -m pip install --upgrade pip
      pip install -r requirements.txt
    displayName: 'Install dependencies'


  - task: ArchiveFiles@2
    displayName: 'Archive files'
    inputs:
      rootFolderOrFile: $(System.DefaultWorkingDirectory)
      includeRootFolder: false
      archiveType: zip
      archiveFile: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip
      replaceExistingArchive: true

  - task: PublishBuildArtifacts@1
    inputs:
      PathtoPublish: '$(Build.ArtifactStagingDirectory)'
      ArtifactName: 'drop'
      publishLocation: 'Container'

  - script: |
      pip install pytest pytest-azurepipelines
      pytest
    displayName: 'pytest'

Kör din pipeline

Välj Spara och kör och välj Spara och kör igen. Du kan välja Jobb på skärmen Sammanfattning för att se hur jobbet fungerar.

Jobbet körs tre gånger, en gång för varje angiven Python-version. De tre versionerna kan köras parallellt på olika agenter.

Skärmbild av slutfört Python-jobb med flera versioner.

Skärmbild av slutfört enskilt Python-jobb.

Visa artefakter och testresultat

Om du vill visa dina byggartefakter väljer du länken [N] publicerad på fliken Sammanfattning .

Skärmdump av länken för publicerade kompileringsartefakter.

På sidan Artefakter visas publicerade byggartefakter.

Skärmbild av publicerade byggartefakter.

Skärmbild av publicerade byggartefakter för ett enda jobb.

Om du vill visa testresultaten väljer du fliken Tester .

Skärmbild av pipeline-testresultaten.

Rensa

Om du är klar med pipelinen du skapade kan du ta bort den.

  1. Välj Pipelines i projektets vänstra navigeringsmeny.

  2. Hovra över pipelinen du skapade i pipelinelistan, välj ikonen Fler åtgärder till höger och välj sedan Ta bort.

    Eller välj pipelinen och välj ikonen Fler åtgärder uppe till höger på pipelinesidan och välj sedan Ta bort.

  3. Ange pipelinenamnet och välj sedan Ta bort igen.

Du har skapat och kört en pipeline som har skapat och testat en Python-app. Nu kan du använda Azure Pipelines för att skapa, testa och distribuera Python-appar och -skript som en del av din CI/CD-process.

Nästa steg

Använd CI/CD för att distribuera en Python-webbapp till Azure App Service.

Relaterat innehåll