Le diagramme de conteneurs C4

Un diagramme de conteneurs prend la boîte unique du diagramme de contexte système et l'ouvre. Tout ce qui est dedans est quelque chose qui doit tourner ; tout ce qui est dehors reste du contexte.

Lisez-le comme une suite de phrases : le client parcourt l'application monopage ; l'application appelle la Storefront API en HTTPS ; l'API écrit les commandes dans PostgreSQL et publie vers RabbitMQ ; le worker consomme depuis RabbitMQ et écrit dans la même base. C'est cette dernière phrase que le diagramme de conteneurs existe pour rendre visible : deux conteneurs qui écrivent dans une même base sont un couplage qu'aucun catalogue de services ne montre.

Ce sont ces deux étiquettes qui séparent un diagramme de conteneurs d'un croquis. Sans la technologie, une boîte nommée "Storefront API" pourrait être une Lambda, un monolithe Rails ou une procédure stockée. Sans le protocole, un trait entre deux boîtes pourrait être un appel synchrone dans le chemin de la requête ou un traitement par lots nocturne : deux faits opposés pour qui raisonne sur les pannes.

Tracez la flèche dans le sens de l'appel, pas dans celui des données. Une lecture reste un appel du lecteur vers le magasin, et dessiner la réponse comme une deuxième flèche double le nombre de traits sans rien apporter : la réponse est impliquée par la requête.

Omettre les magasins de données. Un diagramme de services sans bases de données cache exactement le couplage qui provoque les incidents. Si deux conteneurs écrivent dans la même table, cela doit figurer sur l'image.

Mélanger les niveaux. Un diagramme de conteneurs dont un conteneur est ouvert sur ses classes internes, ce sont deux diagrammes mal superposés. Ouvrez-le plutôt sur un diagramme de composants, où le public attend cette profondeur.

Dessiner l'infrastructure. Répartiteurs de charge, sidecars et noeuds Kubernetes ont leur place sur un diagramme de déploiement. Un diagramme de conteneurs parle de ce qu'est le logiciel, pas d'où il tourne.

Faire disparaître discrètement les systèmes externes. Le prestataire de paiement n'est pas le vôtre et ne peut pas être omis pour autant : c'est de là que viennent votre latence et la moitié de vos modes de défaillance. Gardez-le, marquez-le externe, et arrêtez-vous là.