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 つのフィードに格納できます。
Azure DevOps 組織にサインインしてから、プロジェクトに移動します。
[成果物] を選択し、[フィードの作成] を選択して新しいフィードを作成します。
フィードのわかりやすい 名前 を入力し、その 可視性 を定義します (フィード内でパッケージを表示できるユーザーを示します)。 フィードのスコープを指定し、パブリック ソースのパッケージを含める場合は、[アップストリーム ソース] チェックボックスにマークを付けます。
終わったら [作成] を選択します。
Azure DevOps サーバーにサインインし、プロジェクトに移動します。
[成果物] を選択し、[フィードの作成] を選択して新しいフィードを作成します。
フィードのわかりやすい 名前 を入力し、その 可視性 を定義します (フィード内でパッケージを表示できるユーザーを示します)。 フィードのスコープを指定し、パブリック ソースのパッケージを含める場合は、[アップストリーム ソース] チェックボックスにマークを付けます。
終わったら [作成] を選択します。
終わったら [作成] を選択します。
Azure DevOps サーバーにサインインし、プロジェクトに移動します。
[成果物] を選択し、[新しいフィード] を選択します。
フィードのわかりやすい 名前 を入力し、その 可視性 を定義します (フィード内でパッケージを表示できるユーザーを示します)。 パブリック ソースのパッケージを含める場合は、[このフィードを使用してパブリック ソースのパッケージを使用する] オプションを選択します。
終わったら [作成] を選択します。
Note
既定では、新しく作成されたフィードには、プロジェクトのビルド サービスが Feed と Upstream Reader (コラボレーター) に設定されています。
.npmrc ファイルを設定する
Note
vsts-npm-auth
は Azure DevOps Server ではサポートされていません。
2 つの .npmrc ファイルを使用することをお勧めします。 最初のディレクトリは、package.json ファイルと同じディレクトリに配置する必要があります。 2 つ目は、$home ディレクトリ (Linux/macOS) または$envに配置する必要があります。HOME (Windows) を使用して資格情報を安全に保存します。 npm クライアントは、このファイルを検索し、認証のために資格情報をフェッチできるようになります。 これにより、資格情報をセキュリティで保護しながら、構成ファイルを共有できます。
Azure DevOps 組織にサインインしてから、プロジェクトに移動します。
[成果物] を選択し、[フィードに接続] を選択します。
左側のナビゲーション ウィンドウから npm を選択します。 npm で Azure Artifacts を初めて使用する場合は、[ツールの取得] を選択し、手順に従ってNode.jsダウンロードし、コンピューターを設定します。
次のスニペットを .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
をサポートしています。 スコープとアップストリーム ソースでは、複数のレジストリを使用できます。
パッケージの公開
npm パッケージを発行するには、プロジェクト ディレクトリで次のコマンドを実行します。
npm publish
重要
publishConfig
発行時にプロパティを使用してレジストリ構成パラメーターをオーバーライドすることはサポートされていません。
パッケージの復元
npm パッケージを復元するには、プロジェクト ディレクトリで次のコマンドを実行します。
npm install --save <package>
すべての npm パッケージを復元するには、プロジェクト ディレクトリから次のコマンドを実行します。
npm install
関連記事
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示