使用 Azure Pipelines 發佈 npm 套件 （YAML/Classic）

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

使用 Azure Pipelines，您可以將 npm 套件發佈至 Azure Artifacts 摘要和公用登錄，例如 npmjs.com。 本文將引導您使用 YAML 和傳統管線發佈 npm 套件。

必要條件

• Azure DevOps 組織。 免費建立一個。

• Azure DevOps 專案。 如果您還沒有專案，請建立新的 專案 。

• Azure Artifacts 摘要。 免費建立一個。

發佈至 Azure Artifacts 摘要

注意

若要使用 Azure Pipelines 將套件發佈至摘要，請確定專案集合組建服務和專案的建置服務身分識別都設定為摘要發行者（參與者）。 如需詳細資訊，請參閱 新增使用者/群組 。

YAML

- task: Npm@1
  inputs:
    command: publish
    publishRegistry: useFeed
    publishFeed: <FEED_NAME>        ## For project-scoped feeds, use: <PROJECT_NAME>/<FEED_NAME> 

• publishRegistry：選取 useFeed 以在組織內使用摘要。 選項： useExternalRegistry、 useFeed
• publishFeed：您要發佈至的摘要。 publishRegistry = useFeed 時為必要專案。

提示

使用 YAML 編輯器將 npm 工作新增至 YAML 管線時，系統會自動產生您 publishFeed 的專案和摘要標識碼。

傳統

1. 流覽至 Azure DevOps 入口網站，然後選取您的專案。

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

3. 選取 [ 編輯]，然後選取 + 要新增工作的符號。 搜尋 npm 工作，然後選取 [新增] 將它新增至您的管線。

   

4. 為您的工作命名，然後從命令下拉功能表中選取 [發佈 ]。 指定您的package.json路徑、登錄位置和目標登錄。

   • 包含package.json的工作資料夾：包含目標package.json和 .npmrc 檔案的資料夾路徑。 如果這些檔案位於存放庫的根目錄，請將此保留空白。
   • 登錄位置：選取 [登錄]，選取 [我在這裡 選取以發佈至摘要]。
   • 目標登錄：從下拉功能表中選取您的摘要。

   

發佈至公用登錄

將套件發佈至公用 npm 登錄之前，例如 npmjs.com，您必須先建立服務連線，以向所需的外部服務進行驗證。

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

2. 選取專案設定>服務連線 ，然後選取建立服務連線。

   

3. 選取 npm ，然後選取 [ 下一步]。 填寫必要的欄位，然後在完成時選取 [ 儲存 ]。

YAML

- task: Npm@1
  inputs:
    command: publish
    publishRegistry: useExternalRegistry
    publishEndpoint: '<NAME_OF_YOUR_SERVICE_CONNECTION>'

• publishRegistry：選取 useExternalRegistry 以發佈至公用登錄。 選項：useExternalRegistry |useFeed。
• publishEndpoint：將佔位元取代為您稍早建立的服務連線名稱。 當 publishRegistry == useExternalRegistry 時需要。

傳統

1. 流覽至 Azure DevOps 入口網站，然後選取您的專案。

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

3. 選取 [ 編輯]，然後選取 + 要新增工作的符號。 搜尋 npm 工作，然後選取 [新增] 將它新增至您的管線。

   

4. 為您的工作命名，然後從命令下拉功能表中選取 [發佈 ]。 指定您的package.json路徑、登錄位置和外部登錄。

   • 包含package.json的工作資料夾：包含目標package.json和 .npmrc 檔案的資料夾路徑。 如果這些檔案位於存放庫的根目錄，請將此保留空白。
   • 登錄位置：選取 [外部 npm 登錄 ] 以發佈至公用登錄，例如 npmjs.com。
   • 外部登錄：選取您稍早建立的服務連線。

   

相關文章

• 從命令行發佈和還原 npm 套件。
• 使用來自 npmjs.com 的套件。
• 發佈和下載管線成品。