J’ai test\u00e9 les Java Google Cloud Functions en Alpha.<\/p>\n
Jusqu’ici, les Cloud Functions de Google n’\u00e9taient impl\u00e9mentables qu’en NodeJs, Go ou Python. Mais Google est en train de pr\u00e9parer l’ouverture d’un runtime Java (8 et 11), que j’ai pu tester en alpha release priv\u00e9e (pour s’inscrire, c’est ici<\/a>). Apr\u00e8s inscription \u00e0 l’alpha priv\u00e9e, vous aurez acc\u00e8s \u00e0 un document de tutoriel pas \u00e0 pas, et \u00e0 un forum d’aide en ligne.<\/p>\n On peut \u00e9crire deux types de fonctions : les fonctions HTTP et les fonctions \u00ab\u00a0t\u00e2che de fond\u00a0\u00bb ou background (pour r\u00e9agir \u00e0 un \u00e9v\u00e9nement Pub\/Sub ou Cloud Storage par exemple). Ici je vais vous pr\u00e9senter uniquement les fonctions HTTP.<\/p>\n En pr\u00e9-requis, il faut installer le SDK Google Cloud<\/a> qui comprend la ligne de commande Une fois ceci fait, vous voici pr\u00eat pour votre premi\u00e8re fonction en Java !<\/p>\n Un projet Cloud Function en Java est un projet Maven (ou Gradle) classique qui contient la librairie Voici ce qu’il faut mettre dans votre Nous allons ensuite cr\u00e9er notre premi\u00e8re fonction, celle-ci est une simple classe qui impl\u00e9mente l’interface Voici ce que \u00e7a donne, rien de compliqu\u00e9. Pour plus de facilit\u00e9 j’ai mis cette classe dans le package par d\u00e9faut, mais libre \u00e0 vous de la placer o\u00f9 bon vous semble.<\/p>\n Nous allons ensuite d\u00e9ployer notre fonction. Comme celle-ci est une simple classe sans d\u00e9pendance, on peut directement la d\u00e9ployer sans n\u00e9cessit\u00e9 de packaging pr\u00e9alable via Maven.<\/p>\n Le d\u00e9ploiement se fait, \u00e0 la racine du projet, via la commande suivante :<\/p>\n Cette ligne de commande va d\u00e9ployer une fonction HTTP nomm\u00e9e helloworld<\/strong>, en utilisant le runtime java11<\/strong>, dans le projet GCP en cours, et utilisant le point d’entr\u00e9e La commande prend pas mal de temps \u00e0 s’ex\u00e9cuter, voici son r\u00e9sultat :<\/p>\n Pour appeler notre fonction, il faut utiliser la valeur de Et voil\u00e0, notre premi\u00e8re fonction ! Facile non ?<\/p>\n Bon, une fonction sans librairie c’est pas super pratique, surtout si on veut r\u00e9aliser un endpoint REST. A minima il nous faudrait une librairie JSON.<\/p>\n Essayons donc un exemple plus complexe. Comme pr\u00e9c\u00e9demment, nous allons cr\u00e9er un projet Maven standard avec la d\u00e9pendance Puis, on va ajouter la librairie Gson pour pouvoir g\u00e9rer de la repr\u00e9sentation JSON :<\/p>\n Ensuite, on va cr\u00e9er une fonction Voici ce que \u00e7a donne (croyez-le ou pas mais j’ai \u00e9crit \u00e7a en une fois sans faute et j’en suis fi\u00e8re ;) ).<\/p>\n Et pour la classe Fruit tout simplement :<\/p>\n M\u00eame si cet exemple contient une librairie de plus, et deux classes dans deux fichiers diff\u00e9rents, on peut quand m\u00eame le d\u00e9ployer directement sans devoir le packager. Et \u00e7a, on peut l’avouer, c’est quand m\u00eame top !<\/p>\n Si vous voulez le packager comme un JAR, il faudrait alors r\u00e9aliser un JAR de type uber jar (ou fat jar) en utilisant le plugin maven shade, copier le JAR dans un r\u00e9pertoire, et utiliser l’option de ligne de commande Mais ici, on peut d\u00e9ployer tout simplement via cette commande (toujours \u00e0 la racine de votre projet) :<\/p>\n Et voici un petit exemple d’utilisation via curl :<\/p>\n Attention<\/strong> : si Google d\u00e9ploie une nouvelle instance de votre fonction pendant vos tests, comme les Fruits sont stock\u00e9s dans une La future version de Micronaut a un support pour les Cloud Functions de GCP. Celui-ci permet d’utiliser toutes les fonctionnalit\u00e9s de Micronaut (dont l’injection de d\u00e9pendances) pour \u00e9crire vos fonctions.<\/p>\n Pour d\u00e9marrer mon projet Micronaut, j’ai utilis\u00e9 Micronaut Launch<\/a>. Comme il cr\u00e9\u00e9 un Nous allons reprendre l’exemple pr\u00e9c\u00e9dent, et le r\u00e9-\u00e9crire via un Tout d’abord, externalisons la gestion des fruits dans un service :<\/p>\n Puis, \u00e9crivons un Pour d\u00e9ployer notre fonction, il faut d’abord la packager via Maven, puis la copier dans un r\u00e9pertoire dans lequel le JAR doit \u00eatre le seul fichier.<\/p>\n Notez ici qu’il faut allouer 512m pour que la fonction fonctionne. Mais il faut avouer que le fait que le packaging par d\u00e9faut fonctionne, et qu’on puisse \u00e9crire des fonctions HTTP aussi simplement qu’un simple Voici ensuite un exemple d’utilisation avec curl :<\/p>\n Attention<\/strong> : si Google d\u00e9ploie une nouvelle instance de votre fonction pendant vos tests, comme les Fruits sont stock\u00e9s dans une Pour aller plus loin avec Micronaut : le guide des fonctions HTTP<\/a> et l’exemple officiel<\/a>.<\/p>\n Il n’y a pas beaucoup de documentation expliquant comment \u00e7a marche. En regardant les logs on comprend qu’une fonction, c’est un d\u00e9ploiement dans AppEngine.<\/p>\n Si vous d\u00e9ployez une fonction sans la packager au pr\u00e9alable, la ligne de commande va d’abord la packager en utilisant Maven de mani\u00e8re transparente (je l’ai vu car j’avais un test qui ne passait pas et j’ai eu un joli message d’erreur Maven), avant de l’envoyer \u00e0 Google AppEngine. Si vous buildez votre fonction, la ligne de commande va se contenter de prendre le JAR build\u00e9 et de l’envoyer \u00e0 AppEngine.<\/p>\n Par d\u00e9faut, notre fonction a 256m de m\u00e9moire allou\u00e9es, et ses logs sont disponibles directement depuis la console GCP.<\/p>\n Apr\u00e8s, comme c’est du serverless<\/em>, on ne g\u00e8re ni le nombre de fonctions, ni quand une autre est d\u00e9ploy\u00e9e. M\u00eame en testant seul via curl, j’ai eu des re-d\u00e9ploiement de fonction (ou re-d\u00e9marrage). Comme toujours, attention donc au cold start !!!<\/p>\n Le support de Java dans Google Cloud Function \u00e9tait attendu de longue date, AWS et Azure supportant d\u00e9j\u00e0 Java.<\/p>\n L’impl\u00e9mentation est assez propre, une simple interface qui donne acc\u00e8s aux requ\u00eates et r\u00e9ponses HTTP et c’est tout ! J’aime \u00e7a ;)<\/p>\n Au niveau outillage, le build automatique de votre projet Maven est vraiment pratique, apr\u00e8s tout, une fonction est cens\u00e9e \u00eatre simple, et \u00e7a peut donc suffire pour pas mal d’utilisation. Pour des projets plus complexes, un simple uber JAR cr\u00e9\u00e9 avec le plugin shade suffit. On appr\u00e9cie de n’avoir rien de sp\u00e9cifique \u00e0 faire pour builder nos fonctions.<\/p>\n Le support de Java 8 et 11 est un plus, ce sont les deux versions les plus utilis\u00e9es. Par comparaison, Azure ne supporte toujours par Java 11 au jour d’\u00e9criture de cet article !<\/p>\n Google r\u00e9-utilise AppEngine pour faire tourner nos fonctions, et \u00e7a c’est bien car AppEngine est un outil stable, et qui fonctionne tr\u00e8s bien (certains diront que c’est le premier outil serverless … il est effectivement tr\u00e8s vieux).<\/p>\ngcloud<\/code>, puis s’authentifier \u00e0 Google Cloud et installer les composants alpha :<\/p>\n\ngcloud auth login\ngcloud components install alpha\n<\/pre>\n
Hello Google Function in Java<\/h2>\n
com.google.cloud.functions:functions-framework-api<\/code>.<\/p>\npom.xml<\/code>.<\/p>\n\n \n com.google.cloud.functions\n functions-framework-api\n 1.0.0-alpha-2-rc3\n provided\n \n<\/pre>\n
com.google.cloud.functions.HttpFunction<\/code>, cette interface contient une m\u00e9thode service<\/code> qui nous permet d’acc\u00e9der \u00e0 un objet HttpRequest<\/code> et un objet HttpResponse<\/code>. Nous allons utiliser le writer<\/code> de le l’objet response<\/code> pour \u00e9crire le traditionnel Hello World!<\/em>.<\/p>\n\nimport com.google.cloud.functions.HttpFunction;\nimport com.google.cloud.functions.HttpRequest;\nimport com.google.cloud.functions.HttpResponse;\nimport java.io.BufferedWriter;\nimport java.io.IOException;\n\npublic class Example implements HttpFunction {\n @Override\n public void service(HttpRequest request, HttpResponse response)\n throws IOException {\n var writer = response.getWriter();\n writer.write(\"Hello world!\");\n }\n}\n<\/pre>\n\ngcloud alpha functions deploy helloworld --entry-point Example --runtime java11 \\\n --trigger-http\n<\/pre>\n
Example<\/code> qui est notre fonction pr\u00e9c\u00e9demment cr\u00e9\u00e9e.<\/p>\n\nDeploying function (may take a while - up to 2 minutes)...done. \navailableMemoryMb: 256\nentryPoint: Example\nhttpsTrigger:\n url: https:\/\/us-central1-methodical-mesh-238712.cloudfunctions.net\/helloworld\ningressSettings: ALLOW_ALL\nlabels:\n deployment-tool: cli-gcloud\nname: projects\/methodical-mesh-238712\/locations\/us-central1\/functions\/helloworld\nruntime: java11\nserviceAccountEmail: ...\nsourceUploadUrl: ...\nGoogleAccessId=...\nstatus: ACTIVE\ntimeout: 60s\nupdateTime: '2020-05-06T08:50:23.833Z'\nversionId: '2'\n<\/pre>\n
httpsTrigger.url<\/code>, ici <a href="https:\/\/us-central1-methodical-mesh-238712.cloudfunctions.net\/helloworld">https:\/\/us-central1-methodical-mesh-238712.cloudfunctions.net\/helloworld<\/a><\/code><\/p>\n\ncurl https:\/\/us-central1-methodical-mesh-238712.cloudfunctions.net\/helloworld\n> Hello world!\n<\/pre>\n
Un exemple un peu plus complexe<\/h2>\n
com.google.cloud.functions:functions-framework-api<\/code>.<\/p>\n\n \n com.google.code.gson\n gson\n 2.8.5\n \n<\/pre>\n
FruitRestFunction<\/code> qui va impl\u00e9menter un POST pour cr\u00e9er un Fruit, et un GET pour r\u00e9cup\u00e9rer la liste des Fruits ou un seul, via le param\u00e8tre name<\/code>. Le tout s\u00e9rialis\u00e9 en JSON.<\/p>\n\npublic class FruitRestFunction implements HttpFunction {\n private Gson gson = new Gson();\n private Map fruits = new HashMap();\n\n @Override\n public void service(HttpRequest request, HttpResponse response)\n throws Exception {\n String data = null;\n if(request.getMethod().equalsIgnoreCase(\"POST\")){\n \/\/create a fruit\n Fruit fruit = gson.fromJson(request.getReader(), Fruit.class);\n fruits.put(fruit.name, fruit);\n data = \"{\\\"status\\\" : \\\"created\\\"}\";\n }\n else if (request.getMethod().equalsIgnoreCase(\"GET\")){\n if(request.getQueryParameters().containsKey(\"name\")){\n \/\/get a fruit\n Fruit fruit = fruits.get(request.getQueryParameters().get(\"name\").get(0));\n data = gson.toJson(fruit);\n }\n else {\n \/\/get all fruits\n data = gson.toJson(fruits.values());\n }\n }\n\n \/\/write to the response\n response.setContentType(\"application\/json; charset=utf-8\");\n response.getWriter().write(data);\n }\n}\n<\/pre>\n\npublic class Fruit {\n public String name;\n public String color;\n public String description;\n}\n<\/pre>\n--source=directory<\/code>.<\/p>\n\ngcloud alpha functions deploy fruit-rest \\\n --entry-point fr.loicmathieu.gcp.function.FruitRestFunction \\\n --runtime java11 --trigger-htt\n<\/pre>\n
\ncurl -X POST -d '{\"name\":\"apple\", \"color\":\"green\", \"description\":\"Delicious\"}' \\\n https:\/\/us-central1-methodical-mesh-238712.cloudfunctions.net\/fruit-rest\n> {\"status\" : \"created\"}\n\ncurl -X POST -d '{\"name\":\"banana\", \"color\":\"yellow\", \"description\":\"Yummy\"}' \\\n https:\/\/us-central1-methodical-mesh-238712.cloudfunctions.net\/fruit-rest\n> {\"status\" : \"created\"}\n\ncurl https:\/\/us-central1-methodical-mesh-238712.cloudfunctions.net\/fruit-rest\n> [{\"name\":\"banana\",\"color\":\"yellow\",\"description\":\"Yummy\"},{\"name\":\"apple\",\"color\":\"green\",\"description\":\"Delicious\"}]\n\ncurl https:\/\/us-central1-methodical-mesh-238712.cloudfunctions.net\/fruit-rest?name=banana\n> {\"name\":\"banana\",\"color\":\"yellow\",\"description\":\"Yummy\"}\n<\/pre>\nHashMap<\/code>, celle-ci sera vide. Il vous faudra donc recommencer vos tests …<\/p>\nMicronaut<\/h2>\n
pom.xml<\/code> un peu complexe, le mieux est d’aller voir directement dans l’exemple disponible sur GitHub : fruit-micronaut<\/a>.<\/p>\nController<\/code> Micronaut.<\/p>\n\n@Singleton\npublic class FruitService {\n private Map fruits = new HashMap();\n\n public Collection list(){\n return fruits.values();\n }\n\n public void add(Fruit fruit){\n fruits.put(fruit.name, fruit);\n }\n\n public Fruit get(String name){\n return fruits.get(name);\n }\n}\n<\/pre>\nController<\/code> standard Micronaut, qui sera utilis\u00e9 par notre fonction pour r\u00e9pondre \u00e0 chaque requ\u00eate HTTP :<\/p>\n\n@Controller(\"\/\")\npublic class FruitController {\n @Inject\n private FruitService fruitService;\n\n @Get(produces = MediaType.APPLICATION_JSON)\n public Collection list() {\n return fruitService.list();\n }\n\n @Get(\"\/{name}\")\n @Produces(MediaType.APPLICATION_JSON)\n public Fruit get(String name) {\n return fruitService.get(name);\n }\n\n @Post(processes = MediaType.APPLICATION_JSON)\n @Status(HttpStatus.CREATED)\n public ResponseStatus savePet(@Body Fruit fruit) {\n fruitService.add(fruit);\n return new ResponseStatus(\"created\");\n }\n\n public static class ResponseStatus {\n public String status;\n\n public ResponseStatus(String status) {\n this.status = status;\n }\n }\n}\n<\/pre>\n\nmvn clean package\n\nmkdir deployment\n\ncp target\/fruit-micronaut-0.1.jar deployment\/\n\ngcloud alpha functions deploy fruit-micronaut \\\n --entry-point io.micronaut.gcp.function.http.HttpFunction \\\n --runtime java11 --trigger-http --source deployment\/ --memory 512MB\n<\/pre>\n
\nLe support ne semble pas encore parfait (ou je n’ai pas bien suivi les instructions), car on voit dans les logs que Micronaut ouvre le port 8080 ce qui ne devrait pas \u00eatre le cas.<\/p>\nController<\/code>, est un vrai plus. Le support est bien pens\u00e9 et fonctionne sans trop de soucis.<\/p>\n\ncurl -X POST -d '{\"name\":\"apple\", \"color\":\"green\", \"description\":\"Delicious\"}' \\\n -H \"Content-Type: application\/json\" \\\n https:\/\/us-central1-methodical-mesh-238712.cloudfunctions.net\/fruit-micronaut\n> {\"status\" : \"created\"}\n\ncurl -X POST -d '{\"name\":\"banana\", \"color\":\"yellow\", \"description\":\"Yummy\"}' \\\n -H \"Content-Type: application\/json\" \\\n https:\/\/us-central1-methodical-mesh-238712.cloudfunctions.net\/fruit-micronaut\n> {\"status\" : \"created\"}\n\ncurl https:\/\/us-central1-methodical-mesh-238712.cloudfunctions.net\/fruit-micronaut\n> [{\"name\":\"banana\",\"color\":\"yellow\",\"description\":\"Yummy\"},{\"name\":\"apple\",\"color\":\"green\",\"description\":\"Delicious\"}]\n\ncurl https:\/\/us-central1-methodical-mesh-238712.cloudfunctions.net\/fruit-micronaut?name=banana\n> {\"name\":\"banana\",\"color\":\"yellow\",\"description\":\"Yummy\"}\n<\/pre>\nHashMap<\/code>, celle-ci sera vide. Il vous faudra donc recommencer vos tests …<\/p>\nComment \u00e7a marche<\/h2>\n
Conclusion<\/h2>\n