このバージョンはまだ開発中であり、まだ安定しているとは見なされていません。最新の安定バージョンについては、Spring Cloud Build 4.3.4 を使用してください！ |
ビルド
基本的なコンパイルとテスト
ソースをビルドするには、JDK17 をインストールする必要があります。
Spring Cloud は、ほとんどのビルド関連のアクティビティに Maven を使用します。関心のあるプロジェクトのクローンを作成して入力することで、非常に迅速に作業を開始できるはずです。
$ ./mvnw install
以下の例では、Maven（> = 3.3.3）を自分でインストールして、./mvnw の代わりに mvn コマンドを実行することもできます。これを行う場合、ローカル Maven 設定に Spring プレリリースアーティファクトのリポジトリ宣言が含まれていない場合は、-P spring も追加する必要があります。 |
-Xmx512m -XX:MaxPermSize=128m のような値で MAVEN_OPTS 環境変数を設定することにより、Maven で使用可能なメモリの量を増やす必要がある場合があることに注意してください。これは .mvn 構成でカバーしようとしているため、ビルドを成功させるためにそれを行う必要がある場合は、チケットを発行して設定をソース管理に追加してください。 |
テストにミドルウェア (Redis など) を必要とするプロジェクトでは、通常、Docker (英語) のローカルインスタンスがインストールされ、実行されている必要があります。
ドキュメント
spring-cloud-build モジュールには "docs" プロファイルがあり、これをオンにすると、modules/ROOT/ の Antora (英語) を使用して asciidoc ソースを構築しようとします。
そのプロセスの一環として、docs/src/main/asciidoc/README.adoc を検索し、すべてのインクルードをロードして処理しますが、解析やレンダリングは行わず、単に ${main.basedir} (デフォルトは ${basedir}、つまりプロジェクトのルート) にコピーします。README に変更がある場合は、Maven ビルド後に正しい場所に変更されたファイルとして表示されます。それをコミットして変更をプッシュするだけです。
以下のコマンドを使用してドキュメントサイトを生成できます。
./mvnw -pl docs -P docs antora:antora
コードの操作
特に IDE の好みがない場合は、コードを扱う際に Pleiades All in One (JDK, STS, Lombok 付属) または Spring Tools Suite (英語) または Eclipse (英語) を使用することをお勧めします。maven のサポートには m2eclipse (英語) の eclipse プラグインを使用しています。Maven 3.3.3 以上のバージョンに対応していれば、他の IDE やツールも課題なく動作するはずです。
Spring Maven プロファイルをアクティブ化する
Spring Cloud プロジェクトでは、Spring のマイルストーンとスナップショットリポジトリを解決するために、"Spring" の Maven プロファイルをアクティブ化する必要があります。推奨する IDE を使用して、このプロファイルをアクティブに設定してください。そうしないと、ビルドエラーが発生する可能性があります。
m2eclips を使用して eclipse にインポートする
eclipse を使用する際は、m2eclipse (英語) の eclipse プラグインの使用をお勧めします。m2eclipse がまだインストールされていない場合は、「eclipse マーケットプレイス」から入手できます。
古いバージョンの m2e は Maven 3.3 をサポートしていないため、プロジェクトを Eclipse にインポートしたら、プロジェクトに適切なプロファイルを使用するように m2eclipse に指示する必要もあります。プロジェクトの POM に関連するさまざまなエラーが表示される場合は、インストールが最新であることを確認してください。m2e をアップグレードできない場合は、settings.xml に "Spring" プロファイルを追加してください。または、親 pom の "Spring" プロファイルから settings.xml にリポジトリ設定をコピーすることもできます。 |
