hub

Documentation de Talaxie Runtime

Le runtime open source qui exécute les routes, les services et les jobs construits avec Talaxie Studio.

Vue d'ensemble

Talaxie Runtime est une distribution Apache Karaf.

Contenu

  • Apache Camel et Apache CXF, pour les routes et les services REST et SOAP ;
  • le client Apache ActiveMQ ;
  • les modules ESB.
Composant Version
Java17 ou 21
Apache Karaf4.4.6
Apache Camel4.8.1
Apache CXF4.1.8
Client ActiveMQ6.2.7
Spring6.1
Pax Web / Jetty11 / 12
API d'entrepriseJakarta EE 10
info Le runtime repose sur Camel 4, CXF 4.1 et Jakarta EE 10.

Installation et démarrage

Prérequis

  • Java 17 ou 21.
  • Les ports 8040, 9001, 8101, 1099 et 44444 libres.

Installer

Décompressez l'archive.

Linux / macOS
tar xzf talaxie-runtime-<version>.tar.gz
cd talaxie-runtime-<version>
bin/trun
Windows (PowerShell)
mkdir C:\Talaxie
tar -xf talaxie-runtime-<version>.zip -C C:\Talaxie
cd C:\Talaxie\talaxie-runtime-<version>
bin\trun.bat
info Sous Windows, décompressez dans un dossier court.

Modes de lancement

Commande Effet
bin/trunDémarre avec la console interactive.
bin/trun serverDémarre sans console.
bin/start · bin/stop · bin/statusDémarre en arrière-plan, arrête, indique l'état.
bin/client -u tadmin -p tadminOuvre une console sur un runtime déjà démarré.
bin/trun runMode utilisé par l'image de conteneur.

Pour arrêter le runtime depuis la console : Ctrl+D ou system:shutdown.

Ports par défaut

Service Port Fichier de configuration
HTTP8040etc/org.ops4j.pax.web.cfg
HTTPS9001etc/org.ops4j.pax.web.cfg
Console SSH8101etc/org.apache.karaf.shell.cfg
JMX (RMI registry / server)1099 / 44444etc/org.apache.karaf.management.cfg

Les services CXF sont publiés sous http://localhost:8040/services/.

Comptes de démonstration

Utilisateur Mot de passe Rôles
tadmintadminadmingroup, sl_admin
tesbtesbadmingroup, sl_maintain
karafkarafadmingroup
warning Changez-les avant toute utilisation réelle.

Image de conteneur

Le build produit aussi une image de conteneur :

docker load -i talaxie-runtime-docker/target/jib-image.tar
docker run -p 8040:8040 -p 8101:8101 talaxie/talaxie-runtime:<version>

Déployer des jobs, des routes et des services

Le runtime installe tout fichier déposé dans le dossier deploy/.

1. Construire dans Talaxie Studio

Utilisez Build Job avec le type OSGI Bundle For ESB.

2. Déposer le fichier dans deploy/

Le runtime installe et démarre le bundle en quelques secondes :

# Linux / macOS
cp DemoJob-0.1.jar talaxie-runtime-<version>/deploy/

# Windows (PowerShell)
Copy-Item DemoJob-0.1.jar C:\Talaxie\talaxie-runtime-<version>\deploy\

3. Vérifier

Vérifiez que le bundle est Active et lisez le journal :

karaf@trun()> bundle:list | grep -i DemoJob
karaf@trun()> log:tail

curl -X POST -H "Content-Type: application/json" -d '{...}' http://localhost:8040/services/demo/items

Paramètres de contexte

Chaque job lit sa configuration sous un PID égal à son nom.

etc/DemoJob.cfg
context = Production
customerId = 42
mode = full
Ou depuis la console :
config:edit DemoJob
config:property-set customerId 42
config:update
lock Une valeur ENC(…) est déchiffrée au lancement du job.

Services optionnels

Ces services ne démarrent pas par défaut.

Raccourci Service Accès
tesb:start-locatorServeur du service locator (ZooKeeper)port 2181
tesb:start-samServeur SAM, services SOAP et REST, base Derby embarquée/services/sam/
/services/MonitoringServiceSOAP?wsdl
tesb:start-sam-retrieval-serviceServeur SAM, service REST seulement/services/sam/
tesb:start-stsSecurity Token Service/services/SecurityTokenService/UT?wsdl
tesb:start-aux-storeStockage auxiliaire—
tesb:start-locator-monitorSupervision du service locator—
tesb:start-locator-commandsCommandes tlocator:list et tlocator:remove—
tesb:start-allSTS, SAM, service locator et stockage auxiliaire—

Base de données de SAM

SAM utilise par défaut une base Derby embarquée.

tesb-datasource-derby tesb-datasource-h2 tesb-datasource-mysql tesb-datasource-postgresql tesb-datasource-sqlserver tesb-datasource-oracle tesb-datasource-db2

Les pilotes JDBC d'Oracle et de DB2 ne sont pas redistribuables.

Configuration

JVM et mémoire

Les options de la JVM se règlent dans bin/setenv.

bin/setenv
export JAVA_MAX_MEM=2048M
bin\setenv.bat
set JAVA_MAX_MEM=2048M
info bin/setenv ouvre aussi les packages du JDK dont ont besoin les jobs.

Fichiers principaux

Fichier Rôle
etc/users.propertiesComptes et rôles
etc/org.ops4j.pax.web.cfgPorts HTTP et HTTPS
etc/org.apache.karaf.shell.cfgConsole SSH
etc/org.apache.karaf.management.cfgJMX
etc/org.ops4j.pax.logging.cfgJournaux
etc/org.ops4j.pax.url.mvn.cfgDépôts Maven utilisés pour installer des features supplémentaires
etc/keystores/Keystores de démonstration
bin/setsecenvMots de passe des keystores et identifiants par défaut
version.txtVersions du runtime et de ses composants

Journaux

Le journal est data/log/karaf.log. Dans la console :

log:tail
log:display | grep ERROR
log:set DEBUG org.talend

Licences

Talaxie Runtime est publié sous licence Apache 2.0.

Compiler depuis les sources

Le build demande le JDK 21 et Maven 3.9.

git clone https://github.com/Talaxie/talaxie-rt.git
cd talaxie-rt
mvn -s build/settings.xml -P '!examples' clean install
Livrable Fichier
Archivestalaxie-runtime/target/talaxie-runtime-<version>.zip, .tar.gz
Image de conteneurtalaxie-runtime-docker/target/jib-image.tar

Options utiles

Compiler sans l'image de conteneur :

mvn -s build/settings.xml -P '!examples' \
    -pl '!talaxie-runtime-docker' clean install

Reconstruire seulement la distribution :

mvn -s build/settings.xml -P '!examples' \
    -pl talaxie-runtime verify

Dépannage

IllegalAccessError … module java.xml does not export …

Une bibliothèque embarquée dans le job utilise un package interne du JDK.

Address already in use

Un autre runtime utilise le port 8040 ou 8101.

Chemin trop long à la décompression sous Windows

Décompressez dans un dossier court.

Un bundle ne démarre pas

Affichez la cause avec bundle:diag.

Le job ignore ses paramètres de contexte

Le PID de la configuration doit être exactement le nom du job.

Non inclus

Ces modules Talend n'existaient que dans les produits commerciaux :

Job Server Talend Data Mapper Service Registry Provisioning Autorisation XACML XKMS Transport JMS entreprise Consommation de données