クイックスタート: Java Spring Boot ウェブアプリをビルドして Cloud Run にデプロイする

サンプル アプリケーションを作成する

Java でアプリケーションを作成するには:

Spring Boot アプリケーションを作成します。

1. コンソールから cURL コマンドと unzip コマンドを使用して、新しい空のウェブ プロジェクトを作成します。

   curl https://start.spring.io/starter.zip \
       -d type=maven-project \
       -d bootVersion=3.3.5 \
       -d dependencies=web \
       -d javaVersion=21 \
       -d name=helloworld \
       -d artifactId=helloworld \
       -d baseDir=helloworld \
       -o helloworld.zip
   unzip helloworld.zip
   cd helloworld
   

   これで Spring Boot プロジェクトが作成されます。

   Microsoft Windows でこの cURL コマンドを使用するには、次のいずれかのコマンドラインを使用するか、必要に応じて Spring Initializr（構成のプリロード）を使用してプロジェクトを生成します。

   • WSL（推奨）
   • cygwin

2. / マッピングを処理する @RestController と、NAME 環境変数を指定する @Value フィールドを追加して、src/main/java/com/example/helloworld/HelloworldApplication.java の HelloworldApplication クラスを更新します。

   
   package com.example.helloworld;
   
   import org.springframework.beans.factory.annotation.Value;
   import org.springframework.boot.SpringApplication;
   import org.springframework.boot.autoconfigure.SpringBootApplication;
   import org.springframework.web.bind.annotation.GetMapping;
   import org.springframework.web.bind.annotation.RestController;
   
   @SpringBootApplication
   public class HelloworldApplication {
   
     @Value("${NAME:World}")
     String name;
   
     @RestController
     class HelloworldController {
       @GetMapping("/")
       String hello() {
         return "Hello " + name + "!";
       }
     }
   
     public static void main(String[] args) {
       SpringApplication.run(HelloworldApplication.class, args);
     }
   }

3. src/main/resources/application.properties の PORT 環境変数によって定義されるサーバーポートを設定します。

   server.port=${PORT:8080}

   このコードは、PORT 環境変数で定義されたポートをリッスンする基本的なウェブサーバーを作成します。

4. アプリケーションのルート ディレクトリに project.toml ファイルを作成して、Java バージョンを指定します。

   [[build.env]]
   name =  "GOOGLE_RUNTIME_VERSION"
   value = "21"
   

これでアプリが完成し、デプロイできるようになりました。

ソースから Cloud Run にデプロイする

重要: 以下の説明では、このクイックスタートで使用するプロジェクトのオーナーロールまたは編集者ロールが付与されていることを前提としています。ロールが付与されていない場合は、Cloud Run ソース デベロッパー ロールで、ソースから Cloud Run リソースをデプロイするために必要な権限を確認してください。

ソースからのデプロイでは、ソースコードからコンテナ イメージが自動的にビルドされて、デプロイされます。

ソースからデプロイするには:

1. ソースコード ディレクトリで、次のコマンドを使用して現在のフォルダをデプロイします。

   gcloud run deploy --source .

   1. サービス名の入力を求められたら、Enter キーを押して、デフォルトの名前（helloworld など）を受け入れます。

   2. プロジェクトで追加の API（Artifact Registry API など）を有効にするよう求められたら、y を押して応答します。

   3. リージョンの入力を求められたら、任意のリージョン（us-central1 など）を選択します。

   4. 指定したリージョンにリポジトリを作成するように求められたら、y を押して応答します。

   5. 未認証の呼び出しを許可するように求められた場合は、「y」と入力します。ドメイン制限の組織のポリシーが原因でこのメッセージが表示されない場合があります。詳細については、始める前にのセクションをご覧ください。

   デプロイが完了するまで少しお待ちください。正常に完了すると、コマンドラインにサービス URL が表示されます。

2. このサービス URL をウェブブラウザで開き、デプロイしたコンテナにアクセスします。

これで完了です。ソースコードから Cloud Run にコンテナ イメージをデプロイしました。Cloud Run は、受信したリクエストを処理するためにコンテナ イメージを自動的に水平方向にスケールアウトし、リクエスト数が減少するとスケールインします。料金は、リクエストの処理中に使用した CPU、メモリ、ネットワークに対してのみ発生します。