Créez votre environnement de développement Quarkus en 10 minutes avec WSL

La première étape de notre guide consiste à installer une distribution Linux dans WSL.

Dans un terminal Windows, nous exécutons la commande suivante :

La distribution Linux installée par défaut est Ubuntu, mais il est possible de spécifier une autre distribution Linux parmi celles proposées Microsoft.

À la fin de l’installation, après avoir entré un nom d’utilisateur ainsi qu’un mot de passe, nous sommes redirigés vers le shell Bash d’Ubuntu.

Nous terminons cette étape par la mise à jour du système Ubuntu :

SDKMan! est un outil facilitant l’installation et la gestion de SDKs (Java, Scala, Maven, Quarkus, etc.) sur les environnements de type Unix.

Nous devons au préalable installer les dépendances requises par SDKMan! :

Puis nous installons SDKMan! :

Enfin, nous exécutons la commande suivante pour rendre SDKMan! utilisable dans notre terminal :

SDKMan! permet d’installer différentes distributions du JDK.

Ici, nous installons Mandrel, une distribution dérivée de GraalVM Community Edition. Cette distribution se comporte comme un JDK classique, mais permet également de compiler nativement des applications Quarkus, comme nous le verrons plus loin dans ce guide.

Pour installer Mandrel avec SDKMan!, nous exécutons la commande suivante :

Quarkus CLI est un outil permettant de créer des projets Quarkus, de gérer les extensions et de faciliter les tâches de développement et de build.

Pour installer Quarkus CLI avec SDKMan!, nous exécutons la commande suivante :

Nous allons maintenant créer un projet Quarkus de démonstration, qui nous sera utile pour les étapes suivantes de ce guide.

Nous créons au préalable un répertoire pour nos projets :

Puis, dans ce répertoire, nous créons notre projet Quarkus :

L’application est alors générée dans un répertoire nommé code-with-quarkus.

Enfin, nous naviguons dans ce répertoire :

Pour lancer le build du projet, nous exécutons la commande suivante :

Une fois la phase de build terminée, nous obtenons un fichier Jar exécutable.

Nous pouvons alors démarrer l’application :

WSL permet d’accéder à l’application s’exécutant dans la distribution Linux depuis Windows, en utilisant localhost.

Nous pouvons alors vérifier le bon fonctionnement de l’application en allant sur http://localhost:8080/hello.

La page doit afficher le message suivant : Hello from Quarkus REST.

Nous pouvons maintenant quitter l’application (CTRL+C).

Un des principaux avantages de Quarkus est de pouvoir compiler nativement une application afin que celle-ci démarre plus rapidement et soit moins consommatrice en ressources CPU et RAM.

Avant de pouvoir compiler nativement l’application, nous devons installer les packages supplémentaires dont dépend Mandrel pour produire un exécutable natif. On retrouve le package build-essential qui contient notamment le compilateur et les bibliothèques de développement C, et zlib1g-dev qui contient la bibliothèque de compression zlib :

Nous pouvons alors exécuter le build natif du projet avec Quarkus CLI :

Une fois le build terminé, nous pouvons démarrer l’application avec la commande suivante :

On notera que le démarrage de l’application est plus rapide que dans le cas de l’exécution dans une JVM.

Il est très fréquent d’avoir à construire une image en vue de la déployer dans une infrastructure type Kubernetes.

Afin de pouvoir générer une image, nous avons besoin d’un environnement d’exécution tel que Podman.

Nous installons Podman avec la commande suivante :

Nous ajoutons l’extension container-image-podman à notre projet Quarkus. Cette dernière permet la génération d’images via Podman.

Nous pouvons alors exécuter le build de l’image :

Une fois la phase de build terminée, nous pouvons démarrer l’image dans Podman :

Comme dans les exemples précédents, nous pouvons accéder à l’application en allant sur http://localhost:8080/hello depuis Windows.

Nous terminons ce guide par l’installation d’un éditeur de code qui nous permettra d’effectuer des changements dans notre projet Quarkus.

Visual Studio Code (VS Code), avec son extension WSL, permet d’éditer du code dans un environnement Linux depuis Windows, en mode client-serveur.

VS Code est disponible depuis https://code.visualstudio.com/.

Lors de l’installation, il est important de cocher l’option Add to PATH. Le PATH étant partagé entre Windows et Ubuntu, nous pourrons alors lancer VS Code directement depuis notre Shell Bash Ubuntu.

Une fois VS Code démarré, nous installons l’extension WSL depuis la vue Extensions.

Enfin, nous fermons puis relançons notre terminal Windows afin que la modification du PATH soit prise en compte, et que VS Code soit accessible depuis WSL.

Une fois le terminal Windows rouvert, nous accédons au Shell Bash d’Ubuntu en exécutant la commande suivante :

Puis, nous ouvrons notre projet Quarkus dans Visual Studio Code :

VS Code démarre alors dans Windows puis installe la partie serveur sur notre environnement Ubuntu. Une fois la partie serveur installée, le projet Quarkus s’ouvre dans l’éditeur.

Nous avons vu dans ce guide à quel point il était simple et rapide de configurer un environnement Quarkus prêt à l’emploi avec WSL. L’environnement Linux ainsi que les outils nécessaires pour pouvoir développer avec Quarkus sont installés de manière transparente, sans nécessiter l’installation d’une machine virtuelle traditionnelle ou la mise en place d’un dual-boot. Enfin, développer dans WSL depuis Windows de façon productive est rendu possible grâce au mode remote de Visual Studio Code.