Quarkus is a microservice framework designed for the cloud and the containers.<\/p>\n
It is designed to have a reduced memory usage and the shortest possible startup time.<\/p>\n
It is mainly based on standards (Jakarta EE, Eclipse MicroProfile, …) and allows the use of mature and widespread Java libraries via its extensions (Hibernate, RESTeasy, Vert.X, Kafka, …).<\/p>\n
Quarkus has been thought for the cloud since its inception, it allows the development of Cloud Ready applications (as defined by the principle of 12 Factors<\/a> applications) and Cloud Native (use of public cloud capabilities to develop your applications).<\/p>\n Quarkus allows among other things the creation of Google Cloud Functions for the development of your applications.<\/p>\n Quarkus allows you to implement a Google Cloud Function of type background or HTTP in several ways:<\/p>\n First , create a Quarkus project with the Quarkus Maven plugin:<\/p>\n This Maven command will create a project for you, containing a background function and an HTTP function.<\/p>\n The background function created is as follows:<\/p>\n This function will be triggered by a Google Cloud Storage event, and will display in its logs the name of the object created or updated in Cloud Storage.<\/p>\n As the example comes with two functions, you need to delete the HTTP function that was also created, or select the function to deploy. These steps are explained in the Google Cloud Functions guide here<\/a>, and omitted for simplicity.<\/p>\n To package the function, you need to use the following Maven command To deploy this uberjar, you can use the following gcloud command:<\/p>\n This command uses as entry point To trigger the function via a Cloud Storage event, we need to define the trigger event Adding an object to the quarkus-hello<\/strong> bucket will trigger your function.\nYou can test this with the gsutil command which allows you to upload files to a Cloud Storage bucket:<\/p>\n Or simulate a trigger via:<\/p>\n Note that we use the default function size, which is 256MB. This is enough for the function container (Jetty) and our Quarkus application. We take advantage of the low memory consumption of Quarkus.<\/p>\n If we look at the logs of the start of our function, we can see that our function takes about 2s to start, of which 1s for Quarkus, and the rest (1s) for the function container (Jetty). We take advantage of the fast startup of Quarkus.<\/p>\n In the previously created Quarkus project, an HTTP function was generated which has the following code:<\/p>\n This function does a simple Hello World.<\/p>\n To package the function, you need to use the following Maven command: To deploy this uberjar you can use the following gcloud command:<\/p>\n This command uses as entry point For more information on background and HTTP functions via the Google API, see the following guide: Quarkus Google Cloud Functions<\/a>.<\/p>\n The background function example we saw earlier has the disadvantage of being dependent on the Google Cloud Functions API. It is therefore not portable from one cloud to another.<\/p>\n This is where Funqy<\/strong>, the cloud provider agnostic Quarkus function API, comes in. We can rewrite the previous background function via Funqy<\/strong> as follows:<\/p>\n To use Funqy<\/strong>, you need to replace the extension After packaging your application with Maven, you can deploy it with gcloud in the same way as before, except you need to use the entry point For more information on Funqy<\/strong>, see the following guide: Quarkus Funqy Google Cloud Functions<\/a>.<\/p>\n The HTTP function example we saw earlier has the disadvantage of being dependent on the Google Cloud Functions API. It is therefore not portable from one cloud to another.<\/p>\n Moreover, the direct manipulation of the request and response objects can be tedious.<\/p>\n To overcome this, Quarkus allows you to use its various HTTP extensions instead of the Google API, your function then becomes agnostic of the cloud provider, and much simpler to write.<\/p>\n The previous example can be rewritten as follows using the RESTEasy<\/strong> extension:<\/p>\n To use RESTEasy<\/strong>, you need to replace the After packaging your application with Maven, you can deploy it with gcloud in the same way as before except that you need to use the entry point It is also possible to write HTTP functions with the other HTTP frameworks of Quarkus: reactive routes, Undertow (servlet), Funqy HTTP or Spring Web.<\/p>\n For more information on using HTTP extensions via Cloud Functions, see the following guide: Quarkus Google Cloud Function HTTP bindings<\/a>.<\/p>\n It is very easy to create deployable functions for Google Cloud with dedicated Quarkus extensions. Moreover Funqy (for brackground functions) and HTTP binding (for HTTP functions) allow you to do it without your code being coupled with the Google Cloud API.<\/p>\n Google Cloud functions are ideal for using Google Cloud services, an extension pack exists to facilitate their uses within Quarkus via the extension pack Google Cloud Services<\/a> that allows to use BigQuery, BigTable, Firestore, PubSub, SecretManager, Spanner and Storage in a Quarkus application.<\/p>","protected":false},"excerpt":{"rendered":" Quarkus is a microservice framework designed for the cloud and the containers. It is designed to have a reduced memory usage and the shortest possible startup time. It is mainly based on standards (Jakarta EE, Eclipse MicroProfile, …) and allows the use of mature and widespread Java libraries via its extensions (Hibernate, RESTeasy, Vert.X, Kafka, …). Quarkus has been thought for the cloud since its inception, it allows the development of Cloud Ready applications (as defined by the principle of…Background Function with Google Cloud API<\/h2>\n
\nmvn io.quarkus:quarkus-maven-plugin:1.12.2.Final:create\n -DprojectGroupId=org.acme\n -DprojectArtifactId=google-cloud-functions \\\n -Dextensions=\"resteasy,google-cloud-functions\"\n<\/pre>\n
\n@ApplicationScoped \/\/1\npublic class HelloWorldBackgroundFunction \n implements BackgroundFunction { \/\/2\n\n @Override\n public void accept(StorageEvent event, Context context) throws Exception { \/\/3\n System.out.println(\"Receive event on file: \" + event.name);\n }\n\n public static class StorageEvent {\n public String name;\n }\n}\n<\/pre>\nBackgroundFunction<\/code>.<\/li>\n\nStorageEvent<\/code> object, for simplicity I only defined its name property.<\/li>\n<\/ol>\nmvn clean package<\/code>. This command will create an uberjar in the target\/deployment<\/strong> directory that you can then deploy as a Cloud Functions.<\/p>\n\ngcloud beta functions deploy quarkus-example-storage\n--entry-point=io.quarkus.gcp.functions.QuarkusBackgroundFunction\n--trigger-resource quarkus-hello\n--trigger-event google.storage.object.finalize\n--runtime=java11 --source=target\/deployment\n<\/pre>\n
io.quarkus.gcp.functions.QuarkusBackgroundFunction<\/code> and not your function. This entry point will start Quarkus, then locate your function inside the CDI container.<\/p>\ngoogle.storage.object.finalize<\/code> and specify a bucket name, here quarkus-hello<\/strong>. This bucket must have been previously created via gsutil mb gs:\/\/quarkus-hello<\/code> or the Google Cloud Console.<\/p>\n\ngsutil cp test.txt gs:\/\/quarkus-hello\n<\/pre>\n
\ngcloud functions call quarkus-example-storage\n--data '{\"name\": \"test.txt\"}'.\n<\/pre>\nHTTP Function with Google Cloud API<\/h2>\n
\n@ApplicationScoped \/\/1\npublic class HelloWorldHttpFunction implements HttpFunction { \/\/2\n\n @Override\n public void service(HttpRequest httpRequest, HttpResponse httpResponse) \/\/3\n throws Exception {\n Writer writer = httpResponse.getWriter();\n writer.write(\"Hello World\");\n }\n}\n<\/pre>\nHttpFunction<\/code>.<\/li>\n\nmvn clean package<\/code>. This command will create an uberjar in the target\/deployment<\/strong> directory that you can then deploy as a Cloud Functions.<\/p>\n\ngcloud beta functions deploy quarkus-example-http\n--entry-point=io.quarkus.gcp.functions.QuarkusHttpFunction\n--runtime=java11 --trigger-http --source=target\/deployment\n<\/pre>\n
io.quarkus.gcp.functions.QuarkusHttpFunction<\/code> and not your function. This entry point will start Quarkus and then locate your function in the CDI container.<\/p>\nBackground Function with Funqy<\/h2>\n
\npublic class HelloWorldBackgroundFunction { \/\/1\n\n @Funq \/\/2\n public void accept(StorageEvent event) throws Exception { \/\/3\n System.out.println(\"Receive event on file: \" + event.name);\n }\n\n public static class StorageEvent {\n public String name;\n }\n}\n<\/pre>\n@Funq<\/code> annotation allows you to tell Funqy<\/strong> that this is the method to call when the function is triggered.<\/li>\n\nStorageEvent<\/code> object, for simplicity I only defined its name property.<\/li>\n<\/ol>\nquarkus-google-cloud-functions<\/code> with the extension quarkus-funqy-google-cloud-functions<\/code>.<\/p>\nio.quarkus.funqy.gcp.functions.FunqyBackgroundFunction<\/code>. This gives:<\/p>\n\ngcloud beta functions deploy quarkus-example-storage\n--entry-point=io.quarkus.funqy.gcp.functions.FunqyBackgroundFunction\n--trigger-resource quarkus-hello\n--trigger-event google.storage.object.finalize\n--runtime=java11 --source=target\/deployment\n<\/pre>\n
HTTP Function with RESTEasy<\/h2>\n
\n@Path(\"\/\") \/\/1\npublic class HelloWorldHttpFunction{ \/\/2\n\n @GET \/\/3\n @Produces(MediaType.TEXT_PLAIN)\n public void String() throws Exception {\n return \"Hello World\";\n }\n}\n<\/pre>\n@Path<\/code> annotation to define the class as a REST resource.<\/li>\n\nquarkus-google-cloud-functions<\/code> extension with the quarkus-google-cloud-functions-http<\/code> extension and add the RESTEasy<\/strong> extension: quarkus-resteasy-jackson<\/code>.<\/p>\nio.quarkus.gcp.functions.http.QuarkusHttpFunction<\/code>. This gives:<\/p>\n\ngcloud beta functions deploy quarkus-example-http\n--entry-point=io.quarkus.gcp.functions.http.QuarkusHttpFunction\n--runtime=java11 --trigger-http --source=target\/deployment\n<\/pre>\n
Conclusion<\/h2>\n