チュートリアル: アップストリームソースからパッケージを復元する方法

2025-06-26

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

Azure Artifacts でアップストリームソースを使用すると、1 つのフィードからすべてのアプリケーションの依存関係を管理できます。 これにより、NuGet.org や npmjs.com などのパブリックレジストリからのパッケージの使用が簡略化され、障害や侵害されたパッケージに対する保護も提供されます。また、独自のパッケージを同じフィードに発行し、すべての依存関係を 1 つの場所で管理することもできます。

このチュートリアルでは、フィードでアップストリームソースを有効にし、 NuGet.org や npmjs.com などのパブリックレジストリからパッケージを使用する手順について説明します。

[前提条件]

製品	必要条件
Azure DevOps	- Azure DevOps 組織。 - Azure DevOps プロジェクト。 - 組織ファイアウォールまたはプロキシサーバーを使用している場合に Azure Artifacts のドメイン URL と IP アドレスを許可します。

フィードを作成し、アップストリームソースを有効にする

Azure DevOps 組織にサインインしてから、プロジェクトに移動します。
Artifacts を選択し、[フィードの作成] を選択して新しいフィードを作成します。
フィードの名前を指定し、 その可視性 と スコープを選択し、[ 一般的なパブリックソースのパッケージを含める ] チェックボックスをオンにしてアップストリームソースを有効にします。
終わったら [作成] を選択します。

Von Bedeutung

別の組織のフィードをアップストリームソースとして追加するには、ターゲットフィードの所有者が、 Microsoft Entra テナントに関連付けられている組織内のすべてのフィードとユーザーとターゲットビューを共有する必要がありますFeed Settings>Views に移動して>指定したビューの右側にある省略記号ボタンを選択>編集。

フィードを使用して認証する

フィードを作成したら、使用しているテクノロジに基づいて適切なタブを選択し、指示に従って構成ファイルを設定し、フィードに接続します。

Azure DevOps 組織にサインインしてから、プロジェクトに移動します。
[ 成果物] を選択し、ドロップダウンメニューからフィードを選択し、[ フィードに接続] を選択します。
左側のナビゲーションウィンドウから npm を選択し、 Project セットアップ セクションの指示に従って構成ファイルを設定します。 まだ .npmrc ファイルがない場合は、プロジェクトのルート (package.jsonと同じフォルダー) に新しいファイルを作成します。新しい .npmrc ファイルを開き、指定されたスニペットを貼り付けます。

Azure DevOps 組織にサインインしてから、プロジェクトに移動します。
[ 成果物] を選択し、ドロップダウンメニューからフィードを選択し、[ フィードに接続] を選択します。
左側のナビゲーションウィンドウから Maven を選択します。

[プロジェクトのセットアップ] セクションで指定したスニペットを、pom.xmlの <repositories> セクションと <distributionManagement> セクションに追加します。 ファイルは次のようになります。

<repository>
  <id>[FEED-NAME]</id>
  <url>https://pkgs.dev.azure.com/[ORGANIZATION-NAME]/_packaging/[FEED-NAME]/maven/v1</url>
  <releases>
    <enabled>true</enabled>
  </releases>
  <snapshots>
    <enabled>true</enabled>
  </snapshots>
</repository>

指定した <server> スニペットを settings.xml ファイルに貼り付けます。ファイルは次のようになります。

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                              https://maven.apache.org/xsd/settings-1.0.0.xsd">
  <servers>
    <server>
      <id>[FEED-NAME]</id>
      <username>[ORGANIZATION-NAME]</username>
      <password>[PERSONAL_ACCESS_TOKEN]</password>
    </server>
  </servers>
</settings>

Packaging を使用して個人用アクセストークンを作成>スコープを読み書きし、個人用アクセストークンを settings.xml ファイルの<password> タグに貼り付けます。

Azure DevOps 組織にサインインしてから、プロジェクトに移動します。
[ 成果物] を選択し、ドロップダウンメニューからフィードを選択し、[ フィードに接続] を選択します。
左側のナビゲーションウィンドウから Gradle を選択します。
Project セットアップ セクションで提供されているスニペットを、build.gradle ファイルのリポジトリと発行セクションに追加します。ファイルは次のようになります。
```
maven {
    url 'https://pkgs.dev.azure.com/[ORGANIZATION-NAME]/_packaging/[FEED-NAME]/maven/v1'
    name '[FEED-NAME]'
    authentication {
        basic(BasicAuthentication)
    }
}
```

指定した <server> スニペットを settings.xml ファイルに貼り付けます。ファイルは次のようになります。

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                              https://maven.apache.org/xsd/settings-1.0.0.xsd">
  <servers>
    <server>
      <id>[FEED-NAME]</id>
      <username>[ORGANIZATION-NAME]</username>
      <password>[PERSONAL_ACCESS_TOKEN]</password>
    </server>
  </servers>
</settings>

Packaging> スコープを使用して個人アクセストークンを作成します。個人用アクセストークンを、settings.xmlファイルの <password> タグに貼り付けます。

Azure DevOps 組織にサインインし、プロジェクトに移動します。
[ 成果物] を選択し、ドロップダウンメニューからフィードを選択し、[ フィードに接続] を選択します。
左側のナビゲーションウィンドウから [Cargo ] を選択します。
ソースリポジトリの cargo/config.toml ファイルに、Project セットアップ セクションで提供されているスニペットを追加します。 config.toml ファイルは次のようになります。
```
  [registries]
  FEED_NAME = { index = "sparse+https://pkgs.dev.azure.com/ORGANIZATION_NAME/PROJECT_NAME/_packaging/FEED_NAME/Cargo/index/" }
  ```
```
project セットアップ セクションで提供されている 2 番目のスニペットを cargo/config.toml ファイルに追加して、crates.io ソースをフィードに置き換えます。ファイルは次のようになります。
```
[source.crates-io]
replace-with = "FEED_NAME"
```
資格情報プロバイダーを構成する
レジストリにログインする

パッケージの復元

アップストリームソースを有効にし、フィードで認証したので、パッケージの種類に基づいて適切なタブを選択し、手順に従ってパブリックレジストリから Azure Artifacts フィードにパッケージを復元します。

node_modules フォルダーをプロジェクトから削除します。
コマンドプロンプトウィンドウを開き、次のコマンドを実行してパッケージを復元します。完了すると、フィードには、アップストリームからインストールされたパッケージの保存されたコピーが必要です。
```
npm install --force
```

注

--force フラグを使用すると、ローカルコピーが存在する場合でも、パッケージがリモートソースから確実にプルされます。

ローカルキャッシュをクリアします。
```
nuget locals -clear all
```
コマンドプロンプトウィンドウを開き、次のコマンドを実行してパッケージを復元します。完了すると、フィードには、アップストリームからインストールされたパッケージの保存されたコピーが必要です。
```
nuget.exe restore
```

コマンドプロンプトウィンドウを開き、プロジェクトディレクトリで次のコマンドを実行してパッケージを復元します。完了すると、フィードには、アップストリームからインストールされたパッケージの保存されたコピーが必要です。
```
pip install
```

コマンドプロンプトウィンドウを開き、プロジェクトディレクトリで次のコマンドを実行してパッケージを復元します。完了すると、フィードには、アップストリームからインストールされたパッケージの保存されたコピーが必要です。
```
mvn install
```

コマンドプロンプトウィンドウを開き、プロジェクトディレクトリで次のコマンドを実行してパッケージを復元します。完了すると、フィードには、アップストリームからインストールされたパッケージの保存されたコピーが必要です。
```
gradle build
```

コマンドプロンプトウィンドウを開き、プロジェクトディレクトリで次のコマンドを実行してパッケージを復元します。完了すると、フィードには、アップストリームからインストールされたパッケージの保存されたコピーが必要です。
```
cargo build
```

node_modules フォルダーをプロジェクトから削除します。
コマンドプロンプトウィンドウを開き、次のコマンドを実行してパッケージを復元します。完了すると、フィードには、アップストリームからインストールされたパッケージの保存されたコピーが必要です。
```
npm install --force
```

注

--force フラグを使用すると、ローカルコピーが存在する場合でも、パッケージがリモートソースから確実にプルされます。

ローカルキャッシュをクリアします。
```
nuget locals -clear all
```
コマンドプロンプトウィンドウを開き、次のコマンドを実行してパッケージを復元します。完了すると、フィードには、アップストリームからインストールされたパッケージの保存されたコピーが必要です。
```
nuget.exe restore
```

コマンドプロンプトウィンドウを開き、プロジェクトディレクトリで次のコマンドを実行してパッケージを復元します。完了すると、フィードには、アップストリームからインストールされたパッケージの保存されたコピーが必要です。
```
pip install
```

コマンドプロンプトウィンドウを開き、プロジェクトディレクトリで次のコマンドを実行してパッケージを復元します。完了すると、フィードには、アップストリームからインストールされたパッケージの保存されたコピーが必要です。
```
mvn install
```

コマンドプロンプトウィンドウを開き、プロジェクトディレクトリで次のコマンドを実行してパッケージを復元します。完了すると、フィードには、アップストリームからインストールされたパッケージの保存されたコピーが必要です。
```
gradle build
```

次の方法で共有

チュートリアル: アップストリーム ソースからパッケージを復元する方法

[前提条件]

フィードを作成し、アップストリーム ソースを有効にする

フィードを使用して認証する

パッケージの復元

関連コンテンツ

フィードバック

その他のリソース

チュートリアル: アップストリームソースからパッケージを復元する方法

フィードを作成し、アップストリームソースを有効にする