Maven と Gradle のクイックスタート

このクイックスタートでは、Artifact Registry Maven リポジトリを設定して、パッケージを設定したリポジトリにアップロードする方法を説明します。

パッケージ管理はアルファ版です。これはアルファ版のユーザーにのみご利用いただけます。コンテナ管理で利用できる機能がすべて含まれているとは限りません。アルファ版のお申し込みには、登録フォームをご利用ください。

始める前に

Google Cloud アカウントにログインします。Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

Google Cloud Console の [プロジェクトセレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

プロジェクトセレクタに移動

Cloud プロジェクトに対して課金が有効になっていることを確認します。詳しくは、プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。

Artifact Registry API を有効にします。

API を有効にする

Google Cloud CLI をインストールして初期化します。

Google Cloud Console の [プロジェクトセレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

プロジェクトセレクタに移動

Artifact Registry API を有効にします。

API を有効にする

Google Cloud CLI をインストールして初期化します。

Maven リポジトリを作成する

Java アーティファクト用のリポジトリを作成します。

リポジトリを作成します。
コンソール
1. Cloud Console で [リポジトリ] ページを開きます。
  
  [リポジトリ] ページを開く
2. [リポジトリを作成] をクリックします。
3. リポジトリ名として quickstart-maven-repo を指定します。
4. 形式には Maven を選択します。
5. [ロケーションタイプ] で [リージョン] を選択し、ロケーションとして us-central1 を選択します。
6. [作成] をクリックします。
リポジトリがリポジトリリストに追加されます。
gcloud
1. 次のコマンドを実行して、ロケーション us-central1 にある quickstart-maven-repo という名前の現在のプロジェクトに、新しい Maven リポジトリを作成します。
```
gcloud artifacts repositories create quickstart-maven-repo --repository-format=maven \
--location=us-central1 [--description="Maven repository"]
```
2. 次のコマンドを実行して、リポジトリが作成されたことを確認します。
  
  gcloud アーティファクトリポジトリリスト
Artifact Registry コマンドの詳細については、gcloud artifacts コマンドを実行してください。
gcloud コマンドを簡略化するには、デフォルトのリポジトリを quickstart-maven-repo に、デフォルトロケーションを us-central1 に設定します。値を設定したら、リポジトリまたはロケーションを必要とする gcloud コマンドで設定した値を指定する必要はありません。

リポジトリを設定するには、次のコマンドを実行します。
```
gcloud config set artifacts/repository quickstart-maven-repo
```
ロケーションを設定するには、次のコマンドを実行します。
```
gcloud config set artifacts/location us-central1
```
上記のコマンドの詳細については、gcloud config set のドキュメントをご覧ください。

クライアントのサービスアカウントを設定する

アプリケーションに代わって動作するサービスアカウントを作成するか、自動化に使用する既存のサービスアカウントを選択します。

Artifact Registry で認証を設定するには、サービスアカウントのキーファイルの場所が必要です。既存のアカウントの場合は、[サービスアカウント] ページで鍵を表示し、新しい鍵を作成できます。

[サービスアカウント] ページに移動
サービスアカウントにリポジトリへの読み取りと書き込みのアクセス権を付与します。
```
gcloud artifacts repositories add-iam-policy-binding \
quickstart-maven-repo --location=us-central1 --member='serviceAccount:ACCOUNT' --role='roles/artifactregistry.writer'
```
ACCOUNT は USERNAME@PROJECT-ID.iam.gserviceaccount.com という形式のサービスアカウントの ID です。
サービスアカウントキーファイルの場所を変数 GOOGLE_APPLICATION_CREDENTIALS に割り当てて、Artifact Registry 認証情報ヘルパーがリポジトリとの接続時にキーを取得できるようにします。
```
export GOOGLE_APPLICATION_CREDENTIALS=KEY-FILE
```
KEY-FILE はサービスアカウントキーファイルのパスです。

サービスアカウントキーファイルを使用したパスワード認証を設定する方法については、authentication#auth-password のドキュメントをご覧ください。

Maven を構成する

使用する Maven プロジェクトを選択します。

使用可能な単純なプロジェクトがない場合は、5 分後に Maven プロジェクトを作成できます。

次のコマンドを実行して、デフォルトの quickstart-maven-repo リポジトリの設定を出力します。

gcloud artifacts print-settings mvn

gcloud コマンドの出力は次のスニペットのようになります。PROJECT はプロジェクト ID です。

<distributionManagement>
  <snapshotRepository>
    <id>artifact-registry</id>
    <url>artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-maven-repo</url>
  </snapshotRepository>
  <repository>
    <id>artifact-registry</id>
    <url>artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-maven-repo</url>
  </repository>
</distributionManagement>

<repositories>
  <repository>
    <id>artifact-registry</id>
    <url>artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-maven-repo</url>
    <releases>
      <enabled>true</enabled>
    </releases>
    <snapshots>
      <enabled>true</enabled>
    </snapshots>
  </repository>
</repositories>

<build>
  <extensions>
    <extension>
      <groupId>com.google.cloud.artifactregistry</groupId>
      <artifactId>artifactregistry-maven-wagon</artifactId>
      <version>2.1.1</version>
    </extension>
  </extensions>
</build>

Maven プロジェクトの pom.xml ファイルに設定を追加します。次の概要は、重要な各要素の相対的な配置を示しています。ファイルの構造について詳しくは、Maven の POM リファレンスをご覧ください。

<project xmlns="http://maven.apache.org/POM/4.0.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
                      http://maven.apache.org/xsd/maven-4.0.0.xsd">

  <!-- Build Settings -->
  <build>
    ...
    <extensions>...</extensions>
  </build>

  <!-- Environment Settings -->
  <repositories>...</repositories>
  <distributionManagement>...</distributionManagement>
</project>

Gradle を設定する

作成した Artifact Registry リポジトリにパッケージをデプロイするシンプルな Gradle プロジェクトを作成します。テスト用の Gradle ビルドがない場合は、Gradle のチュートリアルの手順に従って、シンプルな Gradle ビルドを作成できます。
gcloud コマンドを簡略化するには、デフォルトのリポジトリを quickstart-maven-repo に、デフォルトロケーションを us-central1 に設定します。値を設定したら、リポジトリまたはロケーションを必要とする gcloud コマンドで設定した値を指定する必要はありません。

リポジトリを設定するには、次のコマンドを実行します。
```
gcloud config set artifacts/repository quickstart-maven-repo
```
ロケーションを設定するには、次のコマンドを実行します。
```
gcloud config set artifacts/location us-central1
```
上記のコマンドの詳細については、gcloud config set のドキュメントをご覧ください。

リポジトリに接続するための設定を build.gradle ファイルに追加します。次のコマンドは、デフォルトの quickstart-maven-repo リポジトリに追加する設定を出力します。

gcloud artifacts print-settings gradle

gcloud コマンドの出力は次の例のようになります。PROJECT はプロジェクト ID です。

plugins {
  id "maven-publish"
  id "com.google.cloud.artifactregistry.gradle-plugin" version "2.1.1"
}

publishing {
  repositories {
    maven {
      url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-maven-repo"
    }
  }
}

repositories {
  maven {
    url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-maven-repo"
  }
}

build.gradle ファイルに publications セクションが含まれていることを確認します。publications セクションは、次の例に示すように、publishing の子です。

publishing {
  publications {
       mavenJava(MavenPublication) {
          groupId  'maven.example.id'
          from components.java
       }
  }
  repositories {
    maven {
      url "artifactregistry://us-central1-maven.pkg.dev/PROJECT/quickstart-maven-repo"
    }
  }
}

init.gradle ファイルまたは settings ファイルにリポジトリ構成を追加することもできます。これらのオプションの詳細については、認証の設定をご覧ください。

パッケージをリポジトリにアップロードする

Maven の場合は、mvn deploy と mvn release を使用してリポジトリにパッケージを追加できます。

Gradle の場合は、gradle publish コマンドを使用してパッケージをリポジトリにアップロードします。

リポジトリでパッケージを表示する

パッケージがリポジトリに追加されたことを確認するには:

コンソール

Cloud Console で [リポジトリ] ページを開きます。

[リポジトリ] ページを開く
リポジトリリストで、quickstart-maven-repo リポジトリをクリックします。

[Packages] ページには、リポジトリ内のパッケージが一覧表示されます。

gcloud

quickstart-maven-repo リポジトリ内のパッケージを一覧表示するには、次のコマンドを実行します。

 gcloud artifacts packages list --repository=quickstart-maven-repo

パッケージのバージョンを表示するには、次のコマンドを実行します。

gcloud artifacts versions list --package=PACKAGE

PACKAGE はパッケージ ID です。

クリーンアップ

このクイックスタートで使用したリソースについて、Google Cloud アカウントに課金されないようにするには、次の手順を行います。

リポジトリを削除する前に、保持する必要があるパッケージが別の場所で使用可能であることを確認してください。

リポジトリを削除するには、次の手順を行います。

コンソール

Cloud Console で [リポジトリ] ページを開きます。

[リポジトリ] ページを開く
リポジトリリストで、quickstart-maven-repo リポジトリを選択します。
[削除] をクリックします。

gcloud

quickstart-maven-repo リポジトリを削除するには、次のコマンドを実行します。
```
gcloud artifacts repositories delete quickstart-maven-repo
```
アクティブな gcloud 構成用に構成したデフォルトのリポジトリとロケーション設定を削除するには、次のコマンドを実行します。
```
gcloud config unset artifacts/repository
gcloud config unset artifacts/location
```

Maven と Gradle のクイックスタート

始める前に

Maven リポジトリを作成する

コンソール

gcloud

クライアントのサービス アカウントを設定する

Maven を構成する

Gradle を設定する

パッケージをリポジトリにアップロードする

リポジトリでパッケージを表示する

コンソール

gcloud

クリーンアップ

コンソール

gcloud

次のステップ

クライアントのサービスアカウントを設定する