プロジェクトの登録

新しいプロジェクトは、プロジェクトカタログを使用する方法と、名前と URL を指定する方法の 2 つの方法で登録できます。

プロジェクトカタログは、spring boot new および spring boot add コマンドを使用するときに名前で参照できるプロジェクトのコレクションで構成されます。

プロジェクトカタログの追加

プロジェクトカタログを追加するには、spring project-catalog add コマンドを使用します。

この例では、github.com/rd-1-2022/sample-project-catalog (英語) で入手可能なサンプルカタログを登録します。

そのリポジトリ内に、project-catalog.yml という名前のファイルがあります。これは、コマンドが検索するファイル名です。独自の URL の場所を使用する場合は、内容をそれに応じて調整してください。次のリストはコマンドを示しています。

spring project-catalog add dapr https://github.com/rd-1-2022/sample-project-catalog

前述のコマンドは、位置パラメーターを使用して、github.com/rd-1-2022/sample-project-catalog (英語)  から darp という名前のプロジェクトカタログを登録します。

次のように name オプションを使用しても、同じ結果を得ることができます。

spring project-catalog add --name dapr --url https://github.com/rd-1-2022/sample-project-catalog

これで、次のコマンドを実行して、カタログ内の使用可能なプロジェクトを表示できるようになります。

spring project list

このコマンドはプロジェクトのテーブルを表示し、リストに read という名前のプロジェクトが表示されるはずです。

┌─────────────┬──────────────────────────────────────────────────────────────────┬──────────────────────────────────────────────────────────────────┬───────┬───────────────────────────────────────┐
│Name         │Description                                                       │URL                                                               │Catalog│Tags                                   │
├─────────────┼──────────────────────────────────────────────────────────────────┼──────────────────────────────────────────────────────────────────┼───────┼───────────────────────────────────────┤
│web          │Hello, World RESTful web service.                                 │https://github.com/rd-1-2022/rest-service                         │gs     │[java-17, boot-3.1.x, rest, web]       │
├─────────────┼──────────────────────────────────────────────────────────────────┼──────────────────────────────────────────────────────────────────┼───────┼───────────────────────────────────────┤
│jpa          │Learn how to work with JPA data persistence using Spring Data JPA.│https://github.com/rd-1-2022/rpt-spring-data-jpa                  │gs     │[java-17, boot-3.1.x, jpa, h2]         │
├─────────────┼──────────────────────────────────────────────────────────────────┼──────────────────────────────────────────────────────────────────┼───────┼───────────────────────────────────────┤

...

│read         │Dapr app for reading from a statestore.                           │https://github.com/ciberkleid/dapr-testcontainers?subPath=read-app│dapr   │[java-17, boot-3.1.x, dapr, statestore]│
└─────────────┴──────────────────────────────────────────────────────────────────┴──────────────────────────────────────────────────────────────────┴───────┴───────────────────────────────────────┘

read プロジェクトから新しいプロジェクトを作成するには、次のコマンドを使用します。

spring boot new read-app read

プロジェクトのパッケージ名を指定する場合は、--package-name オプションを使用できます。

spring boot new read-app read --package-name com.xkcd.read

名前と URL を使用して追加する

プロジェクトカタログを使用したくない場合は、次のように spring project add コマンドを使用して個別のプロジェクトを追加できます。

spring project add read-app --url https://github.com/ciberkleid/dapr-testcontainers?subPath=read-app

このコマンドを実行した後、spring project list を実行すると、カタログのプロジェクトに加えて、新しく追加されたプロジェクトを確認できます。

ここで、次のコマンドを実行して、そのリポジトリに基づいて新しいプロジェクトを作成できます。

$ spring boot new my-read-app read-app
Getting project from https://github.com/ciberkleid/dapr-testcontainers?subPath=read-app
Created project in directory 'my-read-app'

プロジェクトとカタログの削除

spring project-catalog remove コマンドと spring project remove コマンドを使用すると、それぞれプロジェクトカタログとプロジェクトを削除できます。