次の方法で共有


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

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

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

前提条件

フィードの作成

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

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

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

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

    Azure DevOps Services で新しいフィードを作成する方法を示すスクリーンショット。

  1. Azure DevOps サーバーにサインインし、プロジェクトに移動します。

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

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

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

    Azure DevOps 2022 で新しいフィードを作成する方法を示すスクリーンショット。

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

    Azure DevOps 2020 で新しいフィードを作成する方法を示すスクリーンショット。

  1. Azure DevOps サーバーにサインインし、プロジェクトに移動します。

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

  3. フィードのわかりやすい 名前 を入力し、その 可視性 を定義します (フィード内でパッケージを表示できるユーザーを示します)。 パブリック ソースのパッケージを含める場合は、[このフィードを使用してパブリック ソースのパッケージを使用する] オプションを選択します。

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

    Azure DevOps 2019 で新しいフィードを作成する方法を示すスクリーンショット。

Note

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

フィードに接続する

Note

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

Azure Artifacts では、2 つの .npmrc ファイルを使用することをお勧めします。 最初のディレクトリは、$home ディレクトリ (Linux/macOS) または$envに配置する必要があります。HOME (Windows) を使用して資格情報を安全に保存します。 これにより、npm クライアントはファイルを検索し、認証用の資格情報を取得できるため、資格情報を公開せずに構成ファイルを共有できます。 このセクションでは、2 番目 の .npmrc ファイルを 設定します。これは、package.json ファイルと同じディレクトリに配置する必要があります。

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

  2. [成果物] を選択し、[フィードに接続] を選択します。

  3. 左側のナビゲーション領域から npm を選択します。 npm で Azure Artifacts を初めて使用する場合は、前提条件がインストールされていることを確認してください。

  4. [Project setup] \(プロジェクトのセットアップ \) セクションの手順に従って、構成ファイルを設定し、フィードに接続します。

    npm プロジェクトを設定し、Azure DevOps Services の Azure Artifacts フィードに接続する方法を示すスクリーンショット。

  1. Azure DevOps コレクションにサインインし、プロジェクトに移動します。

  2. [ 成果物] を選択し、[フィードに接続] を選択 します

  3. 左側から npm を選択し、Project セットアップ セクションの指示に従ってフィードに接続します。

    npm プロジェクトを設定し、Azure DevOps Server 2022 で Azure Artifacts フィードに接続する方法を示すスクリーンショット。

  1. Azure DevOps コレクションにサインインし、プロジェクトに移動します。

  2. [成果物] を選択し、[フィードに接続] を選択します。

  3. 左側から npm を選択し、Project セットアップの指示に従って構成ファイルを設定し、フィードに接続します。

    npm プロジェクトを設定し、Azure DevOps Server 2020 で Azure Artifacts フィードに接続する方法を示すスクリーンショット。

  1. Azure DevOps コレクションにサインインし、プロジェクトに移動します。

  2. [成果物] を選択し、[フィードに接続] を選択します。

  3. 新しいウィンドウが表示されます。 左側のナビゲーション ウィンドウで npm を選択し、指示に従ってプロジェクトuser.npmrc ファイルを設定します。

    npm プロジェクトを設定し、Azure DevOps Server 2019 で Azure Artifacts フィードに接続する方法を示すスクリーンショット。

重要

npm では、.npmrc ファイル内の 1 つ registry をサポートしています。 スコープとアップストリーム ソースでは、複数のレジストリを使用できます。

パッケージの公開

プロジェクト ディレクトリで次のコマンドを実行して、npm パッケージを発行します。

npm publish

重要

publishConfig発行時にプロパティを使用してレジストリ構成パラメーターをオーバーライドすることはサポートされていません。

パッケージの復元

プロジェクト ディレクトリで次のコマンドを実行して、npm パッケージを復元します。

npm install

特定の npm パッケージを復元するには、プロジェクト ディレクトリから次のコマンドを実行します。

npm install --save <PACKAGE_NAME>