APEX #6 — Open Apexpress : toute la série en quelques clics

Série ECLYPSE APEX — épisode 6/6 · Précédent : #5 ChirpStack

Faisons le bilan de la série. On a appris à parler à l’OPA, à traquer les images ARM64, à écrire des configs avec des sh -c à rallonge, à lire des logs sans SSH, et à démarrer six conteneurs dans le bon ordre pour faire tourner ChirpStack. C’était instructif. C’était aussi, avouons-le, un peu long.

Et à la fin de l’épisode 5, je vous ai fait une promesse : quand c’est toujours pareil, on automatise.

Voici donc Open Apexpress : vos conteneurs sur ECLYPSE APEX, en express. Un seul fichier à lancer, vous cochez les services, il installe tout sur l’automate.

Le principe

Open Apexpress est un petit exécutable Windows, sans installation, à passer à un collègue sur une clé USB. Vous double-cliquez, une console s’ouvre (laissez-la ouverte), et l’interface apparaît dans votre navigateur.

Et surtout, il ne passe que par l’API REST v2 officielle de l’APEX. Pas de porte dérobée, pas de SSH, rien que ce que Distech prévoit. Il fait exactement ce qu’on a fait à la main pendant cinq épisodes, sans les fautes de frappe.

Catalogue Open Apexpress : packs prêts à l’emploi et services à cocher, avec leur statut et leur port — Le choix des services, ici le pack Zigbee + Grafana (mode démo).

Quatre écrans, et c’est installé

Connexion : IP de l’APEX, identifiant, mot de passe.
Services : vous cochez ce que vous voulez, ou vous prenez un pack.
Réglages : les valeurs par défaut sont bonnes, les mots de passe sont générés, et chaque conteneur est vérifié contre les règles de l’OPA avant envoi.
Installation : téléchargement des images, création et démarrage dans le bon ordre, suivi en direct. À la fin : les liens, les identifiants, et un rapport complet en Markdown.

Les packs reprennent tout simplement la série :

Pack	Contenu	Épisodes
Zigbee	Mosquitto, Zigbee2MQTT, Node-RED	#3 et #4
LoRaWAN	Mosquitto, ChirpStack (toute la troupe), Node-RED	#5
Courbes	Mosquitto, Telegraf, InfluxDB, Grafana	le bonus que vous n’avez pas eu
Maintenance	Cloudflare Tunnel, Uptime Kuma, ntfy	accès distant et alertes

Pas d’APEX sous la main ? Il y a un bouton « Essayer sans APEX (mode démo) » : un APEX simulé est intégré, vous pouvez tout essayer depuis votre bureau.

Fin d’installation : chaque service vérifié, puis les liens et les consignes de chaque service — Fin d’installation : liens, identifiants et consignes pour chaque service.

Tout ce que la série vous a appris, en dur dans l’outil

Chaque leçon de la série est devenue une règle d’Open Apexpress :

L’OPA (épisode 2) : ports en 50000-50500 et présents dans ExposedPorts, volumes en Mounts et jamais en Binds, "CpusetCpus": "0", noms en minuscules, pas de conteneur privilégié. Tout est vérifié avant d’envoyer quoi que ce soit.
L’ARM64 et les tags fixes : toutes les images du catalogue sont vérifiées en ARM64, avec une version fixée, modifiable dans les options avancées.
La config écrite une seule fois (épisode 3) : la clé réseau Zigbee n’est jamais écrasée au redémarrage.
ChirpStack sans image custom (épisode 5) : le conteneur d’initialisation, les lignes vides des TOML, le préfixe de région, pg_trgm et l’ordre de démarrage. Tout ce qui m’a coûté des soirées tient maintenant dans une case à cocher.
Les mots de passe : générés, et propagés partout où il faut. Activez l’authentification sur Mosquitto, Zigbee2MQTT, ChirpStack et Telegraf la récupèrent tout seuls.

Le bonus courbes, pour de vrai

Vous vous souvenez de l’épisode 1, qui promettait Telegraf, InfluxDB et Grafana ? Il n’a jamais eu son épisode, et c’est voulu : à la main, c’est un bon gros JSON pour Telegraf, un token à recopier à trois endroits et une source de données à créer dans Grafana. Avec le pack Courbes, Telegraf écoute les topics Zigbee et LoRaWAN, InfluxDB stocke avec une rétention réglable, et Grafana démarre avec sa source InfluxDB déjà créée.

Un mot quand même sur la RAM, puisque c’est le pack le plus gourmand. Open Apexpress affiche une estimation pendant que vous cochez : comptez environ 500 Mo pour le pack Courbes, sur les 1,8 Go que l’APEX partage avec sa régulation. Gardez une rétention courte et ne collectez que ce qui sert. Et si ça devient juste, ce trio est le premier candidat à partir sur un serveur à côté.

Ce qui est au catalogue

Dix-sept services, tous en images ARM64 vérifiées avec une version fixée. Ceux marqués à tester ont une image vérifiée, mais n’ont pas encore été validés sur un APEX réel avec Open Apexpress. Les autres l’ont été.

Famille	Services
🔌 Bus de messages	Mosquitto, MQTT Web (à tester)
📡 Capteurs sans fil	Zigbee2MQTT, ChirpStack
🧠 Lien avec la GTB	Node-RED, MCP ECLYPSE (à tester)
📈 Historique et courbes	InfluxDB, Telegraf, Grafana
🔐 Accès distant	Cloudflare Tunnel, Tailscale, Nginx Proxy Manager (à tester)
🚨 Supervision et alertes	Uptime Kuma (à tester), Netdata (à tester), ntfy (à tester)
🛠️ Dépannage et confort	FileBrowser, Portail APEX

Les outils de terrain

Installer, c’est bien. Vivre avec, c’est mieux. Open Apexpress sait aussi :

gérer les conteneurs et les volumes : démarrer, arrêter, supprimer. Pour supprimer un volume, il faut retaper son nom : on a assez parlé de z2m-data ;
sauvegarder et restaurer un volume, sans SSH : un conteneur éphémère l’archive en .tar.gz, téléchargé sur le PC. Ça sert aussi à copier une config d’un APEX à un autre ;
mettre à jour : il compare chaque image avec Docker Hub, télécharge la nouvelle avant de toucher au service, puis recrée le conteneur avec la même config et les mêmes volumes. Une nouvelle version majeure est seulement signalée ;
tester une image ARM64 avant de vous lancer ;
déployer un conteneur personnalisé : vous collez votre JSON, il est vérifié en direct contre les règles de l’OPA ;
tout journaliser : chaque requête envoyée à l’APEX, mots de passe masqués, à copier pour un diagnostic.

Côté accès distant, Cloudflare Tunnel et Tailscale sont au catalogue : votre Grafana depuis le bureau, sans ouvrir de port sur le routeur du site, même derrière un modem 4G.

Sécurité : l’outil parle à votre automate, autant faire attention

L’interface n’écoute que sur votre PC (127.0.0.1) et exige un jeton généré à chaque lancement : aucun autre poste, aucun site web ne peut piloter l’APEX à travers l’outil.
Les identifiants de l’APEX restent en mémoire, ne sont jamais écrits sur disque et ne sont envoyés qu’à l’APEX.
Les mots de passe générés n’apparaissent que sur l’écran final et dans le rapport. Rangez ce rapport en lieu sûr.

Et pour la suite : Claude dans l’automate

Dans le catalogue, il y a une ligne un peu à part : MCP ECLYPSE. C’est un serveur MCP qui donne à Claude un accès encadré à l’API REST de l’APEX : lire les points BACnet, les trend logs, les programmes horaires et les alarmes, découvrir les équipements du réseau, comparer une loi d’eau à la mesure… En lecture seule par défaut. L’écriture s’active en option, avec simulation, confirmation, priorité BACnet dédiée et journal.

C’est un vaste sujet, il mérite son propre article. Disons que c’est le teaser de la saison 2.

Le mot de la fin

Six épisodes plus tard, notre automate fait tourner un broker MQTT, du Zigbee, du LoRaWAN, un Node-RED qui fabrique des points BACnet, des courbes, et tout ça s’installe maintenant en quelques clics. Tout est possible avec l’APEX, à condition de respecter ses limites. Open Apexpress les respecte pour vous.

L’outil est libre (licence MIT) et vous le trouverez sur GitHub.

Démarrage en une minute

Téléchargez OpenApexpress-x.y.z-windows-x64.exe dans l’onglet Releases.
Lancez-le : une console s’ouvre (laissez-la ouverte) et l’interface apparaît dans votre navigateur.
Entrez l’IP de l’APEX, son identifiant et son mot de passe, ou cliquez sur « Essayer sans APEX (mode démo) ».

Le fichier n’est pas signé : au premier lancement, SmartScreen râle. Informations complémentaires → Exécuter quand même. Prévoyez aussi un accès Internet côté APEX pour télécharger les images.

À savoir. Distech ne documente pas les réponses de l’API de conteneurisation. Pour la toute première utilisation sur un APEX réel, gardez un œil sur l’onglet Journal, et essayez les services « à tester » sur site avant de compter dessus.

Si vous l’essayez sur site, vos retours m’intéressent énormément : en commentaire ici, ou dans les issues du dépôt.

Merci de m’avoir suivi dans cette petite aventure !

Open Apexpress est un projet indépendant, non affilié à Distech Controls. ECLYPSE est une marque de Distech Controls.