共用方式為


開始使用 Azure Artifacts 中的 Python 套件

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

您可以使用 Azure Artifacts,從提要和公用註冊表發佈和下載套件,例如 PyPi。 本快速入門將引導您建立摘要、設定專案,以及管理 Azure Artifacts 摘要中的 Python 套件。 在本文中,您將瞭解如何:

  • 建立新的摘要。
  • 使用您的資訊來源進行驗證。
  • 發佈 Python 套件。
  • 從您的來源安裝套件。

先決條件

  • 如果您尚未建立 Azure DevOps 組織專案,請先進行建立。

  • 下載並安裝 Python

取得程序代碼

  1. 如果您沒有自己的 Python 專案,您可以使用下列範例 Python 專案:

    https://github.com/microsoft/python-package-template
    
  2. 若要建置 Python 套件的 wheel 和來源配佈,請在專案目錄中執行下列命令:

    pip install --upgrade build
    python -m build
    
  3. 如果您的 Python 專案有 setup.py 檔案,您也可以使用此命令來建置套件:

    python setup.py sdist bdist_wheel
    

建立資訊流

  1. 登入您的 Azure DevOps 組織,並流覽至您的專案。

  2. 選取 [工件],然後選取 [建立訂閱]。

  3. 為您的摘要提供名稱,選擇定義誰可以檢視您套件的可見性選項;如果您希望包含從nuget.orgnpmjs.com等來源的套件,請勾選[包含來自一般公用來源的套件]。至於範圍,決定頻道應僅限於您的專案或整個組織。

  4. 完成時,請選取 建立

    顯示在 Azure DevOps Services 中建立新摘要之選取項目的螢幕快照。

  1. 登入您的 Azure DevOps 伺服器,然後移至您的專案。

  2. 選取 [成品],然後選取 [建立訂閱源]。

  3. 為您的摘要提供 名稱,選擇定義誰可以查看您套件的 Visibility 選項。如果您想要包含來自 nuget.orgnpmjs.com等常見公用來源的套件,請勾選 [包含來自一般公共來源的套件]。針對 Scope,決定合集是應限制於您的專案還是整個組織。

  1. 完成時,請選取 建立

    螢幕快照,顯示在 Azure DevOps 2022 中建立新饋送的選項。

  1. 完成時,請選取 [建立]。

    螢幕快照,顯示在 Azure DevOps 2020 中建立新資訊摘要的選項。

  1. 登入您的 Azure DevOps 伺服器,然後移至您的專案。

  2. 選取 [工件],然後選取 [新增饋送]。

  3. 針對 Name,為您的供應輸入一個具有描述性的名稱。

    針對 Visibility,請選取一個選項來指出誰可以在摘要內檢視套件。

    如果您想要包含來自公用來源的套件,請選取 [透過此資料流從公用來源使用套件]

  4. 完成時,請選取 [] 建立 []。

    螢幕快照,顯示在 Azure DevOps 2019 中建立新摘要的選項。

注意

根據預設,新建立的摘要會將其專案的 建置服務 值設定為 摘要和上游讀取器(共同作業者)

連接到供稿

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

  2. 選取 [工件],從下拉功能表中選取您的訊息來源,然後選取 [連線至訊息來源]。

  3. 在 [Python] 區段底下,選取 [麻繩]。

  4. 如果這是您第一次使用 twine 搭配 Azure Artifacts,請選取 [取得工具],並遵循步驟來安裝必要條件。

  5. pypirc 檔案新增至主目錄,並貼上所提供的代碼段。 您的檔案看起來應該像這樣:

    [distutils]
    Index-servers =
        FEED_NAME
    
    [FEED_NAME]
    Repository = https://pkgs.dev.azure.com/ORGANIZATION_NAME/PROJECT_NAME/_packaging/FEED_NAME/pypi/upload/
    

注意

如果您的 .pypirc 檔案已經包含公用 PyPI 索引的認證,建議您移除 [pypi] 區段,以避免意外將私人套件發行至 PyPI。

發佈套件

  1. 在專案目錄中執行此命令,以建立原始碼和 wheel 發行版本:

    python setup.py sdist bdist_wheel
    
    
  2. 執行下列命令以發佈您的套件。 使用 -r FEED_NAME 旗標,以確保您的私人套件不會意外發佈至 PyPI。

    twine upload -r <FEED_NAME> dist/*
    

安裝套件

  1. 在項目目錄中執行此指令以安裝您的套件:

    pip install
    
  2. 若要安裝特定套件,請執行下列命令,將其中的佔位符替換為您來源中的套件名稱。

    pip install <PACKAGE_NAME>
    

後續步驟

使用 Python 套件索引 (PyPI) 中的套件使用 Azure Pipelines 設定上游來源發佈 Python 套件