建置 Python 應用程式

發行項
04/04/2024

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

您可以使用 Azure Pipelines 來建置、測試及部署 Python 應用程式和腳本，作為 CI/CD 系統的一部分。

在本快速入門中，您將瞭解如何建立管線來建置及測試 Python 應用程式。

您不需要為 Azure Pipelines 設定任何專案，即可建置 Python 專案。 Python 已預安裝在適用於 Linux、macOS 或 Windows 的 Microsoft 裝載組建代理程式上。若要查看哪些 Python 版本已預安裝，請參閱使用 Microsoft 裝載的代理程式。

必要條件

您可以在其中建立存放庫的 GitHub 帳戶。免費建立一個。
Azure DevOps 組織。免費建立一個。
Azure DevOps 專案。使用 Azure DevOps 專案建立精靈建立一個。
能夠在 Microsoft 裝載的代理程式上執行管線。您可以購買平行作業，也可以要求免費層。

您可以在其中建立存放庫的 GitHub 帳戶。免費建立一個。
Azure DevOps Server。
Azure DevOps 專案。使用 Azure DevOps Server 專案建立精靈建立一個。
自我裝載代理程式。若要建立一個代理程式，請參閱自我裝載代理程式。
安裝在自我裝載代理程式上的 Python 版本。若要瞭解如何在代理程式上安裝 Python，請參閱 UsePythonVersion。

1.派生範例程序代碼

將範例 Python 存放庫分支至您的 GitHub 帳戶。

移至 python-sample-vscode-flask-tutorial 存放庫。
選取 頁面右上角的 [分支 ]。
選取您要派生存放庫的 GitHub 帳戶，然後輸入分支存放庫的名稱。

2.建立管線

移至 [Azure Pipelines] ，然後選取 [ 免費啟動]。如果出現提示，請登入您的DevOps帳戶。
移至您的項目，然後選取 [管線>建立管線]。
選取 [GitHub ] 作為原始程式碼的位置。
如果您重新導向至 GitHub 以登入，請輸入您的 GitHub 認證。
當存放庫清單出現時，請選取分支範例存放庫。
在 [ 設定管線] 索引卷標上，選取 [ 入門管線]。

在瀏覽器中，移至您的DevOps Server集合。
移至您的項目，然後選取 [管線>建立新的管線]。
選取 [GitHub Enterprise Server ] 作為原始程式碼的位置。
如果您重新導向至 GitHub 以登入，請輸入您的 GitHub 認證。
當存放庫清單出現時，請選取分支範例存放庫。
在 [ 設定管線] 索引卷標上，選取 [ 入門管線]。

3.自定義管線

以下列程式代碼取代產生的azure-pipelines.yml檔案內容。此程式代碼會安裝必要的 Python 版本和相依性、將 Python 套件封裝至發佈至管線的 zip 檔案，以及執行測試。

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'

azure-pipelines.yml自定義以符合項目組態。

以下列程式代碼取代產生的 YAML。此程式代碼會安裝必要的 Python 版本和相依性、將 Python 套件封裝至發佈至管線的 zip 檔案，以及執行測試。
如果您有不同的代理程式集區，請變更 pool name 參數。
變更 Python 版本，以符合您自我裝載代理程式上安裝的版本。

  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'