Maven Central からのパッケージの使用

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

Azure Artifacts アップストリーム ソースを使用すると、生成するパッケージと Maven Central などのパブリック レジストリからのパッケージの両方をホストするために 1 つのフィードを使用できます。 フィードにアップストリーム ソースを追加すると、Azure Artifacts はアップストリームからインストールされたパッケージのコピーを保存します。 これにより、パブリック レジストリで障害が発生した場合でも、開発のための継続的なアクセシビリティが確保されます。 さらに、Azure Artifacts では、Google Maven リポジトリ、Gradle プラグイン、JitPack など、他のさまざまな Maven アップストリーム ソースがサポートされています。

前提条件

  • Azure DevOps organizationとプロジェクト。 まだ作成していない場合は、organizationまたはプロジェクトを作成します。

  • Azure Artifacts フィード。

Note

Maven スナップショットは、Maven アップストリーム ソースではサポートされていません。

アップストリーム ソースを有効にする

フィードがまだない場合は、次の手順に従って作成し、アップストリームソースチェックボックスをチェックして有効にしてください。 既にフィードがある場合は、次の 手順 に進み、Maven Central をアップストリーム ソースとして追加します。

  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 (コラボレーター)設定されています。

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

フィードの作成時にアップストリーム ソースチェックボックスをチェックした場合、Maven Central は既にアップストリーム ソースとして追加されている必要があります。 そうでない場合は、次の手順を使用して手動で追加できます。

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

  2. [成果物] を選択歯車アイコンし、右上隅にある [フィード] 設定移動します。

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

  4. [パブリック ソース] を選択し、ドロップダウン メニューから Maven Central (https://repo.maven.apache.org/maven2/) を選択し、完了したら [保存] を選択します。

    Maven の中央アップストリーム ソースを追加する方法を示すスクリーンショット。

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

    アップストリーム ソースを保存する方法を示すスクリーンショット。

Maven Central からパッケージを保存する

Maven Central からパッケージを保存する前に、フィードに接続するようにプロジェクトを設定していることを確認してください。 まだ設定していない場合は、プロジェクトセットアップ指示に従って Maven プロジェクトを設定し、フィードに接続します。

この例では、Maven Central から Kotlin Datetime ライブラリを保存します。

  1. Maven Central https://mvnrepository.com/に移動します。

  2. Kotlin Datetime ライブラリを検索します。 Kotlinx Datetime パッケージを選択し、インストールするバージョンを選択します。

  3. <dependency> Maven タブからスニペットをコピーします。

    <dependency>
        <groupId>org.jetbrains.kotlinx</groupId>
        <artifactId>kotlinx-datetime-jvm</artifactId>
        <version>0.4.1</version>
        <scope>runtime</scope>
    </dependency>
    
  4. pom.xml ファイルを開き、タグ内にスニペットを<dependencies>貼り付けて、ファイルを保存します。

  5. 依存関係をインストールするには、pom.xml ファイルと同じパスから次のコマンドを実行します。

    mvn install
    

Note

アップストリームからパッケージを保存するには、フィードおよびアップストリーム 閲覧者 (コラボレーター) ロール以上が必要です。 詳細については、「 アクセス許可の管理」 を参照してください。

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

アップストリームから保存したパッケージを表示するには、ドロップダウン メニューから Maven Central ソースを選択します。

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

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

  3. ソース ドロップダウン メニューから Maven Central を選択して、このアップストリームのパッケージをフィルター処理します。

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

Maven Central から保存されたパッケージを示すスクリーンショット。

ヒント

Maven がすべての依存関係をダウンロードしていない場合は、プロジェクト ディレクトリから次のコマンドを実行して、プロジェクトのファイルを再生成します。 mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true