M401 : Comprendre l'installation et l'architecture de la plateforme
De quoi la plateforme est faite
Architecture, installation et choix de déploiement, pour ceux qui utilisent Release sans l'administrer.
Ce que vous allez retenir
Ce module est une présentation, sans exercice. Vous n'installerez pas Release, mais vous devez savoir de quoi la plateforme est faite, ce qu'il faut sauvegarder, et ce que vos choix d'architecture changent pour ceux qui l'utilisent.
L'architecture de Release
Release est une application Java qui tourne dans une JVM, construite autour d'un cœur et étendue par des plugins. Le cœur porte le moteur d'exécution des releases, l'éditeur de flow, les dashboards, la sécurité et l'API REST. Les plugins apportent les types de tâches : la catégorie Webhook, le plugin ArgoCD, Jira, Jenkins, et les vôtres. Des export hooks permettent d'envoyer les données vers un outil de BI externe.
Tout ce que vous avez créé depuis hier, templates, releases, folders, variables, History, vit dans le repository, une base de données externe : PostgreSQL, MySQL, Oracle ou SQL Server. Les releases terminées sont déplacées dans une seconde base, l'archive, celle que les dashboards du module 302 interrogent. La sécurité repose sur Spring : utilisateurs internes, ou fournisseur d'identité externe en LDAP, SAML ou OpenID Connect.
La règle à retenir
Release ne garde rien dans ses fichiers, tout est en base. Sauvegarder Release, c'est sauvegarder deux bases de données et trois dossiers de configuration. Perdre le serveur n'est pas perdre les releases.
La distribution et l'installation
Release est livré en archive ZIP, la même pour Windows et Linux, à extraire dans un dossier court : /opt/xl-release-<version>-server/ sous Linux, C:\Apps\xl-release-<version>-server sous Windows. Le serveur écoute sur le port 5516.
| Dossier | Contenu | Quand on y va |
|---|---|---|
| bin | Les scripts de démarrage et d'installation en service | À l'installation, à chaque montée de version |
| conf | Les fichiers de configuration : base de données, sécurité, licence | À l'installation, pour brancher un fournisseur d'identité |
| ext | Les extensions locales : types personnalisés, endpoints REST maison | Quand on étend Release sans écrire un plugin complet |
| hotfix | Les correctifs fournis par Digital.ai sur demande | Sur instruction du support |
| lib | Les bibliothèques Java, dont le pilote JDBC de la base | À l'installation, pour y déposer le pilote |
| log | Les journaux du serveur | Quand une tâche automatisée échoue sans explication claire |
| plugins/xlr-official | Les plugins fournis par Digital.ai | Pour vérifier qu'un plugin est présent, par exemple ArgoCD |
| plugins/__local__ | Les plugins développés en interne | Pour déposer un plugin maison |
| serviceWrapper | Ce qu'il faut pour tourner en service système | À l'installation |
Les prérequis : un serveur avec quatre cœurs et 8 Go de mémoire, un JDK 17 Oracle ou OpenJDK, une base de données dédiée parmi les quatre supportées, et sa chaîne de connexion JDBC. L'installation tient en quatre gestes : extraire l'archive, aller dans bin, lancer run.sh -setup (ou run.cmd), répondre aux questions. Pour que Release redémarre avec le serveur, install-service.sh l'installe en service, sous un compte dédié, jamais root.
Trois architectures de déploiement
Les mêmes briques se posent de trois façons selon ce qu'on attend de la plateforme. Dans les trois cas, les données sont dans les bases, jamais sur le serveur : c'est ce qui rend le passage de l'une à l'autre possible sans rien perdre.
Les trois architectures, du plus simple au plus outillé. Les plateformes de cette formation sont en architecture A ; celle de Nexapay, dans le cas d'usage, serait en B ou en C.
| Architecture | Quand la choisir | Ce qu'il faut | Ce qui arrête le service |
|---|---|---|---|
| A · Simple | Une équipe, un lab, une plateforme de formation, un premier déploiement | Un serveur, un JDK, une base de données, l'archive ZIP | Tout redémarrage, toute montée de version, toute panne du serveur |
| B · Cluster 3 nœuds sur VM | Plusieurs équipes, des releases qui tournent la nuit, une exigence de disponibilité | Trois VM identiques, un répartiteur de charge, une base rendue haute dispo de son côté | La base, si elle n'est pas répliquée. Un nœud en moins ne se voit pas |
| C · Kubernetes | Une plateforme Kubernetes déjà exploitée, le besoin d'installer et de monter de version par un fichier | Un cluster, une classe de stockage, le chart et l'opérateur Digital.ai, un fichier de valeurs | Le cluster lui-même ; un pod en moins est recréé |
La règle à retenir
Le quorum est une affaire de majorité, pas de puissance. Trois nœuds moyens valent mieux que deux gros : avec deux, un nœud isolé ne sait pas s'il est seul au monde ou si c'est l'autre qui a disparu. Avec trois, la majorité tranche, et ça vaut sur VM comme sur Kubernetes.
Aide-mémoire
Installation
| Étape | Commande ou action |
|---|---|
| Prérequis | Quad core, 8 GB RAM, JDK 17, base PostgreSQL / MySQL / Oracle / MSSQL, chaîne JDBC, archive téléchargée |
| Extraire | unzip xl-release-<version>-server.zip -d /opt/ |
| Pilote JDBC | Copier le .jar du pilote dans lib/ |
| Configurer | cd bin && ./run.sh -setup, répondre : port, HTTPS, base de données, mot de passe admin, licence |
| Démarrer | ./run.sh, puis http://<serveur>:5516 |
| Service | ./install-service.sh, compte de service non root ; le service démarre seul |
Démonstration du formateur
20 minutes, sur une machine virtuelle vierge. Le formateur déroule les six étapes ci-dessus, montre le contenu de conf/ après le setup, le journal dans log/ au premier démarrage, et vérifie dans plugins/xlr-official que le plugin ArgoCD est bien là avant d'ouvrir l'interface.
Ce que ça change pour vous
| Question d'exploitant | Réponse |
|---|---|
| Que faut-il sauvegarder ? | Les deux bases, le dossier conf, les plugins locaux et les extensions |
| Une release en cours survit-elle à un redémarrage ? | Oui : son état est en base. Les tâches automatisées en cours sont reprises ou passent en échec, à relancer |
| D'où viennent les types de tâches ArgoCD et Webhook ? | Des plugins. Un plugin absent, et les tâches correspondantes ne s'ouvrent plus |
| Où regarder quand une tâche échoue sans explication ? | Le commentaire de la tâche d'abord, puis log/xl-release.log sur le serveur |
| Qui peut créer des connexions et des variables globales ? | Les administrateurs, par les permissions globales du module 202 |
Support d'exercices de l'offre de service Digital.ai Release - Administration (ACOSS) (OFR0004). Le cas Nexapay est fictif et l'outil Redmine est simulé pour la formation. Une erreur, une suggestion ? Écris à William Gravier, wgravier@arvida.fr.