Quarkus est un framework de d\u00e9veloppement de microservice pens\u00e9 pour le cloud et les conteneurs.<\/p>\n
Il est pens\u00e9 pour avoir une utilisation m\u00e9moire r\u00e9duite et un temps de d\u00e9marrage le plus court possible.<\/p>\n
Il se base principalement sur des standards (Jakarta EE, Eclipse MicroProfile, \u2026) et permet l’utilisation de librairies Java matures et tr\u00e8s r\u00e9pandues via ses extensions (Hibernate, RESTeasy, Vert.X, Kafka, \u2026).<\/p>\n
Quarkus a \u00e9t\u00e9 pens\u00e9 pour le cloud d\u00e8s sa conception, il permet le d\u00e9veloppement d\u2019applications Cloud Ready (tel que d\u00e9fini par le principe des applications 12 Factors<\/a> ) et Cloud Native (utilisation des capacit\u00e9s des cloud publics pour d\u00e9velopper vos applications).<\/p>\n Quarkus permet entre autres la cr\u00e9ation de fonctions Google Cloud Functions pour le d\u00e9veloppement de vos applications.<\/p>\n Quarkus permet d\u2019impl\u00e9menter une fonction Google Cloud Function de type background ou HTTP de plusieurs mani\u00e8res :<\/p>\n Premi\u00e8re \u00e9tape, cr\u00e9er un projet Quarkus avec le plugin Maven de Quarkus :<\/p>\n Cette commande Maven va vous cr\u00e9er un projet contenant une fonction background et une fonction HTTP.<\/p>\n La fonction background cr\u00e9\u00e9e est la suivante :<\/p>\n Cette fonction sera d\u00e9clench\u00e9e par un \u00e9v\u00e9nement de type Google Cloud Storage, et va afficher dans ses logs le nom de l\u2019objet cr\u00e9\u00e9 ou mis \u00e0 jour dans Cloud Storage.<\/p>\n Comme l\u2019exemple vient avec deux fonctions, il vous faut supprimer la fonction HTTP qui a aussi \u00e9t\u00e9 cr\u00e9\u00e9e, ou s\u00e9lectionner la fonction \u00e0 d\u00e9ployer. Ces \u00e9tapes sont expliqu\u00e9es dans le guide des Google Cloud Functions ici<\/a>, et omises pour des raisons de simplicit\u00e9.<\/p>\n Pour packager la fonction, vous devez utiliser la commande Maven suivante : Pour d\u00e9ployer cet uberjar, vous pouvez utiliser la commande gcloud suivante :<\/p>\n Cette commande utilise comme entry point Pour d\u00e9clencher la fonction via une \u00e9v\u00e9nement Cloud Storage, on doit d\u00e9finir l’\u00e9v\u00e9nement de d\u00e9clenchement L\u2019ajout d\u2019un objet dans le bucket quarkus-hello<\/strong> va alors d\u00e9clencher votre fonction.\nVous pouvez tester cela avec la commande gsutil qui permet d\u2019envoyer des fichiers dans un bucket Cloud Storage :<\/p>\n Ou simuler un d\u00e9clenchement via :<\/p>\n On peut noter qu\u2019on utilise la taille par d\u00e9faut de fonction qui est de 256Mo, ceci est suffisant pour le d\u00e9marrage du conteneur de la fonction (Jetty) et de notre application Quarkus. On tire parti de la consommation m\u00e9moire faible de Quarkus.<\/p>\n Si on regarde dans les logs de d\u00e9marrage de notre fonction, on constate que notre fonction prend environ 2s \u00e0 d\u00e9marrer dont 1s pour Quarkus, et le reste (1s donc), pour le conteneur de fonction (Jetty). On tire parti du d\u00e9marrage rapide de Quarkus.<\/p>\n Dans le projet Quarkus pr\u00e9c\u00e9demment cr\u00e9\u00e9, une fonction HTTP a \u00e9t\u00e9 g\u00e9n\u00e9r\u00e9e dont voici le code :<\/p>\n Cette fonction fait un simple Hello World.<\/p>\n Pour packager la fonction, vous devez utiliser la commande Maven suivante : Pour d\u00e9ployer cet uberjar vous pouvez utiliser la commande gcloud suivante :<\/p>\n Cette commande utilise comme entry point Pour plus d\u2019informations sur les fonctions background et HTTP via l\u2019API Google, voir le guide suivant : Quarkus Google Cloud Functions<\/a>.<\/p>\n L\u2019exemple de fonction background que nous avons vu pr\u00e9c\u00e9demment a comme inconv\u00e9nient d\u2019\u00eatre d\u00e9pendant de l\u2019API Google Cloud Functions. Elle n\u2019est donc pas portable d\u2019un cloud \u00e0 l\u2019autre.<\/p>\n C\u2019est l\u00e0 qu\u2019entre en piste Funqy<\/strong>, l\u2019API de fonction de Quarkus, agnostique du cloud provider. On peut r\u00e9\u00e9crire la fonction background pr\u00e9c\u00e9dente via Funqy<\/strong> de la mani\u00e8re suivante :<\/p>\n Pour utiliser Funqy<\/strong>, il faut remplacer l\u2019extension Apr\u00e8s avoir packager votre application avec Maven, vous pouvez la d\u00e9ployer avec gcloud de la m\u00eame mani\u00e8re que pr\u00e9c\u00e9demment, sauf qu\u2019il vous faut utiliser l\u2019entry point Pour plus d\u2019informations sur Funqy<\/strong>, voir le guide suivant : Quarkus Funqy Google Cloud Functions<\/a>.<\/p>\n L\u2019exemple de fonction HTTP que nous avons vu pr\u00e9c\u00e9demment a comme inconv\u00e9nient d\u2019\u00eatre d\u00e9pendant de l\u2019API Google Cloud Functions. Elle n\u2019est donc pas portable d\u2019un cloud \u00e0 l\u2019autre.<\/p>\n De plus, la manipulation directe des objets request et response peut \u00eatre fastidieuse.<\/p>\n Pour pallier \u00e0 cela, Quarkus permet d\u2019utiliser ses diff\u00e9rentes extensions HTTP \u00e0 la place de l\u2019API de Google, votre fonction devient alors agnostique du cloud provider, et beaucoup plus simple \u00e0 \u00e9crire.<\/p>\n L\u2019exemple pr\u00e9c\u00e9dent peut \u00eatre r\u00e9\u00e9crit de la mani\u00e8re suivante en utilisant l\u2019extension RESTEasy<\/strong> :<\/p>\n Pour utiliser RESTEasy<\/strong>, il faut remplacer l\u2019extension Apr\u00e8s avoir packager votre application avec Maven, vous pouvez la d\u00e9ployer avec gcloud de la m\u00eame mani\u00e8re que pr\u00e9c\u00e9demment sauf qu\u2019il vous faut utiliser l\u2019entry point Il est aussi possible d’\u00e9crire des fonctions HTTP avec les autres frameworks HTTP de Quarkus : reactive routes, Undertow (servlet), Funqy HTTP ou Spring Web.<\/p>\n Pour plus d\u2019informations sur l\u2019utilisation des extensions HTTP via des Cloud Functions, voir le guide suivant : Quarkus Google Cloud Function HTTP bindings<\/a>.<\/p>\n Il est tr\u00e8s facile de cr\u00e9er des fonctions d\u00e9ployables dans Google Cloud avec les extensions d\u00e9di\u00e9s Quarkus. De plus Funqy (pour les fonctions brackground) et le binding HTTP (pour les fonctions HTTP) permettent de le faire sans que v\u00f4tre code soit li\u00e9s \u00e0 l’API de Google Cloud.<\/p>\n Les fonctions Google Cloud sont id\u00e9ales pour l’utilisation des services Google Cloud, un pack d’extension existe pour faciliter leurs utilisations au sein de Quarkus via le pack d’extension Google Cloud Services<\/a> qui permet d’utiliser BigQuery, BigTable, Firestore, PubSub, SecretManager, Spanner et Storage dans une application Quarkus.<\/p>","protected":false},"excerpt":{"rendered":" Quarkus est un framework de d\u00e9veloppement de microservice pens\u00e9 pour le cloud et les conteneurs. Il est pens\u00e9 pour avoir une utilisation m\u00e9moire r\u00e9duite et un temps de d\u00e9marrage le plus court possible. Il se base principalement sur des standards (Jakarta EE, Eclipse MicroProfile, \u2026) et permet l’utilisation de librairies Java matures et tr\u00e8s r\u00e9pandues via ses extensions (Hibernate, RESTeasy, Vert.X, Kafka, \u2026). Quarkus a \u00e9t\u00e9 pens\u00e9 pour le cloud d\u00e8s sa conception, il permet le d\u00e9veloppement d\u2019applications Cloud Ready…Background Function avec l\u2019API Google Cloud<\/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>, pour plus de simplicit\u00e9 j\u2019ai uniquement d\u00e9fini sa propri\u00e9t\u00e9 name.<\/li>\n<\/ol>\nmvn clean package<\/code>. Cette commande va cr\u00e9er un uberjar dans le r\u00e9pertoire target\/deployment<\/strong> que vous pourrez ensuite d\u00e9ployer comme une 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> et non votre fonction. Cet entry point va d\u00e9marrer Quarkus, puis localiser votre fonction dans le conteneur CDI.<\/p>\ngoogle.storage.object.finalize<\/code> et pr\u00e9ciser un nom de bucket, ici quarkus-hello<\/strong>. Ce bucket doit avoir \u00e9t\u00e9 cr\u00e9\u00e9 pr\u00e9c\u00e9dement via gsutil mb gs:\/\/quarkus-hello<\/code> ou la console Google Cloud.<\/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 avec l\u2019API Google Cloud<\/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>. Cette commande va cr\u00e9er un uberjar dans le r\u00e9pertoire target\/deployment<\/strong> que vous pourrez ensuite d\u00e9ployer comme une 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> et non votre fonction. Cet entry point va d\u00e9marrer Quarkus puis localiser votre fonction dans le conteneur CDI.<\/p>\nBackground Function avec 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> permet de dire \u00e0 Funqy<\/strong> que c\u2019est la m\u00e9thode \u00e0 appeler pour chaque d\u00e9clenchement de fonction.<\/li>\n\nStorageEvent<\/code>, pour plus de simplicit\u00e9 j\u2019ai uniquement d\u00e9fini sa propri\u00e9t\u00e9 name.<\/li>\n<\/ol>\nquarkus-google-cloud-functions<\/code> par l\u2019extension quarkus-funqy-google-cloud-functions<\/code>.<\/p>\nio.quarkus.funqy.gcp.functions.FunqyBackgroundFunction<\/code>. Ce qui donne :<\/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 avec 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> permettant de d\u00e9finir la classe comme une ressource REST.<\/li>\n\nquarkus-google-cloud-functions<\/code> par l\u2019extension quarkus-google-cloud-functions-http<\/code> et ajouter l\u2019extension RESTEasy<\/strong> : quarkus-resteasy-jackson<\/code>.<\/p>\nio.quarkus.gcp.functions.http.QuarkusHttpFunction<\/code>. Ce qui donne :<\/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