Azure Artifacts での npm パッケージの概要

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

Azure Artifacts を使用すると、npmjs.com などのフィードやパブリック レジストリから npm パッケージを発行およびダウンロードできます。 このクイック スタートでは、フィードの作成、プロジェクトの構成、Azure Artifacts フィードとの間での npm パッケージの発行とダウンロードのプロセスについて説明します。

フィードの作成

フィードは、ユーザーがパッケージを格納し、アクセスできるユーザーを制御できるようにする組織の構成要素です。 Azure Artifacts では、NuGet、npm、Maven、Python、Cargo、Universal パッケージなど、複数のパッケージの種類を 1 つのフィードに格納できます。

1. Azure DevOps 組織にサインインしてから、プロジェクトに移動します。

2. [成果物] を選択し、[フィードの作成] を選択して新しいフィードを作成します。

3. フィードのわかりやすい 名前 を入力し、その 可視性 を定義します (フィード内でパッケージを表示できるユーザーを示します)。 フィードのスコープを指定し、パブリック ソースのパッケージを含める場合は、[アップストリーム ソース] チェックボックスにマークを付けます。

4. 終わったら [作成] を選択します。

   

Note

既定では、新しく作成されたフィードには、プロジェクトのビルド サービスが Feed と Upstream Reader (コラボレーター) に設定されています。

.npmrc ファイルを設定する

Note

vsts-npm-auth は Azure DevOps Server ではサポートされていません。

2 つの .npmrc ファイルを使用することをお勧めします。 最初のディレクトリは、package.json ファイルと同じディレクトリに配置する必要があります。 2 つ目は、$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 ファイル内の 1 つ 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/クラシック)
• npmjs.com のパッケージを使用する
• npm スコープを使用する