npm レジストリのパッケージを使用する

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

Azure Artifacts アップストリーム ソースを使用すると、開発者は npmjs.com などのパブリック レジストリからパッケージを使用 できます。 フィードでアップストリーム ソースが有効になると、アップストリーム ソースからフィードにインストールされたパッケージのコピーが Azure Artifacts によって自動的に保存されます。 このセットアップは、最大の柔軟性を提供し、パブリック レジストリからのパッケージを含むスコープ付きパッケージと非スコープ パッケージの組み合わせを 1 つのフィード内で使用できます。 このセットアップにより、アップストリーム ソースが一時的に使用できなくなった場合でも、これらのパッケージへの継続的なアクセスも保証されます。

前提条件

ツールを取得する

マシンで npm で Azure Artifacts を初めて使用する場合は、次の手順に従って環境を設定します。

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

フィードを作成する

Azure Artifacts フィードが既にある場合は、次のセクションに進んでください。 それ以外の場合は、次のように新しいものを作成します。

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

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

3. フィードの 名前 を入力し、[ 表示] を設定してパッケージを表示できるユーザーを定義し、フィードスコープを選択 します。 アップストリーム ソースを有効にし、パブリック レジストリからのパッケージの使用を許可するには、[ 一般的なパブリック ソース からのパッケージを含める] チェック ボックスをオンにしてください。

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

npmjs アップストリームを追加する

フィードの作成時に [アップストリーム ソース] チェックボックスをオンにした場合、 npmjs はフィード内のアップストリーム ソースの一覧に自動的に追加されます。 そうでない場合は、次のように手動で追加できます。

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

2. [ 成果物] を選択し、ドロップダウン メニューからフィードを選択します。

3. 歯車アイコン ボタンの を選択して、 フィード設定を開きます。

4. [アップストリーム ソース] を選択し、[アップストリームの追加] を選択します。

5. [ パブリック ソース] を選択し、ドロップダウン メニューから npmjs (https://registry.npmjs.org/) を選択します。

6. 終了したら [追加] を選択します。

7. 右上隅にある [保存] を選択して変更を適用します。

フィードに接続する

アップストリーム ソースからフィードへのパッケージの保存を開始する前に、まずプロジェクトを設定し、フィードに接続する必要があります。

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

2. [ 成果物] を選択し、ドロップダウン メニューからフィードを選択します。

3. [ フィードに接続] を選択し、左側のパネルから npm を選択します。

4. Project セットアップ セクションの手順に従って、.npmrc ファイルを構成し、フィードで認証します。 詳細については、 npm プロジェクトの設定 を参照してください。

npmjs からパッケージをインストールする

フィードで認証したので、npmjs.com などのパブリック レジストリからパッケージのインストールを開始できます。 アップストリーム ソースからパッケージをインストールすると、そのパッケージのコピーが Azure Artifacts によってフィードに自動的に保存されます。 この例では、 Mongoose をインストールします。MongoDB Object Data Modeling (ODM) ライブラリは、Node.js アプリケーションでのスキーマ定義、データ検証、およびオブジェクト モデリングに役立ちます。

1. https://www.npmjs.com にアクセスします。

2. Mongoose パッケージを検索し、それを選択して詳細ページに移動します。

3. install コマンドをクリップボードにコピーします。

4. コマンド プロンプト ウィンドウで、プロジェクト ディレクトリに移動し、install コマンドを実行します。

   npm i mongoose
   

保存されたパッケージを表示する

npm レジストリからパッケージをインストールしたので、Azure Artifacts がそのパッケージのコピーをフィードに自動的に保存する方法を確認できます。 次の手順に従って、パッケージがフィードに追加されたことを確認します。

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

2. [ 成果物] を選択し、ドロップダウン メニューからフィードを選択します。

3. 右上隅の [ソース ] メニューから npmjs を選択し、npm レジストリからパッケージをフィルター処理します。

4. 前の手順でインストールした mongoose パッケージがフィードに表示されます。 インストール コマンドを実行すると、Azure Artifacts によってコピーが自動的に保存されました。

   

関連コンテンツ

• npm パッケージの発行 (CLI)

• Azure Pipelines を使用して npm パッケージを発行する (YAML/クラシック)

• Npm スコープ