ビルド
基本的なコンパイルとテスト
ソースをビルドするには、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]（www.docker.com/get-started (英語) ）のローカルインスタンスがインストールされ、実行されている必要があります。
ドキュメント
spring-cloud-build モジュールには "docs" プロファイルがあり、これをオンにすると、modules/ROOT/ の Antora (英語) を使用して asciidoc ソースを構築しようとします。
そのプロセスの一環として、docs/src/main/asciidoc/README.adoc を検索し、すべてのインクルードをロードして処理しますが、解析やレンダリングは行わず、単に ${main.basedir} (デフォルトは ${basedir}、つまりプロジェクトのルート) にコピーします。README に変更がある場合は、Maven ビルド後に正しい場所に変更されたファイルとして表示されます。それをコミットして変更をプッシュするだけです。
コードの操作
IDE 設定がない場合は、コードを操作するときに Spring Tools Suite または Eclipse (英語) を使用することをお勧めします。maven サポートには m2eclipseeclipse (英語) プラグインを使用します。他の IDE やツールも、Maven 3.3.3 以上を使用している限り、課題なく動作するはずです。
Spring Maven プロファイルをアクティブ化する
Spring Cloud プロジェクトでは、Spring のマイルストーンとスナップショットリポジトリを解決するために、"Spring" の Maven プロファイルをアクティブ化する必要があります。推奨する IDE を使用して、このプロファイルをアクティブに設定してください。そうしないと、ビルドエラーが発生する可能性があります。
m2eclipse を使用して Eclipse にインポートする
Eclipse を使用する場合は、m2eclipseeclipse (英語) プラグインをお勧めします。m2eclipse をまだインストールしていない場合は、"eclipsemarketplace" から入手できます。
古いバージョンの m2e は Maven 3.3 をサポートしていないため、プロジェクトを Eclipse にインポートしたら、プロジェクトに適切なプロファイルを使用するように m2eclipse に指示する必要もあります。プロジェクトの POM に関連するさまざまなエラーが表示される場合は、インストールが最新であることを確認してください。m2e をアップグレードできない場合は、settings.xml に "Spring" プロファイルを追加してください。または、親 pom の "Spring" プロファイルから settings.xml にリポジトリ設定をコピーすることもできます。 |
