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\u2019utilisation 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 ) et Cloud Native (utilisation les capacit\u00e9s des clouds publics pour d\u00e9velopper vos applications).<\/p>\n
Google Cloud Run est une solution de Container As A Service qui permet d’ex\u00e9cuter des services d’interface et de backend, des jobs par lot, des LLM h\u00f4tes et des charges de travail de traitement de file d’attente sans avoir \u00e0 g\u00e9rer l’infrastructure.<\/p>\n
Quarkus est donc une bonne solution pour d\u00e9velopper une application \u00e0 d\u00e9ployer dans Cloud Run.<\/p>\n
Premi\u00e8re \u00e9tape, cr\u00e9er une application Quarkus:<\/p>\n
\nquarkus create app quarkus-cloud-run\n<\/pre>\nLe projet sera g\u00e9n\u00e9r\u00e9 dans un r\u00e9pertoire
quarkus-cloud-run<\/code>, d\u00e9placez-vous \u00e0 la racine de celui-ci puis lancer l’application viaquarkus dev<\/code>.<\/p>\nVous pouvez tester l’application via
curl localhost:8080\/hello<\/code>.<\/p>\nUne application Quarkus peut fonctionner dans une JVM ou comme une application native, nous allons ici choisir un d\u00e9ploiment en image native qui est plus adapt\u00e9 aux d\u00e9ploiements cloud.<\/p>\n
Pour builder l’application en image native, vous pouvez utiliser la commande suivante :<\/p>\n
\ncp src\/main\/docker\/Dockerfile.native Dockerfile\nquarkus build --native\n<\/pre>\nD\u00e9ployer dans Google Cloud Run<\/h2>\n
Par d\u00e9faut,
gcloud<\/code> va envoyer tous les fichiers de votre application sauf ceux d\u00e9finis dans votre.gitignore<\/code> pour packager votre application, vous pouvez ajouter dans un fichier.gcloudignore<\/code> des r\u00e9pertoires ou fichier \u00e0 ignorer, par exemple le r\u00e9pertoire de l’application :src\/<\/code>.<\/p>\nPour cr\u00e9er un conteneur, nous allons utiliser le Dockerfile fournit par Quakus dans
src\/main\/docker\/Dockerfile.native<\/code>, il suffit de le copier \u00e0 la racine pour qu’il soit utilis\u00e9 par d\u00e9faut :<\/p>\n\ncp src\/main\/docker\/Dockerfile.native Dockerfile\n<\/pre>\nAttention<\/strong> : ce Dockerfile contient une directive qui n’est pas compatible avec Cloud Build, il faut en modifier la directive
COPY<\/code> pour en retirer les options--chown<\/code> etchmod<\/code> :<\/p>\n\nCOPY target\/*-runner \/work\/application\n<\/pre>\nCloud Build peut packager votre application et la mettre \u00e0 disposition de Cloud Run dans la container registry de Google Cloud. Vous pouvez utiliser la commande suivante qui va utiliser par d\u00e9faut le
Dockerfile<\/code> situ\u00e9 \u00e0 la racine de votre application :<\/p>\n\ngcloud builds submit --tag gcr.io\/PROJECT-ID\/quarkus-cloud-run\n<\/pre>\nUne fois le build termin\u00e9, vous pouvez lancer votre application via Cloud Run gr\u00e2ce \u00e0 la commande suivante qui va utiliser pour cela le conteneur pr\u00e9c\u00e9demment cr\u00e9er par Cloud Build:<\/p>\n
\ngcloud run deploy --image gcr.io\/PROJECT-ID\/quarkus-cloud-run\n<\/pre>\nUne fois l’application d\u00e9ploy\u00e9e,
gcloud<\/code> va afficher dans ses logs le Service URL<\/strong> qui nous permet d’acc\u00e9der \u00e0 l’application.<\/p>\nVous pouvez tester l’application via
curl SERVICE_URL\/hello<\/code>.<\/p>\nAjouter un Health Check<\/h2>\n
Cloud Run supporte l’utilisation de Health Check sous forme de startup probe, liveness probe et readiness probe.<\/p>\n
Quarkus supporte les Health Check via l’extension SmallRye Health, vous pouvez l’ajouter \u00e0 votre application via :<\/p>\n
\nquarkus extension add smallrye-health\n<\/pre>\nIl faut ensuite builder de nouveau l’application :<\/p>\n
\nquarkus build --native\ngcloud builds submit --tag gcr.io\/PROJECT-ID\/quarkus-cloud-run\n<\/pre>\nLors du d\u00e9ploiement, il faut sp\u00e9cifier \u00e0 Cloud Run les health checks de l’application, ici, j’ai uniquement sp\u00e9cifi\u00e9 une startup probe :<\/p>\n
\ngcloud run deploy --image gcr.io\/PROJECT-ID\/quarkus-cloud-run \\\n --startup-probe httpGet.path=\/q\/health\/started,httpGet.port=8080\n<\/pre>\nQuarkus expose diff\u00e9rentes endpoints pour health check :<\/p>\n
\n
- \/q\/health\/started<\/li>\n
- \/q\/health\/live<\/li>\n
- \/q\/health\/ready<\/li>\n<\/ul>\n
Vous pouvez les utiliser pour les diff\u00e9rents health checks support\u00e9s par Cloud Run. Plus d’information sur les health checks de cloud run et la mani\u00e8re de les d\u00e9clarer ici<\/a>.<\/p>\n