Boîte à outils

Docker Compose — NetBox 4.6.9

Le modèle directement importable dans un service Docker Compose Coolify pour NetBox 4.6.9.

Publication
septembre 2026
Langue
FR
Thématiques
Données pour le développement, Technologies pour le développement

Résumé

Cette ressource met en place NetBox web, worker RQ, PostgreSQL et deux services Valkey séparés pour tâches et cache. Profil retenu : netbox docker 5.0.2 avec configuration minimale gérée. Elle accompagne le guide complet de déploiement.

Architecture

Netbox web, worker rq, postgresql et deux services valkey séparés pour tâches et cache. Le domaine public est attribué au service d’entrée ; les autres composants communiquent sur le réseau interne.

Prérequis

Un serveur compatible avec les besoins de la solution, Docker géré par Coolify, un domaine pointé vers le serveur, un espace de stockage persistant et un accès administrateur à la plateforme. La mémoire, le processeur et le disque doivent être dimensionnés selon les utilisateurs, les données et les tâches de fond. NetBox est une source de vérité pour les réseaux et les infrastructures, pas un outil de découverte automatique.

Variables, secrets et volumes

Les variables décrivent les domaines et le comportement de l’application. Les secrets sont générés une fois et partagés avec les services qui utilisent la même identité. L’état durable comprend PostgreSQL, médias, rapports et scripts ; Valkey des tâches est durable tandis que le cache reste remplaçable.

Installation et validation

Créer un service Docker Compose, importer le fichier, attribuer le domaine, compléter les paramètres puis lancer le déploiement. Attendre les initialisations et exercer le parcours suivant : installation fraîche, initialisation native, accès web, administration, travail du worker, persistance et redéploiement.

Sauvegarde, restauration et mise à jour

Restaurer postgresql et les fichiers d’extension avant de remettre le worker en service. Avant une mise à jour, produire un point de reprise, tester la nouvelle version dans un environnement isolé et rejouer le parcours d’acceptation.

Lecture du fichier

Le bloc services décrit les conteneurs et leurs responsabilités. Les ancres réutilisent les variables communes sans dupliquer leur définition. Les volumes nommés identifient les états qui survivent aux redéploiements. Les contrôles de santé et les conditions de dépendance organisent le passage de la base vers l’initialisation, puis vers le service courant. Sites, équipements, baies, câbles, préfixes, adresses et machines virtuelles y sont modélisés avec leurs relations.

Avant toute adaptation, repérer le service exposé, le propriétaire des migrations, les travailleurs, les magasins d’état et les fichiers gérés. Modifier ensuite une responsabilité à la fois et conserver un parcours de validation reproductible. La valeur apparaît lorsque l’équipe définit qui maintient chaque donnée et utilise l’API ou les scripts pour confronter l’intention décrite à la réalité opérationnelle.

Exploitation

Après installation, suivre le domaine public, les certificats, la santé des services, l’espace disque, les files et la croissance des bases. Les comptes administrateurs nominatifs remplacent les accès partagés. Les changements de configuration sont relus, datés et accompagnés d’un contrôle fonctionnel. Le profil combine NetBox, un worker RQ, PostgreSQL et deux Valkey.

Adapter sans casser le contrat

Une nouvelle version peut modifier les images, variables, migrations ou chemins persistants. Comparer la composition avec la documentation de la version ciblée, mettre à jour dans un environnement isolé et vérifier les fonctions réellement utilisées. Le modèle reste un point de départ opérationnel, pas un substitut à l’administration du service. Le premier Valkey porte les tâches et conserve un état durable authentifié ; le second sert de cache reconstructible.

Contrôles avant partage

Vérifier que le fichier ne contient aucun mot de passe ni domaine privé, que les images sont versionnées, que tous les volumes utiles sont nommés et que le service public possède un contrôle de santé. Relire ensuite les instructions d’installation avec une personne qui n’a pas participé à la conception. Les fusionner parce qu’ils utilisent le même moteur supprimerait une distinction de sécurité et de reprise.

Points de contrôle du modèle

Relire les deux URL Valkey, leurs mots de passe et leurs politiques de persistance avant déploiement. Les volumes couvrent PostgreSQL, médias, rapports, scripts et la file de tâches ; le cache peut être reconstruit. La création du premier administrateur et les migrations restent confiées au cycle natif NetBox, sans sidecar qui dupliquerait ces responsabilités.