Azure DevOps サービス |Azure DevOps Server |Azure DevOps Server 2022
Azure Artifactsを使用すると、開発者はアップストリーム ソースが Google Maven リポジトリなどのパブリック レジストリからパッケージを使用できるようになります。 アップストリーム ソースが有効になっている場合、Azure Artifactsは、Feed および Upstream Reader (コラボレーター) 以上のアクセス許可を持つユーザーによってフィードにインストールされたパッケージのコピーを自動的に保存します。 Azure Artifactsでは、Maven Central、Gradle プラグイン、JitPack など、他の Maven アップストリーム ソースもサポートされています。
前提条件
| 製品 | 必要条件 |
|---|---|
| Azure DevOps | - Azure DevOps organization。 - Azure DevOps project。 |
フィードを作成する
既にAzure Artifacts フィードがある場合は、次のセクションに進んでください。 それ以外の場合は、次の手順に従って新しいものを作成します。
Azure DevOpsにサインインし、プロジェクトに移動します。
[ 成果物] を選択し、[ フィードの作成] を選択します。
フィードの 名前 を入力し、[ 表示] を設定してパッケージを表示できるユーザーを制御し、フィード スコープを選択します。 アップストリーム ソースを有効にし、パブリック レジストリからの使用を許可するには、[ 一般的なパブリック ソースのパッケージを含める] を選択します。
[ 作成 ] を選択して完了します。
Google Maven リポジトリのアップストリーム ソースを追加する
フィードの作成時に 一般的なパブリック ソースのパッケージを含める を選択した場合、Google Maven リポジトリは既にアップストリーム ソースとして追加されている必要があります。 そうでない場合は、次の手順に従って手動で追加できます。
Azure DevOps組織にサインインし、プロジェクトに移動します。
成果物 を選択し、右上隅にある
を選択して フィード設定を開きます。[アップストリーム ソース] を選択し、[アップストリームの追加] を選択します。
[ パブリック ソース] を選択し、 Google Maven リポジトリ (https://maven.google.com/web/index.html) を選択します。
[ 追加] を選択し、右上隅にある [保存] を選択して変更を保存します。
Google Maven リポジトリからパッケージを保存する
開始する前に、Maven プロジェクトが Azure Artifacts フィードに接続するように構成されていることを確認します。 まだこれを行っていない場合は、 プロジェクトのセットアップ の指示に従って Maven プロジェクトを設定し、フィードで認証します。
次の例は、オープンソース ID フレームワークである Multipaz を Google Maven リポジトリからインストールする方法を示しています。
Google Maven リポジトリ
https://maven.google.comに移動します。Multipaz パッケージ org.multipaz を検索し、使用するパッケージとバージョンを選択します。
パッケージのグループ ID、成果物 ID、バージョンの値をコピーします。
次のスニペットのプレースホルダーを、先ほどコピーした値に置き換えます。
<dependency> <groupId>GROUP_ID</groupId> <artifactId>ARTIFACT_ID</artifactId> <version>VERSION</version> </dependency>pom.xml ファイルを開き、依存関係スニペットを
<dependencies>セクション内に貼り付けて、ファイルを保存します。依存関係をインストールするには、 pom.xml ファイルと同じパスから次のコマンドを実行します。
mvn install
コマンドが完了すると、Maven はAzure Artifacts フィードを介して依存関係を解決します。 パッケージがまだフィードに存在しない場合は、Azure Artifacts Google Maven リポジトリからパッケージを取得し、コピーを保存します。 以降のインストールでは、パブリック レジストリではなく、Azure Artifactsから直接パッケージをダウンロードします。
注
アップストリームからパッケージを保存するには 、フィードリーダーとアップストリームリーダー(コラボレーター) 以上のロールが必要です。 詳細については、 フィードのロールとアクセス許可 に関するページを参照してください。
保存されたパッケージを表示する
アップストリーム ソースからパッケージをインストールした後、Azure Artifactsフィードにコピーを保存したことを確認できます。
Azure DevOpsにサインインし、プロジェクトに移動します。
[ 成果物] を選択し、ドロップダウン メニューからフィードを選択します。
[ソース] ドロップダウン メニューから Google Maven リポジトリを選択し、このアップストリームから保存されたパッケージを表示します。
前のセクションでインストールした Multipaz パッケージがフィードで使用できるようになりました。 Azure Artifacts mvn install コマンドを実行したときにコピーが自動的に保存されます。
ヒント
Maven によってすべての依存関係がダウンロードされない場合は、プロジェクト ディレクトリから次のコマンドを実行してプロジェクト ファイルを再生成し、ソースと Javadoc をダウンロードします。 mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true