Comment personnaliser la bannière d'un projet Quarkus

Il fut un temps où nous apprenions à façonner l’enseigne d’une auberge sous Spring Boot.
Aujourd’hui, c’est dans une taverne bâtie sur Quarkus que nous allons œuvrer.

Car même les établissements les plus robustes ont besoin d’un signe distinctif à leur porte.

L’enseigne par défaut

Lorsque votre taverne Quarkus ouvre ses portes, une enseigne apparaît aussitôt dans les registres (les logs).
Sobre, efficace… mais impersonnelle.

Elle fait le travail, certes.
Mais elle ne raconte rien de votre histoire.

Comme toute bonne auberge, il est possible soit de la retirer, soit de la remplacer par une enseigne digne de ce nom.

Faire disparaître l’enseigne

Parfois, la discrétion est préférable. Une taverne sans pancarte attire moins les curieux… et certains ennuis.

Deux méthodes s’offrent à vous :

Les propriétés de votre projet
Paramètre au démarrage de l'application

Dans le registre de la taverne

Pour désactiver la bannière depuis votre fichier application.properties, vous n'avez qu'à rajouter la ligne suivante à l'intérieur :

quarkus.banner.enabled=false

Dès lors, plus aucune enseigne ne viendra annoncer l’ouverture.

À l’ouverture des portes

Si vous préférez une décision prise au dernier moment, vous pouvez passer par un paramètre au démarrage.

Si vous utilisez maven pour lancer votre application :

quarkus:dev -Dquarkus.banner.enabled=false

run via maven

Si vous utilisez Quarkus CLI pour lancer votre application :

quarkus dev -Dquarkus.banner.enabled=false

Dans les deux cas, la taverne ouvre ses portes en silence.

Façonner votre propre enseigne

Mais une vraie taverne mérite mieux qu’un simple effacement.
Elle mérite une enseigne sculptée, reconnaissable entre mille.

Pour cela, deux étapes suffisent :

Graver votre enseigne dans un fichier texte
Indiquer à Quarkus où la trouver

quarkus.banner.path=banner.txt

À l’ouverture de votre taverne, cette enseigne apparaîtra fièrement dans les registres.

Oh no not again !
     (")
     \)/
    _____
    \___/

                      Hello ground !!
        .-------------'```'----....,,__                        _,
       |                               `'`'`'`'-.,.__        .'(
       |                                             `'--._.'   )
       |                                                   `'-.<
       \               .-'`'-.                            -.    `\
        \               -.o_.     _                     _,-'`\    |
         ``````''--.._.-=-._    .'  \            _,,--'`      `-._(
           (^^^^^^^^`___    '-. |    \  __,,..--'                 `
            `````````   `'--..___\    |`
                                  `-.,'

exemple de bannière en ASCII art

Si j'ai le contenu ci-dessus dans mon fichier banner.txt, au démarrage de mon application j'aurai le rendu suivant dans les logs :