Index du journalDockup / note de terrain
Note / self-host-it-tools

Comment auto-héberger IT Tools en 2026 : TLS, déploiements stateless et mises à jour

Guide pratique pour auto-héberger IT Tools avec Docker : ports, données persistantes, TLS, sécurité, sauvegardes et problèmes qui empêchent une utilisation en production. Avec contrôles.

L’auto-hébergement d’IT Tools devient intéressant dès le premier redéploiement, et non au premier docker run. Si le proxy cible le mauvais port du conteneur ou met en cache un ancien application shell, Docker peut tout de même signaler un processus parfaitement sain. Le déploiement ci-dessous s’articule autour de comportements observables : charger l’interface, générer un hash, décoder un JWT et utiliser un convertisseur avec le réseau du navigateur déconnecté une fois les assets mis en cache.

Le rôle d’IT Tools est clairement défini : proposer une collection de hash, de convertisseurs, de générateurs et d’utilitaires pour développeurs. Cette description nous indique ce qui doit rester public, ce qui doit rester privé et ce qu’une sauvegarde doit pouvoir reconstruire.

Séparer IT Tools de ses dépendances

Commencez par l’espace de noms réseau d’IT Tools : son listener web est le port 80, et non un port hôte copié depuis un tutoriel pour ordinateur portable. Le build standard d’IT Tools n’a besoin ni de base de données ni de service d’exécution persistant distinct. Gardez le conteneur web remplaçable et placez toute future brique d’authentification, de collaboration ou de stockage derrière une boundary documentée séparément.

Une fois le besoin satisfait, exécutez le scénario complet — charger l’interface, générer un hash, décoder un JWT et utiliser un convertisseur avec le réseau du navigateur déconnecté une fois les assets mis en cache. Relevez les logs et les mesures concernant la mémoire du navigateur client, la distribution des assets statiques et l’absence de traitement côté serveur lié à une base de données ou à une file d’attente. Ces éléments constituent la première architecture connue comme fonctionnelle et rendent les futurs déplacements entre le compute Dockup et un serveur rattaché testables.

Construire un conteneur IT Tools remplaçable

Une commande minimale est utile lorsqu’elle permet de comprendre ce que la plateforme gérera ensuite.

docker run -d \
  --name it-tools \
  --restart unless-stopped \
  -p 127.0.0.1:80:80 \
  corentinth/it-tools:latest

Ici, le port 80 reste privé sur l’hôte et chaque chemin requis est explicite. Vérifiez le besoin local avant toute exposition : aucune base de données, uniquement un petit conteneur web. Vérifiez le démarrage à l’aide des logs et de la preuve propre à l’application : charger l’interface, générer un hash, décoder un JWT et utiliser un convertisseur avec le réseau du navigateur déconnecté une fois les assets mis en cache. Une fois le fonctionnement vérifié, verrouillez la version de l’image afin qu’un remplacement courant ne modifie pas silencieusement le comportement.

Le TLS est simple ; les URL générées ne le sont pas

La boundary publique d’IT Tools doit reposer sur un hostname canonique, un TLS automatique et une seule cible interne sur le port 80. Faites transiter l’application web statique via HTTPS afin que les clients reviennent à une adresse reconnue par le service.

Si la transaction d’acceptation échoue, catégorisez la première erreur. Les problèmes de DNS, de certificat et de 502 relèvent de la checklist de validation TLS. La condition « le proxy cible le mauvais port du conteneur ou met en cache un ancien application shell » relève de la partie applicative, une fois qu’une requête a bien atteint IT Tools.

Les volumes ne constituent que la première couche de reprise

La reprise d’IT Tools stateless est un exercice de reproductibilité. Ne conservez aucune donnée côté serveur ; gardez la configuration de déploiement ; la couche inscriptible du conteneur ne doit rien contenir de nécessaire après son remplacement.

Utilisez l’image pin et la configuration revue pour reconstruire IT Tools sur un compute vierge. L’exercice est réussi lorsqu’un conteneur neuf reproduit le même ensemble d’outils, puisqu’il n’existe aucun état utilisateur côté serveur à restaurer. Suivez le workflow de déploiement de Git vers la production pour l’artifact remplaçable, tandis que tout service externe optionnel conserve sa propre procédure de sauvegarde.

Documentez le digest exact et l’input d’acceptation. L’opérateur peut ainsi distinguer une régression applicative d’un état manquant et éviter d’attacher un volume de façade qu’IT Tools ne lit jamais.

Fermer les accès temporaires de configuration

La sécurité d’IT Tools stateless commence par les contrôles de supply chain et d’ingress, et non par un paramètre de compte fictif. Ne partez pas du principe que les outils côté navigateur rendent sûrs des secrets collés sur un hôte non fiable. La boundary prévue consiste à servir une image upstream de confiance et à rappeler aux utilisateurs que l’auto-hébergement ne rend pas fiable un navigateur compromis.

Servez IT Tools depuis une image pin de confiance, ajoutez l’authentification de la plateforme si l’audience est privée et n’exposez que le port 80 via HTTPS. Définissez des limites de ressources et de requêtes autour de la mémoire du navigateur client, de la distribution des assets statiques et de l’absence de traitement côté serveur lié à une base de données ou à une file d’attente. Comme cette base ne contient aucun secret intégré, conservez la politique d’accès dans la configuration de la route et testez-la depuis un client non autorisé.

Répéter la modification IT Tools à risque

Surveillez le comportement, et pas uniquement le processus : charger l’interface, générer un hash, décoder un JWT et utiliser un convertisseur avec le réseau du navigateur déconnecté une fois les assets mis en cache. Les signaux de pression à surveiller sont la mémoire du navigateur client, la distribution des assets statiques et l’absence de traitement côté serveur lié à une base de données ou à une file d’attente. Exécutez ce contrôle après le démarrage et selon une fréquence qui ne risque pas de surcharger le service.

Une mise à jour ne peut être promue qu’après avoir vérifié qu’une mise à jour de l’image peut modifier les algorithmes ou les dépendances côté client ; pinnez donc et vérifiez le build qui traite les données sensibles. Utilisez un candidat parallèle, des digests pinnés et des inputs connus ; cette image de base ne comporte aucune migration de schéma à répéter. Si le proxy cible le mauvais port du conteneur ou met en cache un ancien application shell, comparez les deux versions avant de modifier l’ingress ou d’ajouter du stockage.

Consigner un déploiement IT Tools connu comme fonctionnel

Ne faites pas du trafic du premier utilisateur le test d’acceptation d’IT Tools. Préparez un état d’exemple inoffensif et exécutez l’action complète « charger l’interface, générer un hash, décoder un JWT et utiliser un convertisseur avec le réseau du navigateur déconnecté une fois les assets mis en cache ». Notez l’URL publique exacte, le résultat, la référence de l’image et l’intervalle de logs associés à l’exécution.

Remplacez le conteneur et répétez l’opération sans reconstruire les données. Ensuite, effectuez une reprise sur un hôte vide ; la condition de reprise est qu’un conteneur neuf reproduise le même ensemble d’outils, puisqu’il n’existe aucun état utilisateur côté serveur à restaurer. Observez la mémoire du navigateur client, la distribution des assets statiques et l’absence de traitement côté serveur lié à une base de données ou à une file d’attente à chaque exécution, puis définissez une alerte autour de la dégradation de la transaction plutôt qu’autour des métriques d’inactivité du conteneur.

Un dernier contrôle doit échouer volontairement : envoyez un input inoffensif proche de la limite de ressources ou de format associée à cette boundary : le proxy cible le mauvais port du conteneur ou met en cache un ancien application shell. Vérifiez que le message résultant d’IT Tools identifie la boundary concernée au lieu de déclencher une suppression de données ou un redémarrage sans fin. Rétablissez la condition valide et confirmez que la même transaction d’exemple réussit. Gardez cet exercice court dans la checklist de release.

Un déploiement Dockup nécessite toujours un test d’acceptation IT Tools

Dockup peut déployer l’image IT Tools pinnée sur le compute Dockup ou sur un serveur rattaché par le client, router le hostname public vers le port 80 et émettre automatiquement le TLS. Le conteneur standard ne possède pas de base de données applicative ; Dockup ne doit donc pas attacher un volume de données dépourvu de sens uniquement pour imiter un template stateful.

Après le déploiement, faites transiter l’application web statique via HTTPS. Dockup doit conserver les paramètres runtime d’IT Tools tandis que l’opérateur confirme le besoin local suivant : aucune base de données, uniquement un petit conteneur web. Exécutez le contrôle de sortie connue : charger l’interface, générer un hash, décoder un JWT et utiliser un convertisseur avec le réseau du navigateur déconnecté une fois les assets mis en cache. Si des polices personnalisées, une authentification, de la collaboration ou de la configuration sont ajoutées ultérieurement, déclarez explicitement ces composants et leur état au lieu de les intégrer à l’image web stateless. Le déploiement en un clic reste ainsi transparent sur ce que Dockup gère et sur ce qu’IT Tools stocke réellement.

Foire aux questions

De quoi IT Tools a-t-il besoin pour un déploiement en production ?

Routez le conteneur IT Tools sur le port 80 via une origine HTTPS unique. Le build standard d’IT Tools n’a besoin ni de base de données ni de service d’exécution persistant distinct. Ne considérez pas IT Tools comme prêt tant que vous ne pouvez pas charger l’interface, générer un hash, décoder un JWT et utiliser un convertisseur avec le réseau du navigateur déconnecté une fois les assets mis en cache.

Quelles données IT Tools doivent figurer dans une sauvegarde ?

L’image IT Tools standard ne possède aucun mount obligatoire pour les données applicatives. Conservez sa configuration de déploiement et sauvegardez séparément tout état connecté ; la reprise est réussie lorsqu’un conteneur neuf reproduit le même ensemble d’outils, puisqu’il n’existe aucun état utilisateur côté serveur à restaurer.

IT Tools a-t-il besoin de HTTPS derrière un reverse proxy ?

Utilisez HTTPS pour l’origine publique d’IT Tools et conservez le port 80 sur la route interne. Appliquez correctement le paramètre IT Tools : faites transiter l’application web statique via HTTPS. Pour IT Tools, HTTPS protège les identifiants ou le contenu utilisateur pendant leur transit et garantit la cohérence des comportements client sensibles à l’origine.

Comment tester une mise à niveau d’IT Tools ?

Déployez l’image IT Tools candidate à côté de la version actuelle et répétez la transaction d’acceptation avec un input connu. Soyez particulièrement attentif, car une mise à jour de l’image peut modifier les algorithmes ou les dépendances côté client ; pinnez donc et vérifiez le build qui traite les données sensibles. Le conteneur standard ne comporte aucune migration de données : conservez le digest précédent jusqu’à la réussite des contrôles de sortie et de compatibilité.