The English version of quarkus.io is the official project site. Translated sites are community supported on a best-effort basis.
このページを編集

Google Cloud Functions (サーバーレス)

quarkus-google-cloud-functions エクステンションを使用すると、Quarkusを使用してGoogle Cloud Functionsを構築することができます。関数では、CDIやSpringからのインジェクションアノテーションや、必要に応じて他のQuarkusの機能を使用できます。

この技術は、previewと考えられています。

preview では、下位互換性やエコシステムでの存在は保証されていません。具体的な改善には設定や API の変更が必要になるかもしれませんが、 stable になるための計画は現在進行中です。フィードバックは メーリングリストGitHub の課題管理 で受け付けています。

とりうるステータスの完全なリストについては、 FAQの項目 を参照してください。

前提条件

このガイドを完成させるには、以下が必要です:

ソリューション

このガイドでは、サンプルプロジェクトを生成し、Quarkusで HttpFunctionBackgroundFunctionRawBackgroundFunction を実装する方法を説明します。ビルド後は、プロジェクトをGoogle Cloudにデプロイすることができます。

これらの手順を順にすべて実行しない場合、完成したサンプルを以下で確認できます。

Gitリポジトリをクローンするか git clone https://github.com/quarkusio/quarkus-quickstarts.gitアーカイブ をダウンロードが可能です

ソリューションは google-cloud-functions-quickstart ディレクトリ にあります。

デプロイ用のMavenプロジェクトを作成する

quarkus-google-cloud-functions のエクステンションを持つアプリケーションを作成します。以下のMavenコマンドを使って作成します。

コマンドラインインタフェース
quarkus create app org.acme:google-cloud-functions \
    --extension='google-cloud-functions' \
    --no-code
cd google-cloud-functions

Gradleプロジェクトを作成するには、 --gradle または --gradle-kotlin-dsl オプションを追加します。

Quarkus CLIのインストールと使用方法の詳細については、 Quarkus CLI ガイドを参照してください。

Maven
mvn io.quarkus.platform:quarkus-maven-plugin:3.15.1:create \
    -DprojectGroupId=org.acme \
    -DprojectArtifactId=google-cloud-functions \
    -Dextensions='google-cloud-functions' \
    -DnoCode
cd google-cloud-functions

Gradleプロジェクトを作成するには、 -DbuildTool=gradle または -DbuildTool=gradle-kotlin-dsl オプションを追加します。

Windowsユーザーの場合:

  • cmdを使用する場合、(バックスラッシュ \ を使用せず、すべてを同じ行に書かないでください)。

  • Powershellを使用する場合は、 -D パラメータを二重引用符で囲んでください。例: "-DprojectArtifactId=google-cloud-functions"

Googleクラウドにログインする

アプリケーションのデプロイにはGoogle Cloudへのログインが必要となるため、以下のコマンドでログインします。

gcloud auth login

Cloud Functions の関数を作成する

このプロジェクトの例では、 HttpFunctionBackgroundFunction (ストレージイベント)、 RawBackgroundFunction (PubSubイベント)、 CloudEventsFunction (Cloud Events 仕様を使用したストレージイベント)の4つの関数を作成します。

Quarkusは、Cloud Functionsの第1世代と第2世代をサポートしています。第2世代Cloud Functionsの概要については、Google Cloud Functionsドキュメントの こちらのページを参照してください。第2世代を使用するには、 --gen2 パラメータを追加する必要があります。

Cloud Functions の関数を選択する

quarkus-google-cloud-functions エクステンションは、プロジェクト内からGoogle Cloud HttpFunctionBackgroundFunction 、または RawBackgroundFunctionCloudEventsFunction インターフェイスを直接実装しているクラスをプロジェクト内でスキャンします。プロジェクト内でこれらのインターフェイスを実装しているクラスが見つからなければ、ビルド時にエラーがスローされます。 複数の関数クラスが見つかった場合は、ビルド時の例外がスローされます。

しかし、同じコードを利用するCloud Functionの関数クラスが複数あるような場合に、個別maven モジュールを作成することは手間となります。このQuarkusエクステンションを使うと、複数のCloud Function関数を一つのプロジェクトにバンドルし、設定や環境変数を使ってデプロイしたい関数を選択することができます。

Cloud Functions の関数に名前を設定するには、以下の設定プロパティーを使用します。

quarkus.google-cloud-functions.function=test

quarkus.google-cloud-functions.function プロパティーは、デプロイする関数をQuarkusに伝えます。これは環境変数でオーバーライドすることもできます。

Cloud Functions の関数となるクラスの CDI 名は、 quarkus.google-cloud-functions.function プロパティー内で指定された値と一致している必要があります。これは @Named アノテーションを使用して行う必要があります。

@Named("test")
public class TestHttpFunction implements HttpFunction {
}

HttpFunction

import java.io.Writer;
import jakarta.enterprise.context.ApplicationScoped;
import jakarta.inject.Inject;
import jakarta.inject.Named;
import com.google.cloud.functions.HttpFunction;
import com.google.cloud.functions.HttpRequest;
import com.google.cloud.functions.HttpResponse;
import io.quarkus.gcp.function.test.service.GreetingService;

@Named("httpFunction") (1)
@ApplicationScoped (2)
public class HttpFunctionTest implements HttpFunction { (3)
    @Inject GreetingService greetingService; (4)

    @Override
    public void service(HttpRequest httpRequest, HttpResponse httpResponse) throws Exception { (5)
        Writer writer = httpResponse.getWriter();
        writer.write(greetingService.hello());
    }
}
1 @Named アノテーションでは、 quarkus.google-cloud-functions.function プロパティーで使用する CDI Beanに名前を付けることができますが、これはオプションです。
2 関数はCDI Beanでなければなりません。
3 これは通常の Google Cloud Function の実装なので、 com.google.cloud.functions.HttpFunction を実装する必要があります。
4 インジェクションはCloud Function関数クラスの中で動作します。
5 これは標準的な Google Cloud Function の実装であり、ここでは何も派手なことはしていません。

BackgroundFunction

この BackgroundFunction はストレージイベントによってトリガーされる以外にも、Google Cloud でサポートされているトリガーイベントを使用できます。

import jakarta.enterprise.context.ApplicationScoped;
import jakarta.inject.Inject;
import jakarta.inject.Named;
import com.google.cloud.functions.BackgroundFunction;
import com.google.cloud.functions.Context;
import io.quarkus.gcp.function.test.service.GreetingService;


@Named("storageTest") (1)
@ApplicationScoped (2)
public class BackgroundFunctionStorageTest implements BackgroundFunction<BackgroundFunctionStorageTest.StorageEvent> { (3)
    @Inject GreetingService greetingService;  (4)

    @Override
    public void accept(StorageEvent event, Context context) throws Exception { (5)
        System.out.println("Receive event: " + event);
        System.out.println("Be polite, say " + greetingService.hello());
    }

    //
    public static class StorageEvent { (6)
        public String name;
    }
}
1 @Named アノテーションでは、 quarkus.google-cloud-functions.function プロパティーで使用する CDI Beanに名前を付けることができますが、これはオプションです。
2 関数はCDI Beanでなければなりません。
3 これは通常のGoogle Cloud Functionの実装なので、com.google.cloud.functions.BackgroundFunction を実装する必要があります。
4 インジェクションはCloud Function関数クラスの中で動作します。
5 これは標準的な Google Cloud Function の実装であり、ここでは何も派手なことはしていません。
6 これはトリガーのイベントデータがデシリアライズされるクラスです。

RawBackgroundFunction

この RawBackgroundFunction は PubSub イベントでトリガーされる以外にも、Google Cloud でサポートされているトリガーイベントを使用することができます。

import jakarta.enterprise.context.ApplicationScoped;
import jakarta.inject.Inject;
import jakarta.inject.Named;
import com.google.cloud.functions.Context;
import com.google.cloud.functions.RawBackgroundFunction;
import io.quarkus.gcp.function.test.service.GreetingService;

@Named("rawPubSubTest") (1)
@ApplicationScoped (2)
public class RawBackgroundFunctionPubSubTest implements RawBackgroundFunction { (3)
    @Inject GreetingService greetingService; (4)

    @Override
    public void accept(String event, Context context) throws Exception { (5)
        System.out.println("PubSub event: " + event);
        System.out.println("Be polite, say " + greetingService.hello());
    }
}
1 @Named アノテーションでは、 quarkus.google-cloud-functions.function プロパティーで使用する CDI Beanに名前を付けることができますが、これはオプションです。
2 関数はCDI Beanでなければなりません。
3 これは通常のGoogle Cloud Functionの実装なので、com.google.cloud.functions.RawBackgroundFunction を実装する必要があります。
4 インジェクションはCloud Function関数クラスの中で動作します。
5 これは標準的な Google Cloud Function の実装であり、ここでは何も派手なことはしていません。

CloudEventsFunction

CloudEventsFunction は、第2世代のCloud Functionsのみの機能です。

この CloudEventsFunction は Cloud Events Storage イベントによってトリガーされる以外にも、Google Cloud でサポートされている任意のCloud Eventsを使用できます。

import jakarta.enterprise.context.ApplicationScoped;
import jakarta.inject.Inject;
import jakarta.inject.Named;

import com.google.cloud.functions.CloudEventsFunction;

import io.cloudevents.CloudEvent;
import io.quarkus.gcp.function.test.service.GreetingService;

@Named("cloudEventTest") (1)
@ApplicationScoped (2)
public class CloudEventStorageTest implements CloudEventsFunction { (3)
    @Inject
    GreetingService greetingService;  (4)

    @Override
    public void accept(CloudEvent cloudEvent) throws Exception { (5)
        System.out.println("Receive event Id: " + cloudEvent.getId());
        System.out.println("Receive event Subject: " + cloudEvent.getSubject());
        System.out.println("Receive event Type: " + cloudEvent.getType());
        System.out.println("Receive event Data: " + new String(cloudEvent.getData().toBytes())); (6)
        System.out.println("Be polite, say " + greetingService.hello());
    }
}
1 @Named アノテーションでは、 quarkus.google-cloud-functions.function プロパティーで使用する CDI Beanに名前を付けることができますが、これはオプションです。
2 関数はCDI Beanでなければなりません。
3 これは通常のGoogle Cloud Functionの実装なので、com.google.cloud.functions.CloudEventsFunction を実装する必要があります。
4 インジェクションはCloud Function関数クラスの中で動作します。
5 これは標準的な Google Cloud Function の実装であり、io.cloudevents.CloudEvent を受け取る以外は何も派手なことはしていません。
6 Cloud Eventsの中のストレージイベントです。

アプリケーションのビルドとGoogle Cloudへのデプロイ

アプリケーションを構築するには、標準コマンドを使ってパッケージ化します。

コマンドラインインタフェース
quarkus build
Maven
./mvnw install
Gradle
./gradlew build

前のコマンドの結果、 target/deployment リポジトリ内に単一の JAR ファイルが生成されます。このJARファイルにはプロジェクト内のクラスと、依存関係のクラスが含まれています

これで、 gcloud を使って関数を Google Cloud にデプロイすることができるようになります。 gcloud コマンドは、どのイベントが関数のトリガーになるかによって異なります。

ここではJava 17ランタイムを使用しますが、デプロイ・コマンドで --runtime=java17 の代わりに --runtime=java21 を使用することで、Java 21ランタイムに切り替えることができます。

このコマンドを初めて起動したときには、以下のようなエラーメッセージが表示されることがあります。

ERROR: (gcloud.functions.deploy) OperationError: code=7, message=Build Failed: Cloud Build has not been used in project <project_name> before or it is disabled. Enable it by visiting https://console.developers.google.com/apis/api/cloudbuild.googleapis.com/overview?project=<my-project> then retry.

これは、Cloud Buildがまだ有効化されていないことを意味します。このエラーを解決するには、エラーに表示されているURLを開き指示に従った後、数分待ってからコマンドを再試行してください。

HttpFunction

これは HttpFunction を Google Cloud にデプロイするためのコマンドの例です。

gcloud functions deploy quarkus-example-http \
  --entry-point=io.quarkus.gcp.functions.QuarkusHttpFunction \
  --runtime=java17 --trigger-http --allow-unauthenticated --source=target/deployment

エントリーポイントは常に io.quarkus.gcp.functions.QuarkusHttpFunction に設定する必要があります。このクラスはQuarkusとCloud Functionsを統合するクラスです。

このコマンドは、作成したCloud Functions 関数をトリガーするための httpsTrigger.url を出力します。

BackgroundFunction

関数をデプロイする前に、バケットを作成する必要があります。

gsutil mb gs://quarkus-hello

これは BackgroundFunction を Google Cloud にデプロイするためのコマンドの例です。この関数は Storage イベントによってトリガーされるため、 --trigger-event google.storage.object.finalize--trigger-resource パラメーターに先の手順で作成したバケットの名前を指定する必要があります。

gcloud functions deploy quarkus-example-storage \
    --entry-point=io.quarkus.gcp.functions.QuarkusBackgroundFunction \
    --trigger-resource quarkus-hello --trigger-event google.storage.object.finalize \
    --runtime=java17 --source=target/deployment

エントリーポイントは常に io.quarkus.gcp.functions.QuarkusBackgroundFunction に設定する必要があります。このクラスはQuarkusとCloud Functionsを統合するクラスです。

イベントをトリガーするには、GCS quarkus-hello バケットにファイルを送るか、gcloudコマンドを使ってシミュレートします。

gcloud functions call quarkus-example-storage  --data '{"name":"test.txt"}'
--data には GCS イベントを指定します。これは、バケットに追加されたファイル名を含む JSON形式のフォーマットです。

RawBackgroundFunction

これは RawBackgroundFunction を Google Cloud にデプロイするコマンドの例です。この関数は PubSub イベントによってトリガーされるので、 --trigger-event google.pubsub.topic.publish--trigger-resource パラメーターに、先の手順で作成したトピックの名前を指定する必要があります。

gcloud functions deploy quarkus-example-pubsub \
  --entry-point=io.quarkus.gcp.functions.QuarkusBackgroundFunction \
  --runtime=java17 --trigger-resource hello_topic --trigger-event google.pubsub.topic.publish --source=target/deployment

エントリーポイントは常に io.quarkus.gcp.functions.QuarkusBackgroundFunction に設定する必要があります。このクラスはQuarkusとCloud Functionsを統合するクラスです。

イベントをトリガーするには、 hello_topic トピックにファイルを送信するか、gcloudコマンドを使用してシミュレートします。

gcloud functions call quarkus-example-pubsub --data '{"data":{"greeting":"world"}}'

CloudEventsFunction

CloudEventsFunction は、第2世代のCloud Functionsのみの機能です。

これは CloudEventsFunction を Google Cloud にデプロイするコマンドの例です。この関数は Storage イベントをトリガーとしているので、--trigger-bucket パラメータにあらかじめ作成した Bucket 名を指定しておく必要があります。

gcloud functions deploy quarkus-example-cloud-event --gen2 \
  --entry-point=io.quarkus.gcp.functions.QuarkusCloudEventsFunction \
  --runtime=java17 --trigger-bucket=example-cloud-event --source=target/deployment

エントリーポイントは常に io.quarkus.gcp.functions.QuarkusCloudEventsFunction に設定する必要があります。これは、Cloud Functions と Quarkus を統合するクラスです。

イベントをトリガーするには、GCS example-cloud-event バケットにファイルを送ります。

ローカルでの実行

関数をローカルで実行する最も簡単な方法は、Cloud Function invoker JAR を使用することです。

以下のコマンドでMaven経由でダウンロードできます。

mvn dependency:copy \
  -Dartifact='com.google.cloud.functions.invoker:java-function-invoker:1.3.0' \
  -DoutputDirectory=.

invokerを使用する前に、まずは関数をビルドする必要があります。

コマンドラインインタフェース
quarkus build
Maven
./mvnw install
Gradle
./gradlew build

HttpFunction

HttpFunction の場合、以下のコマンドを使用しローカルで関数を起動することができます。

java -jar java-function-invoker-1.3.0.jar \
  --classpath target/google-cloud-functions-1.0.0-SNAPSHOT-runner.jar \
  --target io.quarkus.gcp.functions.QuarkusHttpFunction
--classpath パラメーターには、関数クラスとQuarkus関連のすべてのクラスを含む、先の手順でパッケージ化されたJARを指定する必要があります。

エンドポイントは http://localhost:8080 で利用できます。

BackgroundFunction

BackgroundFunction関数の場合は、 io.quarkus.gcp.functions.BackgroundFunction のターゲットクラスでinvokerを起動します。

java -jar java-function-invoker-1.3.0.jar \
  --classpath target/google-cloud-functions-1.0.0-SNAPSHOT-runner.jar \
  --target io.quarkus.gcp.functions.QuarkusBackgroundFunction
--classpath パラメーターには、関数クラスとQuarkus関連のすべてのクラスを含む、先の手順でパッケージ化されたJARを指定する必要があります。

起動後、HTTP 呼び出しにイベントを含むペイロードを付与することでバックグラウンド関数を呼び出すことができます。

curl localhost:8080 -d '{"data":{"name":"hello.txt"}}'

このコマンドにより、イベント {"name":"hello.txt"} でBackgroundFunctionを呼び出します。これは、`hello.txt`をCloud Storageに保存した際のイベントをテストするのと同じです。

RawBackgroundFunction

BackgroundFunction関数の場合は、 io.quarkus.gcp.functions.BackgroundFunction のターゲットクラスでinvokerを起動します。

java -jar java-function-invoker-1.3.0.jar \
  --classpath target/google-cloud-functions-1.0.0-SNAPSHOT-runner.jar \
  --target io.quarkus.gcp.functions.QuarkusBackgroundFunction
--classpath パラメーターには、関数クラスとQuarkus関連のすべてのクラスを含む、先の手順でパッケージ化されたJARを指定する必要があります。

起動後、HTTP 呼び出しにイベントを含むペイロードを付与することでバックグラウンド関数を呼び出すことができます。

curl localhost:8080 -d '{"data":{"greeting":"world"}}'

このコマンドは、PubSubのBackgroundFunctionを次のPubSubMessageで呼び出します {"greeting":"world"}

CloudEventsFunction

CloudEventsFunction は、第2世代のCloud Functionのみの機能です。

CloudEventsFunctionの場合は、 io.quarkus.gcp.functions.QuarkusCloudEventsFunction のターゲットクラスでinvokerを起動します。

java -jar java-function-invoker-1.3.0.jar \
  --classpath target/google-cloud-functions-1.0.0-SNAPSHOT-runner.jar \
  --target io.quarkus.gcp.functions.QuarkusCloudEventsFunction
--classpath パラメーターには、関数クラスとQuarkus関連のすべてのクラスを含む、先の手順でパッケージ化されたJARを指定する必要があります。

イベントを含むペイロードを持つHTTPコールを介して、CloudEventsFunctionを呼び出すことができます。

curl localhost:8080 \
  -X POST \
  -H "Content-Type: application/json" \
  -H "ce-id: 123451234512345" \
  -H "ce-specversion: 1.0" \
  -H "ce-time: 2020-01-02T12:34:56.789Z" \
  -H "ce-type: google.cloud.storage.object.v1.finalized" \
  -H "ce-source: //storage.googleapis.com/projects/_/buckets/MY-BUCKET-NAME" \
  -H "ce-subject: objects/MY_FILE.txt" \
  -d '{
        "bucket": "MY_BUCKET",
        "contentType": "text/plain",
        "kind": "storage#object",
        "md5Hash": "...",
        "metageneration": "1",
        "name": "MY_FILE.txt",
        "size": "352",
        "storageClass": "MULTI_REGIONAL",
        "timeCreated": "2020-04-23T07:38:57.230Z",
        "timeStorageClassUpdated": "2020-04-23T07:38:57.230Z",
        "updated": "2020-04-23T07:38:57.230Z"
      }'

”MY_FILE.txt ファイルに対するイベントで、CloudEventsFunctionを呼び出します。

関数のテスト

Quarkusは、 quarkus-test-google-cloud-functions の依存関係を介して、Google Cloud functionsをテストするためのサポートを提供しています。

これを使うには、次のようなテストの依存関係を pom.xml に追加する必要があります。

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-test-google-cloud-functions</artifactId>
    <scope>test</scope>
</dependency>

このエクステンションは、 @QuarkusTest のテストケースに、テストケースの前に Cloud Function invoker を起動し、終了時に停止するためのアノテーションとして使用できる @WithFunction アノテーションを提供します。このアノテーションは、起動したい関数のタイプと、アプリケーション内に複数の関数がある場合は関数の名前をオプションで設定する必要があります。

デフォルトのQuarkusテストポート設定 ( quarkus.http.test-port ) が優先され、0に設定するとランダムなポートが関数呼び出し元に割り当てられます。

HttpFunction

import static io.restassured.RestAssured.when;
import static org.hamcrest.Matchers.is;

import org.junit.jupiter.api.Test;

import io.quarkus.google.cloud.functions.test.FunctionType;
import io.quarkus.google.cloud.functions.test.WithFunction;
import io.quarkus.test.junit.QuarkusTest;

@QuarkusTest (1)
@WithFunction(FunctionType.HTTP) (2)
class HttpFunctionTestCase {
    @Test
    public void test() {
        when()
                .get()
                .then()
                .statusCode(200)
                .body(is("Hello World!")); (3)
    }
}
  1. これは標準的なQuarkusのテストであり、 @QuarkusTest によってアノテーションを付ける必要があります。

  2. @WithFunction(FunctionType.HTTP) は、その関数を HTTP 関数として起動することを示します。同じアプリケーション内に複数の関数が存在する場合は、 functionName 属性でどの関数を起動するかを指定する必要があります。

  3. REST-assuredは関数のテストに使用されます。 Hello World! はinvokerを介して送られます。

BackgroundFunction

import static io.restassured.RestAssured.given;

import org.junit.jupiter.api.Test;

import io.quarkus.google.cloud.functions.test.FunctionType;
import io.quarkus.google.cloud.functions.test.WithFunction;
import io.quarkus.test.junit.QuarkusTest;

@QuarkusTest (1)
@WithFunction(FunctionType.BACKGROUND) (2)
class BackgroundFunctionStorageTestCase {
    @Test
    public void test() {
        given()
                .body("{\"data\":{\"name\":\"hello.txt\"}}") (3)
                .when()
                .post()
                .then()
                .statusCode(200);
    }
}
  1. これは標準的なQuarkusのテストであり、 @QuarkusTest によってアノテーションを付ける必要があります。

  2. @WithFunction(FunctionType.BACKGROUND) は、その関数をバックグラウンド関数として起動することを示します。同一アプリケーション内に複数の機能が存在する場合は、 functionName 属性で起動する機能を指定する必要があります。

  3. REST-assuredは関数のテストに使用されます。 {"name":"hello.txt"} はinvokerを介して送られます。

RawBackgroundFunction

import static io.restassured.RestAssured.given;

import org.junit.jupiter.api.Test;

import io.quarkus.google.cloud.functions.test.FunctionType;
import io.quarkus.google.cloud.functions.test.WithFunction;
import io.quarkus.test.junit.QuarkusTest;

@QuarkusTest (1)
@WithFunction(FunctionType.RAW_BACKGROUND) (2)
class RawBackgroundFunctionPubSubTestCase {
    @Test
    public void test() {
        given()
                .body("{\"data\":{\"name\":\"hello.txt\"}}") (3)
                .when()
                .post()
                .then()
                .statusCode(200);
    }
}
  1. これは標準的なQuarkusのテストであり、 @QuarkusTest によってアノテーションを付ける必要があります。

  2. @WithFunction(FunctionType.RAW_BACKGROUND) は、その関数を生のバックグラウンド関数として起動することを示します。同じアプリケーションに複数の関数が存在する場合、 functionName 属性を使用して、どの関数を起動するかを指定する必要があります。

  3. REST-assuredは関数のテストに使用されます。 {"name":"hello.txt"} はinvokerを介して送られます。

CloudEventsFunction

Cloud Events Functionは、第2世代のCloud Functionsのみの機能です。
import static io.restassured.RestAssured.given;

import org.junit.jupiter.api.Test;

import io.quarkus.google.cloud.functions.test.FunctionType;
import io.quarkus.google.cloud.functions.test.WithFunction;
import io.quarkus.test.junit.QuarkusTest;

@QuarkusTest (1)
@WithFunction(FunctionType.CLOUD_EVENTS) (2)
class CloudEventStorageTestCase {
    @Test
    public void test() {
        // test the function using RestAssured
        given()
                .body("{\n" + (3)
                        "        \"bucket\": \"MY_BUCKET\",\n" +
                        "        \"contentType\": \"text/plain\",\n" +
                        "        \"kind\": \"storage#object\",\n" +
                        "        \"md5Hash\": \"...\",\n" +
                        "        \"metageneration\": \"1\",\n" +
                        "        \"name\": \"MY_FILE.txt\",\n" +
                        "        \"size\": \"352\",\n" +
                        "        \"storageClass\": \"MULTI_REGIONAL\",\n" +
                        "        \"timeCreated\": \"2020-04-23T07:38:57.230Z\",\n" +
                        "        \"timeStorageClassUpdated\": \"2020-04-23T07:38:57.230Z\",\n" +
                        "        \"updated\": \"2020-04-23T07:38:57.230Z\"\n" +
                        "      }")
                .header("ce-specversion", "1.0") (4)
                .header("ce-id", "1234567890")
                .header("ce-type", "google.cloud.storage.object.v1.finalized")
                .header("ce-source", "//storage.googleapis.com/projects/_/buckets/MY-BUCKET-NAME")
                .header("ce-subject", "objects/MY_FILE.txt")
                .when()
                .post()
                .then()
                .statusCode(200);
    }
}
  1. これは標準的なQuarkusのテストであり、 @QuarkusTest によってアノテーションを付ける必要があります。

  2. @WithFunction(FunctionType.CLOUD_EVENTS) は、その関数をcloud events functionとして起動することを示します。同じアプリケーションに複数の関数が存在する場合、 functionName 属性を使用して、どの機能を起動するかを指定する必要があります。

  3. REST-assuredは関数のテストに使用され、ストレージイベントを記述したこのペイロードがinvokerを介して送信されます。

  4. クラウドイベントヘッダーは、HTTPヘッダで送信する必要があります。

次のステップ

Google Cloud Functionsの Jakarta REST、Servlet、Vert.xのサポートを探しているなら、 Google Cloud Functions HTTP binding が存在します。

プロバイダーに依存しないGoogle Cloud Functionsの実装をお探しでしたら、 Funqy Google Cloud Functionsエクステンション をご利用ください。

関連コンテンツ