開始使用 Azure Artifacts 中的 npm 套件

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

您可以使用 Azure Artifacts，從摘要和公用登錄發佈和下載 npm 套件，例如 npmjs.com。 本快速入門將逐步引導您完成建立摘要、設定專案，以及發佈和下載 Azure Artifacts 摘要的 npm 套件的程式。

建立摘要

摘要是一種組織建構，可讓用戶儲存其套件，並控制誰可以存取它們。 Azure Artifacts 支援將數個套件類型儲存在單一摘要中，例如 NuGet、npm、Maven、Python、Cargo 和通用套件。

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

2. 選取 [ 成品]，然後選取 [ 建立摘要 ] 以建立新的摘要。

3. 輸入摘要的描述性 名稱 ，並定義其 可見度 （指出誰可以在摘要內檢視套件）。 指定摘要的範圍，如果您想要包含來自公用來源的套件，請標示 [上游來源] 複選框。

4. 完成後，選取 [建立]。

   

注意

根據預設，新建立的摘要會將其專案的 [建置服務] 設定為 [摘要] 和 [上游讀取器] （共同作業者）。

設定 .npmrc 檔案

注意

vsts-npm-auth Azure DevOps Server 不支援。

我們建議使用兩個 .npmrc 檔案。 第一個應該位於與package.json檔案相同的目錄中。 第二個應該放在 $home 目錄 （Linux/macOS） 或 $env。HOME （Windows） 可安全地儲存您的認證。 npm 客戶端接著將能夠查閱此檔案，並擷取您的認證以進行驗證。 這可讓您在保護認證時共享組態檔。

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

2. 選取 [成品]，然後選取要摘要 連線。

3. 從左側瀏覽窗格中選取 npm 。 如果這是您第一次搭配 npm 使用 Azure Artifacts，請選取 [取得工具 ]，然後遵循步驟來下載Node.js並設定您的計算機。

4. 將下列代碼段插入 .npmrc 檔案中，該代碼段位於與package.json檔案相同的目錄中。 將佔位元取代為適當的值。

   • 組織範圍的摘要：

   registry=https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/ 
   
   always-auth=true
   

   • 專案範圍的摘要：

   registry=https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/ 
   
   always-auth=true
   

設定認證

重要

npm 支援 .npmrc 檔案中的單 registry 一。 範圍和上游來源可以有多個登錄。

Windows

如果您要在 Windows 上進行開發，建議您使用 vsts-npm-auth 向 Azure Artifacts 進行驗證。 請確定您已從取得工具安裝 vsts-npm-auth，然後執行 vsts-npm-auth，以取得新增至用戶層級 npmrc 檔案的 Azure Artifacts 令牌：

vsts-npm-auth -config .npmrc

其他

如果您要在非 Windows 平臺上進行開發，且需要向 Azure Artifacts 進行驗證，您需要建立個人存取令牌、在 Base 64 中編碼，然後將它新增至您的使用者層級 npmrc 檔案。

1. 使用封裝讀取和寫入範圍來產生個人存取令牌。

2. 編碼您新產生的個人存取令牌，如下所示：

   1. 在命令提示字元視窗中執行下列命令，以編碼 PAT：

      node -e "require('readline') .createInterface({input:process.stdin,output:process.stdout,historySize:0}) .question('PAT> ',p => { b64=Buffer.from(p.trim()).toString('base64');console.log(b64);process.exit(); })"
      

   2. 貼上您的個人存取令牌，然後按 Enter 鍵。

   3. 複製Base 64編碼的個人存取令牌。

3. 將下列代碼段複製到您的用戶層級 .npmrc 檔案， [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] 並將佔位元取代為您的Base 64個人存取令牌：

   • 組織範圍的摘要：

     ; begin auth token
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:username=[ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
     ; end auth token
     

   • 專案範圍的摘要：

     ; begin auth token
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
     ; end auth token
     

---

發佈套件

若要發佈 npm 套件，請在專案目錄中執行下列命令：

npm publish

重要

不支援在 publishConfig 發佈時間使用 屬性覆寫登錄組態參數。

還原套件

若要還原 npm 套件，請在您的項目目錄中執行下列命令：

npm install --save <package>

若要還原所有 npm 套件，請從專案目錄執行下列命令：

npm install

相關文章

• 發佈 npm 套件 （YAML/Classic）
• 使用來自 npmjs.com 的套件
• 使用 npm 範圍