Formation Arvida›Digital.ai Release›Cas d'usage Nexapay›Module 401

Sommaire
ARVIDA OFFRE DE SERVICE Digital.ai Release · OFR0004-401

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.

Durée 45 minExercice aucunJour 2

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.

DossierContenuQuand on y va
binLes scripts de démarrage et d'installation en serviceÀ l'installation, à chaque montée de version
confLes fichiers de configuration : base de données, sécurité, licenceÀ l'installation, pour brancher un fournisseur d'identité
extLes extensions locales : types personnalisés, endpoints REST maisonQuand on étend Release sans écrire un plugin complet
hotfixLes correctifs fournis par Digital.ai sur demandeSur instruction du support
libLes bibliothèques Java, dont le pilote JDBC de la baseÀ l'installation, pour y déposer le pilote
logLes journaux du serveurQuand une tâche automatisée échoue sans explication claire
plugins/xlr-officialLes plugins fournis par Digital.aiPour vérifier qu'un plugin est présent, par exemple ArgoCD
plugins/__local__Les plugins développés en internePour déposer un plugin maison
serviceWrapperCe 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.

A · ARCHITECTURE SIMPLE · un serveur, deux bases Utilisateurs navigateur · HTTPS clients de l'API REST, MCP port 5516 SERVEUR RELEASE · 1 nœud 4 cœurs · 8 Go · JDK 17 JVM Release · cœur + plugins moteur d'exécution, éditeur de flow, dashboards, sécurité, API REST conf/ plugins/ ext/ log/ les trois dossiers à sauvegarder avec les deux bases ; log/ ne se sauvegarde pas tourne en service système, sous un compte dédié, jamais root JDBC Repository templates, releases, folders, variables, journal, utilisateurs Archive releases terminées, lues par les dashboards PostgreSQL, MySQL, Oracle ou SQL Server deux bases, souvent un seul serveur de bases Outils intégrés par les tâches : Gitea · Redmine · ArgoCD · annuaire LDAP ou OIDC Ce que ça vaut Suffit à une équipe, à un lab, à une plateforme de formation. Un redémarrage arrête tout le monde.
B · CLUSTER ACTIF / ACTIF · trois nœuds sur machines virtuelles Utilisateurs navigateur, API Répartiteur de charge HAProxy, nginx, F5 TLS · sessions collantes une seule adresse publique CLUSTER RELEASE · 3 nœuds identiques même version, plugins, conf/ VM 1 · nœud 1 VM 2 · nœud 2 VM 3 · nœud 3 JVM Releaseport 5516 JVM Releaseport 5516 JVM Releaseport 5516 conf/ plugins/ ext/ conf/ plugins/ ext/ conf/ plugins/ ext/ exécute des releaseset sert l'interface exécute des releaseset sert l'interface exécute des releaseset sert l'interface Quorum : la majorité décide 3 nœuds, majorité à 2 : un nœud tombe ou s'isole, les deux autres continuent. Avec 2 nœuds, pas de majorité : chacun pourrait se croire seul. Toujours un nombre impair. BASES PARTAGÉES Repository une seule base pour les trois nœuds Archive idem La base est le vrai point unique de défaillance : à rendre haute dispo de son côté (réplication). Ce que ça vaut Montée de version nœud par nœud sans couper le service. Trois VM à patcher, trois conf/ à garder identiques à la main. trafic HTTPS des utilisateurs, réparti liaison entre membres du cluster : état, verrous, élection JDBC vers les bases partagées Ce qui doit être identique sur les trois VM version de Release, JDK, liste des plugins, conf/ (sauf le nom du nœud), chaîne JDBC, licence Ce qui reste unique l'adresse publique (le répartiteur), les deux bases, le compte de service
C · KUBERNETES · installé par l'opérateur Digital.ai, trois pods en cluster Utilisateurs navigateur, API CLUSTER KUBERNETES · namespace digitalai un chart Helm, un opérateur, une commande d'installation Ingress nginx ou HAProxy TLS · sessions collantes release.formation… Service Opérateur Digital.ai Release · lit la ressource DigitalaiRelease et crée tout ce qui suit STATEFULSET RELEASE · 3 réplicas même image, même conf, quorum à 2 xl-release-0 xl-release-1 xl-release-2 pod · JVM Releasepod · JVM Releasepod · JVM Release port 5516port 5516port 5516 PVC conf/ plugins/ PVC conf/ plugins/ PVC conf/ plugins/ Un pod tombe : Kubernetes le recrée avec son volume, il rejoint le cluster. Montée de version : on change l'image, les pods roulent un par un. Le quorum est le même qu'en VM ; ce qui change, c'est qui remet le nœud debout. PostgreSQL repository + archive dans le cluster, ou base managée RabbitMQ file de messages livrée par le chart, échanges entre les pods Keycloak optionnel SSO OpenID Connect, fourni par le chart ou remplacé par l'annuaire du client Ce que l'administrateur écrit, et rien d'autre un fichier de valeurs : nom de domaine, nombre de réplicas, classe de stockage, mots de passe, licence, choix d'une base interne ou externe, Keycloak oui ou non puis helm install (ou xl kube install) ; l'opérateur fait le reste et le refait à chaque changement du fichier Sauvegarde : la base PostgreSQL et les volumes des pods. Le reste se régénère depuis le fichier de valeurs. Ce que ça vaut Haute dispo et montée de version automatisées. Demande un cluster Kubernetes déjà exploité par une équipe qui sait le tenir. trafic HTTPS liaison entre membres du cluster JDBC créé ou piloté par l'opérateur

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.

ArchitectureQuand la choisirCe qu'il fautCe qui arrête le service
A · SimpleUne équipe, un lab, une plateforme de formation, un premier déploiementUn serveur, un JDK, une base de données, l'archive ZIPTout redémarrage, toute montée de version, toute panne du serveur
B · Cluster 3 nœuds sur VMPlusieurs é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 · KubernetesUne plateforme Kubernetes déjà exploitée, le besoin d'installer et de monter de version par un fichierUn cluster, une classe de stockage, le chart et l'opérateur Digital.ai, un fichier de valeursLe 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

ÉtapeCommande ou action
PrérequisQuad core, 8 GB RAM, JDK 17, base PostgreSQL / MySQL / Oracle / MSSQL, chaîne JDBC, archive téléchargée
Extraireunzip xl-release-<version>-server.zip -d /opt/
Pilote JDBCCopier le .jar du pilote dans lib/
Configurercd 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'exploitantRé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.