このトピックでは、Maven プライベートリポジトリでアーティファクトを管理する方法について説明します。
前提条件
Maven プライベートリポジトリでアーティファクトを管理するには、まず Maven リポジトリを作成します。詳細については、「リポジトリの作成」をご参照ください。
Maven リポジトリの使用
Maven リポジトリをクリックします。 左側のナビゲーションペインで[ユーザーガイド]を選択し、指示に従ってアーティファクトのプッシュとプルを設定します。
[認証情報] エリアでボタンをクリックすると、Maven のユーザー名とパスワードを表示できます。
[プル] タブを選択し、次の 2 つのステップに従って Maven でアーティファクトをプルするように設定します。ステップ 1： リポジトリの認証情報を設定します。<servers> ノードの settings.xml ファイルに <server> 要素を追加し、リポジトリの id、<username>、<password> を指定します。ステップ 2： リポジトリ情報を設定します。<repositories> ノードに <repository> 要素を追加し、リポジトリの id と url を設定し、releases と snapshots の enabled を必要に応じて true または false に設定します。
Maven アーティファクトの表示と管理
アーティファクトの検索
リポジトリのホームページには、すべてのアーティファクトのリストが表示されます。名前でアーティファクトを検索できます。
アーティファクトの手動アップロード
[アーティファクトのアップロード] をクリックして、ローカルの Maven アーティファクトをリポジトリに手動でアップロードします。[アーティファクトのアップロード] ダイアログボックスで、[グループ]、[アーティファクト]、および [バージョン] の情報を正しく入力し、正しいパッケージングタイプを選択し、ローカルパッケージファイルをアップロードして、[アップロード] をクリックします。
アーティファクトバージョンの詳細表示
アーティファクト名をクリックすると、その詳細パネルが開きます。パネルにはデフォルトで最新バージョンの詳細が表示されますが、他のバージョンに切り替えることもできます。[ファイル一覧]では、必要に応じて pom や jar などのファイルをダウンロードできます。
右側の詳細パネルには、[ファイル情報] と [メタデータ] の 2 つのタブがあります。[ファイル情報] タブには、アーティファクトの詳細 (総バージョン数、ストレージサイズ、タグなど) とバージョン固有の詳細 (バージョンをプッシュしたユーザーとプッシュ日時など) が表示されます。パネルの下部には [アーティファクトの無効化] スイッチがあります。
アーティファクトのプル
アーティファクト名をクリックすると、その詳細パネルが表示されます。このパネルには Maven または Gradle 依存関係 の設定スニペットがあります。
たとえば、Maven プロジェクトでは、すべての依存関係を pom.xml ファイルで管理します。基本的な手順は次のとおりです：
-
依存関係の追加：
pom.xmlファイルの<dependencies>セクションに、必要な<dependency>ブロックを追加します。たとえば、バージョン「0.0.3-SNAPSHOT」の依存関係を追加するには、次のコードを追加します。<dependencies> <dependency> <groupId>com.example</groupId> <artifactId>demo</artifactId> <version>0.0.3-SNAPSHOT</version> </dependency> </dependencies> -
バージョンの切り替え： 依存関係のバージョンを変更するには、
<version>要素の値を更新します。 -
依存関係の更新： 依存関係を解決するには、次の Maven コマンドを実行します。
mvn dependency:resolveまたは、プロジェクトのビルドを実行して依存関係を更新します。
mvn clean install
アーティファクトバージョンの無効化
アーティファクトの詳細パネルで、[アーティファクトを無効化] をクリックしてそのバージョンを無効化します。
[無効化の理由を入力] ダイアログボックスで、理由を入力して [OK] をクリックします。
無効化は特定のバージョンにのみ適用され、アーティファクト全体には適用されません。たとえば、詳細ページでアーティファクトのバージョン 1.0 を無効にすると、そのバージョンはプルできなくなりますが、他のバージョンは引き続き使用できます。
アーティファクトバージョンの削除
アーティファクト詳細パネルで [メタデータ] をクリックして、アーティファクトバージョンのメタデータを管理します。 このメタデータは、指定されたバージョンにのみ適用されます。 [このバージョンを削除] をクリックして、アーティファクトバージョンを削除します。 削除されたアーティファクトバージョンは、[アーティファクトごみ箱] から復元できます。