從命令行發佈

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

您可以使用適用於 Azure DevOps 的跨平臺 CLI （tfx-cli） 將擴充功能發佈至 Visual Studio Marketplace。

如需詳細資訊，請參閱發佈、安裝和共用的概觀。

必要條件

從節點 封裝管理員 取得 TFX CLI，併產生個人存取令牌 （PAT）。 此外，如果您尚未設定，請在資源庫中設定發行者。

取得適用於 Azure DevOps 的跨平臺 CLI

1. 如果您沒有它，請下載並安裝 NodeJS。 在設定期間，請確定您保留 [新增至 PATH ] 選擇。

2. 開啟命令提示字元並輸入 npm i -g tfx-cli。

如果您已安裝 TFX CLI，您可以執行 npm up -g tfx-cli來更新至最新版本。

建立個人存取權杖

1. 登入您的組織 (https:dev.azure.com/{organization})。

2. 從首頁開啟用戶設定圖示，然後選取 [配置檔]。

   

3. 在 [安全性] 底下，選取 [個人存取令牌]，然後選取 [新增令牌]。

   

4. 完成表單：

   • 為您的令牌命名
   • 選取 [所有可存取的組織]，這是透過 CLI 發佈時唯一可運作的值。 如果您只選取一個組織，即使 PAT 有效，也會導致錯誤
   • 選取令牌的到期時間範圍。 這是必要專案，因為Visual Studio Marketplace 發佈 API 在組織內容之外運作
   • 設定與此令牌相關聯的存取範圍。 請務必選取 Marketplace （publish） 範圍。 此範圍會將令牌限制為只能夠將擴充功能發佈至 Marketplace。
   • 選取 [建立]

   

5. 複製您產生的個人存取令牌。 請務必將它保密。

   

從命令行發佈

安裝 TFX CLI 並擁有 PAT 之後，您可以使用工具來封裝和發佈延伸模組。

1. 開啟命令提示字元至延伸模組的根目錄。
2. 執行下列命令來發佈延伸模組。 出現提示時，請輸入您的個人存取令牌進行驗證。

tfx extension publish --publisher <YOUR_PUBLISHER_ID> --manifest-js <YOUR_EXTENSION_MANIFEST> --share-with <ACCOUNT_NAME>

如果您的延伸模組已發行，您可能會收到下列錯誤：

Failed Request: Internal Server Error(500) - Version number must increase each time an extension is published. Extension: fabrikam.my-extension  Current version: 0.1.9  Updated version: 0.1.9

您可以新增 --rev-version 旗標，以自動遞增 延伸模組的修補程式 版本。 這也會將新版本儲存至您的指令清單。

注意

命令可使用createpublish的所有選項。

範例

C:\vso-team-calendar>tfx extension publish --publisher publishFabrikam --manifest-js fabrikam.config.js --share-with fabrikam --rev-version
Copyright Microsoft Corporation
> Personal access token:
Checking if this extension is already published
It is, update the extension
Waiting for server to validate extension package...
Sharing extension with fabrikam.

=== Completed operation: publish extension ===
 - Packaging: C:\vso-team-calendar\fabrikam.team-calendar-0.2.6.vsix
 - Publishing: success
 - Sharing: shared with fabrikam