Aller au contenu
yutho

Étude de cas / Plateforme de déploiement

En développement · code privé

Docklane

On pousse son code, Docklane s’occupe des serveurs.

Rôle
Conception, architecture et code, de bout en bout
Année
2026
Statut
En développement · code privé

Couches touchées : Interface, API et logique, Données, Infrastructure, Réseau.

Code propriétaire : l’interface ci-contre est reconstituée avec des données d’exemple.

Contexte

Mettre une application en ligne demande encore de louer un serveur, d’y installer Docker, un reverse proxy et des certificats, puis de tout surveiller. Docklane veut rendre ce travail invisible : le client pousse son code, la plateforme fournit et administre les serveurs Linux qui l’exécutent.

Le dépôt contient tout le service : le control plane et l’agent en Go, le dashboard client et la console d’administration en Next.js, PostgreSQL. Il démarre en local d’une seule commande, serveur Debian simulé compris, pour développer sans louer de machine.

Ce que j’ai construit

  1. Entrer sans mot de passe

    On entre par GitHub, GitLab ou un lien magique : s’inscrire et se connecter sont le même geste. Sessions opaques stockées hachées, cookie HttpOnly, jeton CSRF sur toute mutation, codes de récupération à usage unique.

  2. Installer un serveur depuis la console

    Le provisioner se connecte par clé SSH à un hôte dont l’empreinte est vérifiée, installe Docker et l’agent signé, puis l’enrôle. L’agent parle ensuite au control plane en mTLS, avec rotation et révocation de ses certificats.

  3. Du push à la production

    Webhook GitHub ou GitLab, build avec ou sans Dockerfile (Railpack, Nixpacks, Buildpacks), file de travaux durable, puis bascule bleu/vert. Chaque déploiement se suit en étapes : source, build, prédéploiement, démarrage, bascule.

  4. Observer et réagir

    Métriques serveur sur 24 h (processeur, mémoire, disque, réseau), logs d’exécution avec recherche, trafic HTTP agrégé par minute, et huit règles d’incident qui alertent par e-mail ou webhook.

  5. Le stockage de l’équipe

    Buckets S3, bases PostgreSQL, MySQL et Redis gérées, sauvegardes chiffrées côté client, et des restaurations vérifiées dans une copie temporaire avant de remplacer la base.

Architecture

  1. Navigateur

    • Dashboard client

      Next.js

    • Console d’administration

      Next.js, port distinct

  2. /api/v1 + SSE
  3. Plateforme

    • Control plane

      Go · sessions, rôles, commandes, audit

    • PostgreSQL

      États, file de travaux, télémétrie

    • Provisioner

      Go · installation par SSH

  4. mTLS sortant · SSH par clé
  5. Serveur Linux géré

    • Agent

      Go, signé · heartbeat, métriques, build

    • Docker + BuildKit

      Images et conteneurs

    • Caddy

      Edge :80/:443, certificats ACME

Le control plane ne lance jamais de build ni de shell : il écrit des commandes. Le provisioner installe, l’agent exécute.

Choix techniques

  • Un monolithe modulaire, pas des microservices

    Un processus, des modules (identité, équipes, déploiements, monitoring) et du SQL explicite. Les transactions PostgreSQL lient l’intention, la commande et l’événement : rien ne se perd entre deux services.

  • L’agent appelle, le control plane ne se connecte pas

    L’agent ouvre lui-même une connexion HTTPS sortante en mTLS et reçoit des commandes typées (build, démarrage, bascule). Il ne choisit ni son équipe ni ses droits.

  • L’exécution distante dans un processus à part

    L’installation par SSH vit dans le provisioner, hors du serveur HTTP. Il refuse les mots de passe SSH, les commandes arbitraires et les hôtes à l’empreinte non vérifiée.

  • Un contrat OpenAPI comme référence

    Les types TypeScript du dashboard sont générés depuis le contrat : le front et l’API Go ne peuvent pas diverger en silence.

La pile

InterfaceCe qu’on voit et ce qu’on touche
Next.jsDesign system partagéMises à jour SSE
API et logiqueLes règles, les droits, les échanges
GoContrat OpenAPIRôles et audit
DonnéesCe qui est stocké, et comment
PostgreSQLpgxFile de travaux
InfrastructureBuild, déploiement, serveurs
Agent Go signéDocker · BuildKitCaddy · ACME
RéseauCe qui circule entre les machines
mTLSSSH par cléReverse proxy TLS

Qualité

  • Tests Go contre une vraie base PostgreSQL : transitions, concurrence, rejeu, isolation des équipes, reconnexion SSE.
  • Documentation d’architecture, d’exploitation et feuille de route tenues à jour avec le code.

Et ensuite

  • Stabilisation de la V1 : charge, sécurité, rétention, sauvegardes du control plane, accessibilité.
  • Valider sur de vraies machines ce que le code couvre déjà : enrôlement, build Docker réel, coupure réseau, disque plein.