開始使用 Azure Artifacts 中的 Python 套件
Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019
您可以使用 Azure Artifacts,從提要和公用註冊表發佈和下載套件,例如 PyPi。 本快速入門將引導您建立摘要、設定專案,以及管理 Azure Artifacts 摘要中的 Python 套件。 在本文中,您將瞭解如何:
- 建立新的摘要。
- 使用您的資訊來源進行驗證。
- 發佈 Python 套件。
- 從您的來源安裝套件。
先決條件
取得程序代碼
如果您沒有自己的 Python 專案,您可以使用下列範例 Python 專案:
https://github.com/microsoft/python-package-template
若要建置 Python 套件的 wheel 和來源配佈,請在專案目錄中執行下列命令:
pip install --upgrade build python -m build
如果您的 Python 專案有 setup.py 檔案,您也可以使用此命令來建置套件:
python setup.py sdist bdist_wheel
建立資訊流
登入您的 Azure DevOps 組織,並流覽至您的專案。
選取 [工件],然後選取 [建立訂閱]。
為您的摘要提供名稱,選擇定義誰可以檢視您套件的可見性選項;如果您希望包含從nuget.org 或 npmjs.com等來源的套件,請勾選[包含來自一般公用來源的套件]。至於範圍,決定頻道應僅限於您的專案或整個組織。
完成時,請選取 建立。
登入您的 Azure DevOps 伺服器,然後移至您的專案。
選取 [成品],然後選取 [建立訂閱源]。
為您的摘要提供 名稱,選擇定義誰可以查看您套件的 Visibility 選項。如果您想要包含來自 nuget.org 或 npmjs.com等常見公用來源的套件,請勾選 [包含來自一般公共來源的套件]。針對 Scope,決定合集是應限制於您的專案還是整個組織。
完成時,請選取 建立。
完成時,請選取 [建立]。
登入您的 Azure DevOps 伺服器,然後移至您的專案。
選取 [工件],然後選取 [新增饋送]。
針對 Name,為您的供應輸入一個具有描述性的名稱。
針對 Visibility,請選取一個選項來指出誰可以在摘要內檢視套件。
如果您想要包含來自公用來源的套件,請選取 [透過此資料流從公用來源使用套件]。
完成時,請選取 [] 建立 []。
注意
根據預設,新建立的摘要會將其專案的 建置服務 值設定為 摘要和上游讀取器(共同作業者)。
連接到供稿
登入您的 Azure DevOps 組織,然後流覽至您的專案。
選取 [工件],從下拉功能表中選取您的訊息來源,然後選取 [連線至訊息來源]。
在 [Python] 區段底下,選取 [麻繩]。
如果這是您第一次使用 twine 搭配 Azure Artifacts,請選取 [取得工具],並遵循步驟來安裝必要條件。
將 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。
發佈套件
在專案目錄中執行此命令,以建立原始碼和 wheel 發行版本:
python setup.py sdist bdist_wheel
執行下列命令以發佈您的套件。 使用 -r FEED_NAME 旗標,以確保您的私人套件不會意外發佈至 PyPI。
twine upload -r <FEED_NAME> dist/*
安裝套件
在項目目錄中執行此指令以安裝您的套件:
pip install
若要安裝特定套件,請執行下列命令,將其中的佔位符替換為您來源中的套件名稱。
pip install <PACKAGE_NAME>