チュートリアル: アップストリームソースを使用する方法

[アーティクル]
04/04/2024

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

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

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

このチュートリアルでは、次のことを行います。

新しいフィードを作成し、アップストリームソースを有効にします。
構成ファイルを設定します。
初期パッケージの復元を実行してフィードを設定します。
フィードを確認して、パブリックレジストリから使用したパッケージの保存されたコピーを表示します。

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

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

構成ファイルを設定する

フィードを作成したので、フィードを指す構成ファイルを更新する必要があります。これを行うには、次の操作を行う必要があります。

ソースの URL を取得する
構成ファイルを更新する

[成果物] を選択し、[フィードに接続] を選択します。
ページの左側にある npm タブを選択します。
[Project setup] \(プロジェクトのセットアップ\ ) セクションの手順に従って、構成ファイルを設定します。

まだ .npmrc ファイルがない場合は、プロジェクトのルート (package.jsonと同じフォルダー内) に新しいファイルを作成します。新しい .npmrc ファイルを開き、前の手順でコピーしたスニペットを貼り付けます。

[ 成果物] を選択し、ドロップダウンリストからフィードを選択します。
[フィードに接続] を選択し、[Python] セクションで [pip] を選択します。
仮想環境をまだ作成していない場合は作成します。
pip.ini (Windows) または pip.conf (Mac/Linux) ファイルを virtualenv に追加し、次のスニペットを貼り付けます。
```
[global]
index-url=https://pkgs.dev.azure.com/ORGANIZATION-NAME/_packaging/FEED-NAME/pypi/simple/
```

[ 成果物] を選択し、ドロップダウンリストからフィードを選択します。
[ フィードに接続] を選択し、[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 ファイルに a を追加します。

<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>

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

[ 成果物] を選択し、ドロップダウンリストからフィードを選択します。
[フィードに接続] を選択し、[Gradle] を選択します。

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 ファイルに a を追加します。

<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>

パッケージ>化の読み取りおよび書き込みスコープを使用して個人用アクセストークンを作成します。個人用アクセストークン <password> を、settings.xml ファイル内のタグに貼り付けます。

パッケージの復元

アップストリームソースを有効にし、構成ファイルを設定したので、パッケージ復元コマンドを実行してアップストリームソースにクエリを実行し、アップストリームパッケージを取得できます。

プロジェクトから node_modules フォルダーを削除し、管理者特権のコマンドプロンプトウィンドウで次のコマンドを実行します。

npm install --force

Note

この --force 引数は、ローカルコピーが存在する場合でも、プルリモートを強制します。