使用 Azure Pipelines 發佈 Python 套件

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

開發人員可以使用 Azure Pipelines 將 Python 套件發佈至 Azure Artifacts 摘要、公用登錄，或將它們儲存為管線成品。 本文將引導您瞭解如何：

• 安裝必要條件
• 連線 至 Azure Artifacts 摘要
• 將 Python 套件發佈至 Azure Artifacts 摘要

必要條件

• Azure DevOps 組織和專案。 如果您尚未建立組織或專案。

• Azure Artifacts 摘要。 如果您還沒有摘要，請建立摘要 。

使用 Azure Artifacts 進行驗證

若要用來 twine 發佈 Python 套件，您必須先向 Azure Artifacts 摘要進行驗證。 TwineAuthenticate 工作會將對應項認證PYPIRC_PATH提供給環境變數。 接著會使用twine 這個變數，協助您直接從管線發佈套件。

YAML

- task: TwineAuthenticate@1
  inputs:
    artifactFeed: <PROJECT_NAME/FEED_NAME>     ## For an organization-scoped feed, artifactFeed: <FEED_NAME>

傳統

1. 登入您的 Azure DevOps 組織，然後瀏覽至您的專案。

2. 選取 [管線]、選取您的管線定義，然後選取 [ 編輯]。

3. +選取符號以新增工作。 搜尋 Python 對應項上傳驗證工作，然後選取 [新增] 將它新增至您的管線。

4. 從 [我的摘要名稱] 下拉功能表中選取您的摘要，如果您想要向組織外部摘要進行驗證，請從外部組織選取摘要。

   

重要

儲存在環境變數中的 PYPIRC_PATH 認證會取代您 .ini 和 .conf 檔案中的認證。

如果您在管線的不同階段新增多個 TwineAuthenticate 工作，則每個額外的工作執行都會擴充現有的PYPIRC_PATH環境變數（而非覆寫）。

將 Python 套件發佈至 Azure Artifacts 摘要

YAML

- script: |
    pip install build
    pip install twine
  displayName: 'Install build and twine'

- script: |
    python -m build -w
  displayName: 'Python build'

- task: TwineAuthenticate@1
  inputs:
    artifactFeed: <PROJECT_NAME/FEED_NAME>
  displayName: 'Twine Authenticate'

- script: |
    python -m twine upload -r <FEED_NAME> --config-file $(PYPIRC_PATH) dist/*.whl
  displayName: 'Upload to feed'

傳統

1. 登入您的 Azure DevOps 組織，然後瀏覽至您的專案。

2. 選取 [管線]、選取您的管線定義，然後選取 [ 編輯]。

3. +選取符號以新增工作。 搜尋 [使用 Python 版本] 工作，然後選取 [新增] 將它新增至您的管線。 在此範例中，我們將版本規格設定為 >= 3.7。

4. +選取符號以新增工作。 搜尋命令行工作，然後選取 [新增] 將它新增至您的管線。 在 [腳稿] 文字框中貼上下列命令，以在代理程式上安裝組建和對應項：

   pip install build
   pip install twine
   

5. +選取符號以新增工作。 搜尋命令行工作，然後選取 [新增] 將它新增至您的管線。 在 [腳稿] 文字框中貼上下列命令，以建置您的專案：

   python -m build -w
   

6. +選取符號以新增工作。 搜尋 Twine 驗證工作，然後選取 [新增] 將它新增至您的管線。 從 [ 我的摘要名稱] 下拉功能表中選取您的摘要。

7. +選取符號以新增工作。 搜尋命令行工作，然後選取 [新增] 將它新增至您的管線。 在 [腳本] 文本框中貼上下列命令，將套件發佈至摘要，並將佔位元取代為您的摘要名稱：

   python -m twine upload -r <FEED_NAME> --config-file $(PYPIRC_PATH) dist/*.whl
   

   

注意

若要使用 Azure Pipelines 將套件發佈至摘要， 專案集合組建服務和 專案的 建置服務 身分識別都必須 在摘要設定中指派摘要發行者（參與者） 角色。 如需詳細資訊，請參閱 管理許可權 。

相關文章

• 發佈和下載 Python 套件 CLI
• 在上游來源中搜尋套件
• 設定權限