將 npm 項目連線至 Azure Artifacts

發行項
12/27/2024

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

Azure Artifacts 可讓開發人員管理來自各種來源的套件，包括像 npmjs.com 這樣的公共註冊表和私人源。若要向 Azure Artifacts 進行驗證，您必須設定 npm 組態檔。此檔案包含 npm 所使用的摘要 URL 和認證、提供自定義 npm 用戶端行為的選項，例如設定 Proxy、定義預設套件位置，或設定私人套件摘要。 .npmrc 檔案通常位於使用者的主目錄中，但也可以在專案層級建立以覆寫默認設定。

先決條件

Azure DevOps 組織。免費建立一個。
Azure DevOps 專案。如果您還沒有專案，請建立新的專案。
Azure Artifacts 供應來源。免費建立一個。
下載並安裝 Node.js 和 npm。

連接到訂閱源

Azure Artifacts 建議使用兩個不同的組態檔。第一個是專門用來向 Azure Artifacts 進行驗證，而第二個應該保留在本機以儲存您的認證。這種方法可讓您共用組態檔，同時保護您的認證。

若要設定第二個檔案，只要將它放在開發電腦上的主目錄中，並包含您的所有登錄認證即可。這可讓 npm 用戶端輕鬆地存取您的認證以進行驗證。

下列步驟將引導您設定第一個組態檔。選擇對應你的開發環境的索引標籤：

注意

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

Windows
Linux/MacOS

登入您的 Azure DevOps 組織，然後流覽至您的專案。
選取 [成品]，然後選取 [連接至 Feed]。
從左側邊欄中選取 [npm]。如果這是第一次搭配 npm 使用 Azure Artifacts，請確定您已安裝必要條件。
請遵循 專案設定 一節中的指示，連線到您的資料源。

將 .npmrc 檔案新增至專案的目錄中、與 package.json 檔案相同的目錄中，並將下列代碼段貼入其中。

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

always-auth=true

設定認證

複製下列代碼段，並將其貼到您的用戶層級 npmrc 檔案中：

組織範圍的資訊流：

; 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

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

在命令提示字元視窗中執行下列命令，然後在出現提示時貼上您的個人存取令牌。完成後，複製產生的Base 64編碼值。

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(); })"

如果您是在 Linux/Mac 上，您也可以使用下列命令，將個人存取令牌轉換成 Base 64。複製產生的Base64編碼值。
```
echo -n "YOUR_PERSONAL_ACCESS-TOKEN" | base64
```
將使用者 .npmrc 檔案中的佔位元 [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] 取代為從上一個步驟取得的編碼個人存取令牌。

Windows
Linux/MacOS

登入您的 Azure DevOps 集合，然後流覽至您的專案。
選取 [成品]，然後選取 [連線至提要]。
從左側提要欄位中選取 [npm]，然後依照 Project 安裝程式 區段中的指示來設定組態檔。

將 .npmrc 檔案新增至專案的目錄中、與 package.json 檔案相同的目錄中，並將下列代碼段貼入其中。
```
registry=http://<SERVER_NAME>/<COLLECTION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/

always-auth=true
```

設定認證

複製下列代碼段，並將其貼到您的用戶層級 .npmrc 檔案中：

集合範疇的訊息流：

; begin auth token
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=DefaultCollection
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/:username=DefaultCollection
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
; end auth token

專案範圍的資訊流：

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

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

在命令提示字元視窗中執行下列命令，然後在出現提示時貼上您的個人存取令牌。完成後，複製產生的Base 64編碼值。

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(); })"

將使用者 .npmrc 檔案中的佔位元 [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] 取代為從上一個步驟取得的編碼個人存取令牌。

Windows
Linux/MacOS

登入您的 Azure DevOps 集合，然後流覽至您的專案。
選取 [工件]，然後選取 [連線到提要]。
從左側選取 [npm]，然後依照 Project 安裝程式 中的指示設定組態檔。

將 .npmrc 檔案新增至專案的目錄中、與 package.json 檔案相同的目錄中，並將下列代碼段貼入其中：
```
registry=http://<SERVER_NAME>/<COLLECTION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/

always-auth=true
```

設定認證

複製下列代碼段，並將其貼到您的用戶層級 .npmrc 檔案中：

集合範圍的資訊流：

; begin auth token
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=DefaultCollection
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/:username=DefaultCollection
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
; end auth token

專案範圍的資訊流：

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

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

在命令提示字元視窗中執行下列命令，然後在出現提示時貼上您的個人存取令牌。完成後，複製產生的Base 64編碼值。

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(); })"

將使用者 .npmrc 檔案中的佔位元 [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] 用從上一個步驟取得的編碼個人存取令牌替換。

登入您的 Azure DevOps 集合，然後流覽至您的專案。
選取 [工件]，然後選取 [連線到饋送]。
隨即會出現新的視窗。從左側導航窗格中，選取 npm。
請遵循提供的指示來設定 專案的 .npmrc 檔案，以及 使用者的 .npmrc 檔案。

提示

在 .npmrc 檔案中，可以使用多個註冊表，並且支援範圍和上游來源。

管線驗證

若要進行管線驗證，Azure Artifacts 建議使用 npm 認證工作。

使用 gulp 或 Grunt 等工作執行器時，它會在管線開頭設定 npm 驗證工作的優先順序。此步驟可確保您的認證會插入您的專案的 .npmrc 檔案，並在整個管道運行過程中保留，使後續步驟能存取組態檔中的認證。

經典
YAML

流覽至您的項目，選取 [管線]，然後選取您的管線定義。
選取 [編輯 ]，以修改管線。
選取 [+]，將新工作新增至管線。

流覽至您的項目，選取 [管線>組建]，然後選取您的組建定義。
選擇編輯來修改您的組建管線。
選取 [+]，將新任務新增至您的建置管線。

搜尋 [npm Authenticate] 工作，然後選取 [Add]。
選取 .npmrc 檔案，然後完成後選取 儲存至佇列 &。

- task: npmAuthenticate@0
  inputs:
    workingFile: .npmrc                ## Path to the npmrc file
    customEndpoint: #Optional          ## Comma-separated list of npm service connection names for registries from external organizations. For registries in your org, leave this blank

注意

若要從您的管線存取 Feed，請確保建置服務角色已設定為 Feed 和上游讀取者（貢獻者），於設定的 Feed設定>許可權中。

顯示饋送設置中構建服務角色的螢幕快照。

注意

如果您的組織使用防火牆或 Proxy 伺服器，請確定您允許適當的網域 URL。如需詳細資訊，請參閱允許的IP位址和網域URL。

疑難排解

無法辨識 vsts-npm-auth

此錯誤表示 npm modules 資料夾尚未新增至您的路徑。重新執行 Node.js 設定，並確定選取 [Add to PATH] 選項。或者，您也可以將 path 變數修改為命令提示字元中的 %APPDATA%\npm，或在 PowerShell 中 $env:APPDATA\npm，將 npm modules 資料夾新增至您的路徑。

顯示如何設定 node.js的螢幕快照。

無法驗證

錯誤：代碼 E401 npm ERR！無法驗證： -> 使用 -F 旗標執行 vsts-npm-auth 命令，以重新驗證：
```
vsts-npm-auth -config .npmrc -F
```

重設 vsts-npm-auth

請遵循下列步驟來重設 vsts-npm-auth 認證：

移除 vsts-npm-auth：
```
npm uninstall -g vsts-npm-auth
```
清除 npm 快取：
```
npm cache clean --force
```
刪除 .npmrc 檔案。

重新安裝 vsts-npm-auth：

npm install -g vsts-npm-auth --registry https://registry.npmjs.com --always-auth false

無法發佈

如果您遇到 403 錯誤，則可能表示名稱衝突。在 Azure Artifacts 中，套件是不可變的，這表示一旦您將套件發佈至摘要，就會永久保留其版本號碼。即使您刪除它，也無法發佈具有相同版本號碼的新套件。若要解決此問題，請更新 package.json 檔案中的套件版本，然後再試一次。

共用方式為

將 npm 項目連線至 Azure Artifacts

先決條件

連接到訂閱源

設定認證

設定認證

設定認證

管線驗證

疑難排解

無法辨識 vsts-npm-auth

無法驗證

重設 vsts-npm-auth

無法發佈

意見反應

其他資源

共用方式為

將 npm 項目連線至 Azure Artifacts

先決條件

連接到訂閱源

管線驗證

疑難排解

無法辨識 vsts-npm-auth

無法驗證

重設 vsts-npm-auth

無法發佈

相關文章

意見反應

其他資源