<?xml version="1.0" encoding="utf-8"?><?xml-stylesheet type="text/xsl" href="rss.xsl"?>
<rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/">
    <channel>
        <title>Joël Vappiani Blog</title>
        <link>https://blog.djovap.com/fr/</link>
        <description>Joël Vappiani Blog</description>
        <lastBuildDate>Mon, 02 Nov 2026 00:00:00 GMT</lastBuildDate>
        <docs>https://validator.w3.org/feed/docs/rss2.html</docs>
        <generator>https://github.com/jpmonette/feed</generator>
        <language>fr</language>
        <item>
            <title><![CDATA[Workspaces Kubernetes multi-tenant : isolation, self-heal et une seule config]]></title>
            <link>https://blog.djovap.com/fr/multi-tenant-workspace-operator</link>
            <guid>https://blog.djovap.com/fr/multi-tenant-workspace-operator</guid>
            <pubDate>Mon, 02 Nov 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Comment nous avons construit un opérateur Workspace qui isole chaque étudiant dans son propre namespace, empêche les ressources de la plateforme de dériver, et propage un seul template géré dans Git à tous les tenants — sans exiger ArgoCD dans le cluster.]]></description>
            <content:encoded><![CDATA[<p>Kappsul a commencé comme un service proposé à l'Université de Lorraine : les étudiants
qui avaient besoin d'un environnement isolé pour déployer une application pouvaient en
obtenir un depuis un cluster Kubernetes partagé, via une interface web. La plateforme
devait transformer un clic en un namespace avec un quota, des règles d'accès, une
frontière réseau et un endroit où faire tourner l'application de l'étudiant. C'est un
problème de multi-tenancy avant d'être un problème Kubernetes : chaque étudiant a besoin
d'assez de liberté pour être utile, et d'une frontière assez dure pour ne pas impacter les
autres.</p>
<!-- -->
<p>La première implémentation utilisait ArgoCD. Chaque workspace était une Application
ArgoCD, toutes pointant vers le même dépôt Git, et ArgoCD faisait la reconciliation.
C'était déclaratif, auditable, et ça fonctionnait. Mais cela faisait dépendre une feature
centrale de notre produit d'ArgoCD : créer un workspace exigeait une installation ArgoCD
et une source Git, et la plateforme ne pouvait pas tourner sur un cluster qui n'en avait
pas. Nous voulions que le service soit portable sur n'importe quel cluster Kubernetes, et
nous ne voulions pas qu'une de ses fonctionnalités cœur soit déléguée à un outil externe.</p>
<p>Nous avons aussi réalisé que nous n'avions pas besoin de tout ArgoCD. Nous avions besoin de
deux comportements :</p>
<ul>
<li class=""><strong>self-heal</strong> : un étudiant ne doit pas pouvoir modifier les parties de son workspace qui
appartiennent à la plateforme ;</li>
<li class=""><strong>propagation</strong> : un changement de la configuration centrale doit mettre à jour tous les
workspaces et leurs ressources.</li>
</ul>
<p>Nous avons donc gardé GitOps pour ce qu'il fait bien — changer la configuration centrale
dans Git — et écrit un petit opérateur qui appartient à l'application. L'opérateur crée
l'enveloppe du workspace, l'empêche de dériver, et propage le template partagé à tous les
tenants. Il n'utilise que l'API Kubernetes et un CRD, donc il tourne sur n'importe quel
cluster.</p>
<p>Cet article parle de cet opérateur : le modèle d'isolation, les deux comportements GitOps,
et les compromis.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="le-multi-tenant-est-la-raison-dêtre-de-lopérateur">Le multi-tenant est la raison d'être de l'opérateur<a href="https://blog.djovap.com/fr/multi-tenant-workspace-operator#le-multi-tenant-est-la-raison-d%C3%AAtre-de-lop%C3%A9rateur" class="hash-link" aria-label="Lien direct vers Le multi-tenant est la raison d'être de l'opérateur" title="Lien direct vers Le multi-tenant est la raison d'être de l'opérateur" translate="no">​</a></h2>
<p>Un workspace n'est pas juste un namespace. C'est une enveloppe d'isolation :</p>
<table><thead><tr><th>Couche</th><th>Ce qu'elle donne à l'étudiant</th><th>Ce qu'elle protège la plateforme de</th></tr></thead><tbody><tr><td>Namespace</td><td>Un endroit privé pour déployer</td><td>Les collisions de noms et l'accès inter-tenant accidentel</td></tr><tr><td>ResourceQuota</td><td>Un budget CPU, mémoire, stockage et pods prévisible</td><td>Un workspace qui affame le cluster</td></tr><tr><td>LimitRange</td><td>Des requests et limits par défaut pour les conteneurs</td><td>Les pods sans limits qui passent au travers</td></tr><tr><td>RBAC</td><td><code>admin</code> dans leur namespace, pour le propriétaire et les invités</td><td>Les étudiants qui agissent hors de leur workspace</td></tr><tr><td>NetworkPolicy</td><td>Default-deny avec ingress et egress explicites</td><td>Le trafic inter-namespace et l'egress inattendu</td></tr><tr><td>Pod Security Admission</td><td><code>baseline</code> en enforcement, <code>restricted</code> en audit/warn</td><td>Les pods privilégiés ou dangereux</td></tr></tbody></table>
<p>Le premier travail de l'opérateur est de créer cette enveloppe pour chaque étudiant, avec
la même forme et les bonnes valeurs. L'étudiant obtient ensuite <code>admin</code> dans le namespace
pour pouvoir déployer et gérer ses applications. C'est le contrat multi-tenant : <strong>un
namespace privé avec une frontière dure, et assez de liberté à l'intérieur pour être
utile.</strong></p>
<p>La frontière est appliquée par les primitives Kubernetes, pas par l'opérateur. Le travail
de l'opérateur est de s'assurer que l'enveloppe existe et reste correcte. Cette distinction
compte pour la suite de l'article.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="portabilité--ne-pas-mettre-un-outil-externe-sur-le-chemin-critique">Portabilité : ne pas mettre un outil externe sur le chemin critique<a href="https://blog.djovap.com/fr/multi-tenant-workspace-operator#portabilit%C3%A9--ne-pas-mettre-un-outil-externe-sur-le-chemin-critique" class="hash-link" aria-label="Lien direct vers Portabilité : ne pas mettre un outil externe sur le chemin critique" title="Lien direct vers Portabilité : ne pas mettre un outil externe sur le chemin critique" translate="no">​</a></h2>
<p>Pour nous, la portabilité signifie une chose : l'opérateur ne doit avoir besoin de rien
d'autre que d'une API Kubernetes et du CRD. Pas d'ArgoCD, pas de serveur Git, pas d'accès
réseau à Git au runtime. C'est la conséquence directe de la première implémentation : une
Application ArgoCD par workspace, toutes pointant vers le même dépôt Git. Ça fonctionnait,
mais cela faisait dépendre la création d'un workspace d'une installation ArgoCD et de sa
source Git. Une opération produit centrale se trouvait derrière une dépendance qui n'avait
rien à voir avec le produit.</p>
<p>L'opérateur n'utilise donc que l'API Kubernetes et un CRD. GitOps reste la manière dont le
<strong>template</strong> arrive dans le cluster : le chart de la plateforme, y compris le template de
ressources du workspace, peut être déployé par ArgoCD, Flux, Helm ou <code>kubectl apply</code>.
L'opérateur s'en moque. C'est le runtime qui transforme ce template en namespaces de
tenants.</p>
<p>C'est l'argument de portabilité en une phrase : <strong>GitOps pour la livraison, un opérateur
pour le runtime.</strong></p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="les-deux-comportements-gitops-dont-nous-avions-réellement-besoin">Les deux comportements GitOps dont nous avions réellement besoin<a href="https://blog.djovap.com/fr/multi-tenant-workspace-operator#les-deux-comportements-gitops-dont-nous-avions-r%C3%A9ellement-besoin" class="hash-link" aria-label="Lien direct vers Les deux comportements GitOps dont nous avions réellement besoin" title="Lien direct vers Les deux comportements GitOps dont nous avions réellement besoin" translate="no">​</a></h2>
<p>Nous n'avions pas besoin de tout ArgoCD. Nous avions besoin du self-heal et de la
propagation, et de rien d'autre dans la boîte à outils GitOps.</p>
<ul>
<li class=""><strong>Self-heal.</strong> Si un étudiant modifie le quota, le limit range, le RBAC ou la network
policy, l'opérateur le remet en place.</li>
<li class=""><strong>Propagation.</strong> L'enveloppe du workspace est définie une fois. Changez cette unique
configuration, et tous les workspaces et leurs ressources sont mis à jour en conséquence.</li>
</ul>
<p>Nous n'avions pas besoin d'une Application par tenant, d'un dashboard de sync par
workspace, d'un app-of-apps ou d'une orchestration multi-cluster. Nous avions besoin d'un
controller qui possède l'enveloppe, détecte le drift et applique un template partagé.</p>
<p>L'opérateur gère aussi la création et la suppression, parce qu'un cycle de vie de tenant a
besoin des deux. Mais le self-heal et la propagation sont la raison de son existence.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="le-crd-est-lenregistrement-du-tenant">Le CRD est l'enregistrement du tenant<a href="https://blog.djovap.com/fr/multi-tenant-workspace-operator#le-crd-est-lenregistrement-du-tenant" class="hash-link" aria-label="Lien direct vers Le CRD est l'enregistrement du tenant" title="Lien direct vers Le CRD est l'enregistrement du tenant" translate="no">​</a></h2>
<p>Le CRD <code>Workspace</code> est volontairement petit. Le spec est l'entrée ; le status est la
mémoire durable de l'opérateur.</p>
<div class="language-go codeBlockContainer_j5cZ theme-code-block" style="--prism-color:#F8F8F2;--prism-background-color:#282A36"><div class="codeBlockContent_Nbbu"><pre tabindex="0" class="prism-code language-go codeBlock_BIxk thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_Esqw"><div class="token-line" style="color:#F8F8F2"><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">type</span><span class="token plain"> WorkspaceSpec </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">struct</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    UserID            </span><span class="token builtin" style="color:rgb(189, 147, 249)">string</span><span class="token plain">   </span><span class="token string" style="color:rgb(255, 121, 198)">`json:"userId"`</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    UserEmail         </span><span class="token builtin" style="color:rgb(189, 147, 249)">string</span><span class="token plain">   </span><span class="token string" style="color:rgb(255, 121, 198)">`json:"userEmail,omitempty"`</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    UserCheckSum      </span><span class="token builtin" style="color:rgb(189, 147, 249)">string</span><span class="token plain">   </span><span class="token string" style="color:rgb(255, 121, 198)">`json:"userCheckSum,omitempty"`</span><span class="token plain"> </span><span class="token comment" style="color:rgb(98, 114, 164)">// generated by the controller</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    Guests            </span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token builtin" style="color:rgb(189, 147, 249)">string</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">`json:"guests,omitempty"`</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    Namespace         </span><span class="token builtin" style="color:rgb(189, 147, 249)">string</span><span class="token plain">   </span><span class="token string" style="color:rgb(255, 121, 198)">`json:"namespace"`</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    TemplateConfigMap </span><span class="token builtin" style="color:rgb(189, 147, 249)">string</span><span class="token plain">   </span><span class="token string" style="color:rgb(255, 121, 198)">`json:"templateConfigMap,omitempty"`</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">type</span><span class="token plain"> WorkspaceStatus </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">struct</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    Phase               WorkspacePhase    </span><span class="token string" style="color:rgb(255, 121, 198)">`json:"phase"`</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    ObservedGeneration  </span><span class="token builtin" style="color:rgb(189, 147, 249)">int64</span><span class="token plain">             </span><span class="token string" style="color:rgb(255, 121, 198)">`json:"observedGeneration,omitempty"`</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    ManagedResources    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain">ManagedResource </span><span class="token string" style="color:rgb(255, 121, 198)">`json:"managedResources,omitempty"`</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    LastTemplateVersion </span><span class="token builtin" style="color:rgb(189, 147, 249)">string</span><span class="token plain">            </span><span class="token string" style="color:rgb(255, 121, 198)">`json:"lastTemplateVersion,omitempty"`</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    PendingDeletions    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain">PendingDeletion </span><span class="token string" style="color:rgb(255, 121, 198)">`json:"pendingDeletions,omitempty"`</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><br></div></code></pre></div></div>
<p><code>managedResources</code> est la liste des ressources créées par l'opérateur, indexées par groupe,
version, kind, namespace et nom. <code>lastTemplateVersion</code> est le <code>resourceVersion</code> du ConfigMap
qui a été appliqué. <code>pendingDeletions</code> est la file de retry pour les ressources retirées du
template mais pas encore supprimées.</p>
<p>Tout mettre dans le status est délibéré. L'opérateur ne garde aucun état durable propre ;
un redémarrage de pod ne perd rien. Le CRD est l'enregistrement du tenant, et le namespace
est la frontière d'isolation.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="la-boucle">La boucle<a href="https://blog.djovap.com/fr/multi-tenant-workspace-operator#la-boucle" class="hash-link" aria-label="Lien direct vers La boucle" title="Lien direct vers La boucle" translate="no">​</a></h2>
<p>Le controller est un design classique informer + workqueue, avec trois sources
d'événements :</p>
<ul>
<li class="">un <strong>informer Workspace</strong>, limité au namespace qui contient les CRs ;</li>
<li class="">un <strong>informer ConfigMap</strong>, limité au namespace qui contient les templates ;</li>
<li class="">un <strong>watcher de ressources dynamique</strong>, qui observe tout ce qui est étiqueté comme
appartenant au controller, dans tous les namespaces, pour détecter le drift.</li>
</ul>
<!-- -->
<p>La queue est rate-limitée deux fois : un backoff exponentiel en cas d'échec, de 5
millisecondes à 1000 secondes, et un token bucket à 50 éléments par seconde avec un burst
de 300. La partie exponentielle protège un workspace cassé du hot-looping. Le bucket
protège l'API server quand un événement partagé fan-out vers tout le monde.</p>
<p>L'optimisation la plus importante est celle qui ne fait rien. Si un workspace est <code>Active</code>,
que sa <code>generation</code> n'a pas changé, qu'il n'y a pas d'annotation de drift et que sa version
de template est à jour, le reconciler retourne sans un seul appel API. En régime stable,
ce chemin de skip supprime la grande majorité du travail de reconciliation.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="un-template-plusieurs-tenants">Un template, plusieurs tenants<a href="https://blog.djovap.com/fr/multi-tenant-workspace-operator#un-template-plusieurs-tenants" class="hash-link" aria-label="Lien direct vers Un template, plusieurs tenants" title="Lien direct vers Un template, plusieurs tenants" translate="no">​</a></h2>
<p>L'enveloppe du workspace est définie une fois, dans un ConfigMap. Ce ConfigMap fait partie
du chart de la plateforme, donc il est géré dans Git et livré par l'outil GitOps que le
cluster utilise.</p>
<p>Le template contient deux couches de templating. La couche externe est Helm, évaluée au
déploiement de la plateforme. La couche interne est un template Go, évalué par l'opérateur
pour chaque workspace. L'équipe plateforme contrôle la <strong>forme</strong> ; l'opérateur remplit les
<strong>valeurs</strong> depuis le CR.</p>
<div class="language-yaml codeBlockContainer_j5cZ theme-code-block" style="--prism-color:#F8F8F2;--prism-background-color:#282A36"><div class="codeBlockContent_Nbbu"><pre tabindex="0" class="prism-code language-yaml codeBlock_BIxk thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_Esqw"><div class="token-line" style="color:#F8F8F2"><span class="token comment" style="color:rgb(98, 114, 164)"># workspace-resource-template (rendered by Helm, then by the operator)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token key atrule">data</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token key atrule">namespace.yaml</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">|</span><span class="token scalar string" style="color:rgb(255, 121, 198)"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token scalar string" style="color:rgb(255, 121, 198)">    apiVersion: v1</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token scalar string" style="color:rgb(255, 121, 198)">    kind: Namespace</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token scalar string" style="color:rgb(255, 121, 198)">    metadata:</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token scalar string" style="color:rgb(255, 121, 198)">      name: {{ "{{" }} .Workspace.Namespace {{ "}}" }}</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token scalar string" style="color:rgb(255, 121, 198)">      labels:</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token scalar string" style="color:rgb(255, 121, 198)">        meta.kappsul.io/user-ns: "yes"</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token scalar string" style="color:rgb(255, 121, 198)">        meta.kappsul.io/user-email: "{{ "{{" }} .Workspace.UserEmail | replace "@" "_at_" {{ "}}" }}"</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token scalar string" style="color:rgb(255, 121, 198)">        meta.kappsul.io/user-checksum: "{{ "{{" }} .Workspace.UserCheckSum {{ "}}" }}"</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token scalar string" style="color:rgb(255, 121, 198)">        pod-security.kubernetes.io/enforce: baseline</span><br></div></code></pre></div></div>
<p>Le même ConfigMap définit aussi le quota, le limit range, les bindings RBAC et la network
policy. C'est le « une seule config » du titre : un unique objet géré dans Git décrit
l'enveloppe de tous les tenants.</p>
<p>L'opérateur utilise aussi le template pour la <strong>découverte</strong>. Il ne code pas en dur une
liste de types de ressources à observer ; il scanne les ConfigMaps de template, extrait
l'<code>apiVersion</code> et le <code>kind</code> de chaque document, et enregistre un informer dynamique pour
les GVR résultants. L'ensemble des kinds observés est dérivé au démarrage, donc ajouter un
nouveau kind au template nécessite un redémarrage du controller avant que son informer ne
soit enregistré.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="appliquer--server-side-apply-dans-lordre-des-dépendances">Appliquer : server-side apply, dans l'ordre des dépendances<a href="https://blog.djovap.com/fr/multi-tenant-workspace-operator#appliquer--server-side-apply-dans-lordre-des-d%C3%A9pendances" class="hash-link" aria-label="Lien direct vers Appliquer : server-side apply, dans l'ordre des dépendances" title="Lien direct vers Appliquer : server-side apply, dans l'ordre des dépendances" translate="no">​</a></h2>
<p>Le rendu produit une map de documents YAML. L'opérateur les parse en objets unstructured,
les trie par kind — Namespace d'abord, puis quota, limit range, service account, roles,
role bindings, ConfigMaps, secrets et network policies — et applique chacun avec
server-side apply.</p>
<div class="language-go codeBlockContainer_j5cZ theme-code-block" style="--prism-color:#F8F8F2;--prism-background-color:#282A36"><div class="codeBlockContent_Nbbu"><pre tabindex="0" class="prism-code language-go codeBlock_BIxk thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_Esqw"><div class="token-line" style="color:#F8F8F2"><span class="token plain">labels</span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token string" style="color:rgb(255, 121, 198)">"app.kubernetes.io/managed-by"</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> </span><span class="token operator">=</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">"workspace-controller"</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">labels</span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token string" style="color:rgb(255, 121, 198)">"workspace.kappsul.io/name"</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> </span><span class="token operator">=</span><span class="token plain"> workspace</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">Name</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">labels</span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token string" style="color:rgb(255, 121, 198)">"workspace.kappsul.io/uid"</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> </span><span class="token operator">=</span><span class="token plain"> </span><span class="token function" style="color:rgb(80, 250, 123)">string</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">workspace</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">UID</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)">// ...and then:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">options </span><span class="token operator">:=</span><span class="token plain"> metav1</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">PatchOptions</span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    FieldManager</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">"workspace-controller"</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    Force</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain">        </span><span class="token function" style="color:rgb(80, 250, 123)">boolPtr</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token boolean">true</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token boolean">_</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> err </span><span class="token operator">:=</span><span class="token plain"> resourceClient</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Patch</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">ctx</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> resource</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">GetName</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    types</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">ApplyPatchType</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> data</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> options</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><br></div></code></pre></div></div>
<p>Server-side apply est la bonne primitive ici pour trois raisons. C'est idempotent, donc un
retry est toujours sûr. Cela évite les courses read-modify-write. Et cela enregistre la
<strong>propriété des champs</strong> : l'API server sait que <code>workspace-controller</code> possède ces champs.
Le flag <code>Force</code> fait gagner l'opérateur quand quelqu'un d'autre a touché un champ qu'il
possède, ce qui est exactement ce dont le self-heal a besoin.</p>
<p>L'applier ajoute trois labels et une annotation à chaque ressource. Les labels identifient
le workspace propriétaire ; l'annotation stocke un hash du <code>spec</code> et du <code>data</code> rendus. Ce
hash est utile pour le suivi et le debug, mais ce n'est pas lui qui pilote la détection de
drift. Un hash peut vous dire que quelque chose a changé. Il ne peut pas vous dire <strong>qui</strong>
l'a changé.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="self-heal--qui-a-écrit-ce-champ-">Self-heal : qui a écrit ce champ ?<a href="https://blog.djovap.com/fr/multi-tenant-workspace-operator#self-heal--qui-a-%C3%A9crit-ce-champ-" class="hash-link" aria-label="Lien direct vers Self-heal : qui a écrit ce champ ?" title="Lien direct vers Self-heal : qui a écrit ce champ ?" translate="no">​</a></h2>
<p>C'est le premier comportement dont nous avions besoin dans la boîte à outils GitOps.</p>
<p>L'étudiant a <code>admin</code> dans son namespace. C'est intentionnel : il doit pouvoir déployer des
applications, créer des services, gérer ses propres ressources. Mais la même permission lui
permet de modifier le quota, le limit range, les bindings RBAC et la network policy. Ce sont
des invariants de la plateforme, pas des ressources de l'étudiant.</p>
<p>La question difficile est de distinguer l'édition d'un étudiant de l'écriture de
l'opérateur. Une comparaison de hash vous dit que l'objet ne correspond plus à la dernière
chose que vous avez écrite — mais votre propre reconciliation le change aussi, donc
l'événement suivant ressemble exactement à du drift. Et réappliquer à chaque événement
aggrave les choses : vos propres écritures déclenchent encore plus d'événements.</p>
<p>La réponse est <code>managedFields</code>. Chaque écriture enregistre un field manager. Le watcher de
drift regarde l'entrée la plus récente et pose une question simple : est-ce
<code>workspace-controller</code> ou quelqu'un d'autre ?</p>
<div class="language-go codeBlockContainer_j5cZ theme-code-block" style="--prism-color:#F8F8F2;--prism-background-color:#282A36"><div class="codeBlockContent_Nbbu"><pre tabindex="0" class="prism-code language-go codeBlock_BIxk thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_Esqw"><div class="token-line" style="color:#F8F8F2"><span class="token plain">lastModifier </span><span class="token operator">:=</span><span class="token plain"> </span><span class="token function" style="color:rgb(80, 250, 123)">getLastModifier</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">newObj</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">GetManagedFields</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">if</span><span class="token plain"> lastModifier </span><span class="token operator">==</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">"workspace-controller"</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token comment" style="color:rgb(98, 114, 164)">// Our own reconciliation. Not drift.</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">return</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)">// Someone else changed a resource we own.</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token function" style="color:rgb(80, 250, 123)">setDriftAnnotation</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">workspaceName</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token function" style="color:rgb(80, 250, 123)">enqueueWorkspace</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">workspaceName</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><br></div></code></pre></div></div>
<p>Le reconciler voit l'annotation, force-applique l'état désiré, et retire l'annotation. Le
changement de l'étudiant disparaît. Le cycle est intentionnel et idempotent.</p>
<!-- -->
<p>Il y a une nuance importante ici. <strong>Le self-heal est un contrôle correctif, pas la
frontière de sécurité.</strong> La frontière de sécurité, c'est le namespace, le RBAC et la
NetworkPolicy : ils décident ce que l'étudiant peut atteindre. Le self-heal protège les
invariants <em>à l'intérieur</em> du namespace du tenant, là où l'étudiant est légitimement admin.
C'est la différence entre « vous êtes autorisé à modifier ceci » et « cette valeur n'est
pas la vôtre ».</p>
<p>C'est aussi une heuristique, pas une preuve. Un acteur qui écrit avec un nom de manager
<code>workspace-controller</code> serait indiscernable de nous. Notre modèle de menace est un étudiant
avec <code>kubectl</code>, pas une identité de controller compromise.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="propagation--une-config-tous-les-workspaces">Propagation : une config, tous les workspaces<a href="https://blog.djovap.com/fr/multi-tenant-workspace-operator#propagation--une-config-tous-les-workspaces" class="hash-link" aria-label="Lien direct vers Propagation : une config, tous les workspaces" title="Lien direct vers Propagation : une config, tous les workspaces" translate="no">​</a></h2>
<p>C'est le second comportement dont nous avions besoin.</p>
<p>Changer le template est l'opération à plus fort levier du système. Nous voulons qu'elle
soit rapide, visible et rate-limitée.</p>
<p>L'informer ConfigMap stocke le nouveau <code>resourceVersion</code> dans un cache en mémoire et liste
les workspaces depuis le cache de l'informer — pas depuis l'API server. Pour chaque
workspace qui utilise ce template, il ajoute un élément à la work queue. C'est bon marché.
La queue, pas le handler d'événement, est le buffer.</p>
<div class="language-go codeBlockContainer_j5cZ theme-code-block" style="--prism-color:#F8F8F2;--prism-background-color:#282A36"><div class="codeBlockContent_Nbbu"><pre tabindex="0" class="prism-code language-go codeBlock_BIxk thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_Esqw"><div class="token-line" style="color:#F8F8F2"><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">func</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">c </span><span class="token operator">*</span><span class="token plain">WorkspaceController</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> </span><span class="token function" style="color:rgb(80, 250, 123)">handleConfigMapChange</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">obj </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">interface</span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    cm </span><span class="token operator">:=</span><span class="token plain"> obj</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token operator">*</span><span class="token plain">corev1</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">ConfigMap</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    c</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">templateVersionCache</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Store</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">cm</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">Name</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> cm</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">ResourceVersion</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    workspaces</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token boolean">_</span><span class="token plain"> </span><span class="token operator">:=</span><span class="token plain"> c</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">workspacesLister</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token function" style="color:rgb(80, 250, 123)">Workspaces</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">c</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">config</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">WorkspacesNamespace</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token function" style="color:rgb(80, 250, 123)">List</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">labels</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Everything</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">for</span><span class="token plain"> </span><span class="token boolean">_</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> ws </span><span class="token operator">:=</span><span class="token plain"> </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">range</span><span class="token plain"> workspaces </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        templateName </span><span class="token operator">:=</span><span class="token plain"> ws</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">Spec</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">TemplateConfigMap</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">if</span><span class="token plain"> templateName </span><span class="token operator">==</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">""</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            templateName </span><span class="token operator">=</span><span class="token plain"> c</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">config</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">DefaultTemplateConfigMap</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">if</span><span class="token plain"> templateName </span><span class="token operator">==</span><span class="token plain"> cm</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">Name </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            c</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">enqueueWorkspace</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">ws</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> </span><span class="token comment" style="color:rgb(98, 114, 164)">// one queue item; no API call here</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><br></div></code></pre></div></div>
<p>Le reconciler compare ensuite <code>status.lastTemplateVersion</code> avec la version en cache. Si
elles diffèrent, il réconcilie et enregistre la nouvelle version. À 50 workspaces par
seconde, dix mille workspaces convergent en environ trois minutes.</p>
<!-- -->
<p>C'est le comportement GitOps que nous voulions : une configuration dans Git, propagée à
tous les tenants. Pas d'Application par tenant, pas de boucle de sync par workspace.
L'opérateur est le moteur de fan-out.</p>
<p>La leçon n'est pas « fan-out plus vite ». C'est « fan-out dans une queue ». Une boucle qui
appelle l'API server dix mille fois est une attaque par déni de service que vous avez
écrite vous-même. Une boucle qui enqueue dix mille éléments et laisse un pool de workers
rate-limité les drainer est un rollout.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="cycle-de-vie--créer-et-supprimer">Cycle de vie : créer et supprimer<a href="https://blog.djovap.com/fr/multi-tenant-workspace-operator#cycle-de-vie--cr%C3%A9er-et-supprimer" class="hash-link" aria-label="Lien direct vers Cycle de vie : créer et supprimer" title="Lien direct vers Cycle de vie : créer et supprimer" translate="no">​</a></h2>
<p>La création et la suppression sont de la plomberie autour des deux comportements, mais
elles demandent quand même du soin.</p>
<p><strong>Création.</strong> L'opérateur ajoute un finalizer, génère un <code>userCheckSum</code> s'il manque, rend le
template, applique les ressources et marque le workspace <code>Active</code>. Le checksum et le
finalizer suivent un pattern « une étape par passe » : écrire, retourner, et laisser
l'événement de mise à jour ramener le workspace. La reconciliation est une séquence
d'observations, pas un seul appel de fonction.</p>
<p><strong>Suppression.</strong> Il y a deux chemins. Les ressources retirées du template sont diffées
contre <code>managedResources</code>, ajoutées à <code>status.pendingDeletions</code>, et supprimées de manière
asynchrone à une cadence prudente de cinq suppressions par seconde avec vingt retries et un
backoff exponentiel. Le namespace lui-même est supprimé avec foreground propagation ; le
finalizer garde le CR Workspace jusqu'à ce que le namespace ait disparu.</p>
<p>Le Namespace est explicitement exclu du diff de template. Supprimer un namespace est le
travail du chemin de suppression de workspace, pas un effet de bord du diff de template.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="protéger-le-control-plane">Protéger le control plane<a href="https://blog.djovap.com/fr/multi-tenant-workspace-operator#prot%C3%A9ger-le-control-plane" class="hash-link" aria-label="Lien direct vers Protéger le control plane" title="Lien direct vers Protéger le control plane" translate="no">​</a></h2>
<p>Tout ce qui précède représente beaucoup d'écritures. Le design est façonné autant par ce
que nous refusons de faire que par ce que nous faisons.</p>
<table><thead><tr><th>Frontière</th><th>Réglage</th><th>Pourquoi</th></tr></thead><tbody><tr><td>Resync informer</td><td>30s</td><td>filet de sécurité pour les événements manqués</td></tr><tr><td>Queue de reconcile</td><td>50 QPS, burst 300</td><td>progression équitable pendant un rollout de template</td></tr><tr><td>Queue de suppression</td><td>5 QPS, burst 10, 1 worker</td><td>une tempête de suppressions est pire qu'une suppression lente</td></tr><tr><td>Mises à jour de status</td><td>50 QPS, batch toutes les 30s</td><td>les écritures etcd sont les plus coûteuses</td></tr><tr><td>Client Kubernetes</td><td>50 QPS, burst 300</td><td>protéger l'API server de nous-mêmes</td></tr><tr><td>Retries de suppression</td><td>20, 5ms à 1000s</td><td>succès eventual sans hot loops</td></tr></tbody></table>
<p>L'opérateur tourne en <strong>un seul réplica</strong>, et c'est délibéré. Il n'implémente pas de leader
election. Faire tourner deux réplicas signifierait deux reconcilers écrivant le même
status, deux ensembles d'appels API en double, et une classe de conflits que le verrouillage
optimiste ne peut que masquer. À la place, nous utilisons un PodDisruptionBudget avec
<code>maxUnavailable: 0</code> et une priority class élevée pour que la maintenance ne l'évince pas
sans y penser. Un redémarrage de pod coûte dix à trente secondes de travail de control
plane ; le resync et la queue rendent cela anecdotique.</p>
<p>Si vous avez besoin d'une vraie haute disponibilité, la réponse est le leader election avec
un Lease <code>coordination.k8s.io</code>, pas plus de réplicas derrière un Service. Nous n'en avons
pas eu besoin jusqu'ici. L'opérateur n'est pas sur le chemin temps réel, et le travail est
idempotent.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="la-facture">La facture<a href="https://blog.djovap.com/fr/multi-tenant-workspace-operator#la-facture" class="hash-link" aria-label="Lien direct vers La facture" title="Lien direct vers La facture" translate="no">​</a></h2>
<p>Ce design n'est pas gratuit. Voici ce que nous payons.</p>
<ul>
<li class=""><strong>Le self-heal est correctif, pas préventif.</strong> Un étudiant peut toujours faire le
changement ; l'opérateur l'annule. Si vous devez empêcher l'écriture, utilisez le RBAC et
les admission policies. Le self-heal est le filet de sécurité pour les ressources que
l'étudiant est autorisé à toucher.</li>
<li class=""><strong>Le template est un blast radius partagé.</strong> Un mauvais changement de template atteint
tous les workspaces à cinquante par seconde. C'est aussi une ligne dans Git, ce qui le
fait paraître inoffensif. Traitez un changement de template comme un rollout de
production : stagez-le, regardez les premiers workspaces, et ayez un rollback prêt.</li>
<li class=""><strong>Deux couches de template sont puissantes et délicates.</strong> L'échappement Helm est
laid, et une paire d'accolades manquante échoue au rendu, pas à l'écriture. L'alternative
— des manifests bruts intégrés à l'image de l'opérateur — perd la frontière GitOps. Nous
avons choisi la flexibilité et accepté la syntaxe.</li>
<li class=""><strong>La détection de drift fait confiance à <code>managedFields</code>.</strong> C'est un très bon signal,
mais c'est un signal, pas un système d'autorisation. Un acteur qui peut écrire avec le
nom de notre field manager peut l'éviter.</li>
<li class=""><strong>Vous possédez l'opérateur.</strong> C'est le compromis de la portabilité. Vous ne dépendez
plus d'ArgoCD dans le cluster, mais vous maintenez désormais le controller, son CRD et
ses modes de défaillance.</li>
<li class=""><strong>Il n'y a pas d'audit trail Git par tenant.</strong> Le status du CR est l'état, pas un commit
par workspace. Si vous avez besoin d'une trace de chaque changement de tenant, il faut
l'ajouter.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="à-retenir">À retenir<a href="https://blog.djovap.com/fr/multi-tenant-workspace-operator#%C3%A0-retenir" class="hash-link" aria-label="Lien direct vers À retenir" title="Lien direct vers À retenir" translate="no">​</a></h2>
<ul>
<li class=""><strong>Commencez par le modèle d'isolation.</strong> Un workspace, c'est un namespace plus un quota,
un limit range, du RBAC, une network policy et de la pod security. L'opérateur existe
pour rendre cette enveloppe cohérente.</li>
<li class=""><strong>Gardez le runtime portable.</strong> Ne faites pas d'un outil externe une dépendance runtime
pour une opération produit centrale. GitOps pour la livraison, un opérateur pour le
runtime.</li>
<li class=""><strong>Ne prenez que les comportements GitOps dont vous avez besoin.</strong> Le self-heal et la
propagation suffisaient. Vous n'avez pas besoin d'un moteur de sync complet pour les
obtenir.</li>
<li class=""><strong>Utilisez server-side apply.</strong> Des écritures idempotentes, pas de courses
read-modify-write, et une propriété des champs qui a du sens.</li>
<li class=""><strong>Détectez le drift par qui, pas par quoi.</strong> <code>managedFields</code> vous dit si le changement
vient de vous ou de quelqu'un d'autre ; un hash ne le peut pas.</li>
<li class=""><strong>Fan-out dans une queue, pas dans des appels API.</strong> La queue est le buffer qui
transforme un gros changement de template en rollout.</li>
<li class=""><strong>Séparez la frontière de sécurité du contrôle correctif.</strong> Le RBAC et la NetworkPolicy
décident ce qu'un étudiant peut atteindre. Le self-heal protège les invariants à
l'intérieur de son namespace.</li>
</ul>]]></content:encoded>
            <category>Kubernetes</category>
            <category>GitOps</category>
            <category>Systèmes distribués</category>
        </item>
        <item>
            <title><![CDATA[La migration qui a supprimé tous les workspaces : une histoire de guerre Kubernetes]]></title>
            <link>https://blog.djovap.com/fr/the-migration-that-deleted-every-workspace</link>
            <guid>https://blog.djovap.com/fr/the-migration-that-deleted-every-workspace</guid>
            <pubDate>Mon, 02 Nov 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Nous avons migré les workspaces de nos étudiants depuis des Applications ArgoCD vers un opérateur maison. La répétition est passée, la production a tourné au vert, et à la fin du run, tous les workspaces créés après les deux cents premiers avaient été supprimés — en silence. Voici l'histoire complète : la mécanique de la panne, le week-end de restauration, et ce que nous faisons différemment maintenant.]]></description>
            <content:encoded><![CDATA[<p>Kappsul est une plateforme que nous avons construite à l'Université de Lorraine : depuis
une interface web, n'importe quel étudiant peut obtenir un environnement privé et isolé
sur un cluster Kubernetes partagé, et y déployer ses propres applications. C'est
l'histoire du jour où nous avons changé la façon dont ces environnements sont gérés — une
migration qui a tourné au vert du début à la fin, et qui a supprimé tous les workspaces
créés après les deux cents premiers, avec tout leur contenu.</p>
<p>C'est aussi une histoire qui finit bien, et la fin a un nom : Velero.</p>
<!-- -->
<p>Si vous avez lu <a class="" href="https://blog.djovap.com/fr/multi-tenant-workspace-operator">Workspaces Kubernetes multi-tenant : isolation, self-heal et une seule
config</a>, vous connaissez la destination de cette
migration et les raisons de ce choix. Cet article raconte la partie de l'histoire que
cet article-là ignore volontairement : le jour de la bascule, et les deux heures pendant
lesquelles tout a mal tourné. Il est écrit pour être lu seul.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="ce-quest-kappsul-et-pourquoi-lisolation-est-le-produit">Ce qu'est Kappsul, et pourquoi l'isolation est le produit<a href="https://blog.djovap.com/fr/the-migration-that-deleted-every-workspace#ce-quest-kappsul-et-pourquoi-lisolation-est-le-produit" class="hash-link" aria-label="Lien direct vers Ce qu'est Kappsul, et pourquoi l'isolation est le produit" title="Lien direct vers Ce qu'est Kappsul, et pourquoi l'isolation est le produit" translate="no">​</a></h2>
<p>Les universités ont un problème Kubernetes bien particulier. Les cours et les projets
d'étudiants ont besoin d'un endroit où faire tourner une application — une app web, une
API, une base de données — mais on ne peut pas donner un cluster à chaque étudiant, et on
ne peut pas donner à des utilisateurs non fiables un accès à un cluster partagé. La
plateforme fait donc quelque chose d'intermédiaire : l'étudiant clique sur un bouton, et
obtient un <strong>namespace</strong> sur le cluster partagé, avec tout ce qu'il faut pour travailler
en sécurité à l'intérieur.</p>
<p>Cela a l'air trivial. C'est tout le produit. La partie difficile n'est pas de créer un
namespace — <code>kubectl create namespace</code> est une commande. La partie difficile, c'est le
<strong>contrat</strong> :</p>
<blockquote>
<p>Un namespace privé avec une frontière étanche, et assez de liberté à l'intérieur pour
être utile.</p>
</blockquote>
<p>« Assez de liberté » veut dire que l'étudiant est <code>admin</code> dans son namespace : il peut
déployer avec Helm, écrire des manifests, exposer des services, gérer ses propres
secrets. « Frontière étanche » veut dire qu'aucune de ces libertés ne peut fuiter — vers
les autres étudiants, ou vers la plateforme elle-même. Concrètement, chaque workspace
est une enveloppe de primitives Kubernetes :</p>
<table><thead><tr><th>Couche</th><th>Ce que l'étudiant obtient</th><th>Ce dont la plateforme est protégée</th></tr></thead><tbody><tr><td>Namespace</td><td>Un endroit privé pour déployer</td><td>Collisions de noms, accès inter-tenant</td></tr><tr><td>ResourceQuota</td><td>Un budget CPU/mémoire/stockage prévisible</td><td>Un workspace qui affame tout le cluster</td></tr><tr><td>LimitRange</td><td>Des requests et limits par défaut</td><td>Les pods sans limits qui passent au travers</td></tr><tr><td>RBAC</td><td><code>admin</code> dans son namespace, et rien d'autre</td><td>Les étudiants qui agissent hors de leur workspace</td></tr><tr><td>NetworkPolicy</td><td>Default-deny, ingress/egress explicites</td><td>Le trafic inter-namespace, l'egress inattendu</td></tr><tr><td>Pod Security Admission</td><td><code>baseline</code> en enforcement</td><td>Les pods privilégiés ou dangereux</td></tr></tbody></table>
<p>Un dernier point compte pour cette histoire : <strong>les tenants sont des étudiants</strong>. Ils
apprennent Kubernetes. Ils vont supprimer des choses, modifier des choses, casser des
choses — parfois exprès, juste pour voir. La plateforme ne peut pas empêcher chaque
erreur à l'intérieur du workspace ; elle doit <em>remettre le workspace en état</em> quand ça
arrive. Gardez cela en tête : c'est pour ça que le self-heal était une exigence, et c'est
ainsi qu'un outil de suppression s'est retrouvé avec une arme chargée.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="lépoque-argocd--un-bon-outil-bien-utilisé">L'époque ArgoCD : un bon outil, bien utilisé<a href="https://blog.djovap.com/fr/the-migration-that-deleted-every-workspace#l%C3%A9poque-argocd--un-bon-outil-bien-utilis%C3%A9" class="hash-link" aria-label="Lien direct vers L'époque ArgoCD : un bon outil, bien utilisé" title="Lien direct vers L'époque ArgoCD : un bon outil, bien utilisé" translate="no">​</a></h2>
<p>Pendant la première année, le cycle de vie de chaque workspace était géré par <strong>ArgoCD</strong>.
Créer un workspace signifiait créer une <code>Application</code> ArgoCD — une par workspace —
pointant vers un dépôt Git contenant un petit chart Helm : l'enveloppe du tableau
ci-dessus. ArgoCD surveillait Git, rendait le chart, et appliquait les ressources dans le
namespace de l'étudiant. Modifier le chart dans Git, et tous les workspaces convergeaient
vers le nouvel état.</p>
<!-- -->
<p>Je veux être juste avec cette conception, parce qu'elle était <strong>bonne</strong> :</p>
<ul>
<li class=""><strong>Déclarative et auditable.</strong> L'état souhaité de chaque workspace vivait dans Git.</li>
<li class=""><strong>Self-heal gratuit.</strong> Tout le métier d'ArgoCD est de détecter la dérive et de la
corriger — un étudiant modifie le quota, ArgoCD le remet. Nous avions notre exigence
la plus dure grâce à un outil que nous n'avions pas à écrire.</li>
<li class=""><strong>Éprouvé.</strong> Réconciliation, retries, sémantique de sync : des problèmes résolus, pas
les nôtres.</li>
<li class=""><strong>Zéro code de contrôleur maison.</strong> Rien à maintenir, rien à débugger à 2 h du matin.</li>
</ul>
<p>Alors pourquoi partir ? Quatre raisons, par ordre d'importance croissante :</p>
<ol>
<li class=""><strong>Il était sur le chemin critique.</strong> Créer un workspace — l'opération la plus
élémentaire du produit — exigeait qu'ArgoCD <em>et</em> GitLab soient up. Dès que l'un des
deux avait une panne, les étudiants ne pouvaient plus obtenir de workspace du tout.
Une dépendance qui n'avait rien à voir avec le produit pouvait faire tomber le
produit.</li>
<li class=""><strong>Il tuait la portabilité.</strong> La plateforme ne pouvait pas tourner sur un cluster sans
ArgoCD ni serveur Git. Nous voulions que Kappsul tourne sur n'importe quel cluster
Kubernetes.</li>
<li class=""><strong>C'était du sur-mesure à l'envers.</strong> Nous utilisions une plateforme de delivery
complète pour réconcilier six ressources par tenant. Pas de dashboard de sync par
workspace, pas d'app-of-apps, pas de multi-cluster — rien de tout cela n'aurait
jamais servi.</li>
<li class=""><strong>Un décalage d'échelle.</strong> Des milliers de minuscules Applications, rafraîchies à
l'infini par le contrôleur ArgoCD, pour au final un namespace avec quatre objets de
politique dedans.</li>
</ol>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="la-destination--un-crd-un-opérateur-deux-comportements">La destination : un CRD, un opérateur, deux comportements<a href="https://blog.djovap.com/fr/the-migration-that-deleted-every-workspace#la-destination--un-crd-un-op%C3%A9rateur-deux-comportements" class="hash-link" aria-label="Lien direct vers La destination : un CRD, un opérateur, deux comportements" title="Lien direct vers La destination : un CRD, un opérateur, deux comportements" translate="no">​</a></h2>
<p>Le remplacement est volontairement petit. Une ressource personnalisée <code>Workspace</code> est le
registre du tenant — qui la possède, quel namespace, quels invités. Un petit opérateur
observe ces CRs et fait exactement deux choses, qui se révèlent être les seules choses
dont nous avons jamais eu besoin dans la boîte à outils GitOps :</p>
<ul>
<li class=""><strong>Self-heal</strong> : si un étudiant modifie une ressource qui appartient à la plateforme,
on la remet — détecté non pas en comparant des hash, mais en demandant à
<code>managedFields</code> <em>qui</em> a fait la dernière écriture ;</li>
<li class=""><strong>Propagation</strong> : l'enveloppe est définie une seule fois, dans un template ConfigMap
géré dans Git ; on le change une fois, et l'opérateur le propage à tous les
workspaces.</li>
</ul>
<p>Le GitOps reste pour le <strong>delivery</strong> — le template vit dans Git et arrive dans le
cluster par l'outil de votre choix. Le <strong>runtime</strong> n'a besoin de rien d'autre que l'API
Kubernetes et le CRD. C'est tout l'argument : <em>GitOps pour le delivery, un opérateur
pour le runtime</em> — et c'est traité en profondeur dans <a class="" href="https://blog.djovap.com/fr/multi-tenant-workspace-operator">l'article sur
l'opérateur</a>.</p>
<!-- -->
<p>Ce que ce diagramme ne montre pas, c'est la partie qui compte pour la suite de cette
histoire : <strong>la suppression</strong>. Quand un Workspace CR est supprimé, l'opérateur supprime
le namespace de l'étudiant — propagation foreground, finalizer maintenu jusqu'à ce que
le namespace ait disparu. L'opérateur possède désormais le cycle de vie du namespace.
Gardez cela en tête aussi.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="le-plan--un-job-de-migration">Le plan : un job de migration<a href="https://blog.djovap.com/fr/the-migration-that-deleted-every-workspace#le-plan--un-job-de-migration" class="hash-link" aria-label="Lien direct vers Le plan : un job de migration" title="Lien direct vers Le plan : un job de migration" translate="no">​</a></h2>
<p>Donc : plusieurs milliers de workspaces actifs, chacun actuellement une Application
ArgoCD, devaient devenir des Workspace CRs. Sans interruption de service, sans perte de
données, sans « on réparera en chemin ». L'opérateur était prêt ; la bascule était le
problème.</p>
<p>Deux propriétés de l'ancien monde ont façonné toute la conception, et il faut les deux
pour comprendre la panne :</p>
<p><strong>Fait 1 — le finalizer de cascade.</strong> Les finalizers Kubernetes sont des chaînes posées
sur un objet qui signifient <em>« ne me supprime vraiment que lorsque le contrôleur qui
possède cette chaîne le dit »</em>. Chaque Application de workspace portait
<code>resources-finalizer.argocd.argoproj.io</code>, qui est la promesse d'ArgoCD : <em>quand cette
Application est supprimée, supprime tout ce qu'elle a créé</em> — le quota, le RBAC, les
network policies, <strong>et le namespace lui-même</strong>. Supprimer un namespace supprime tout son
contenu : chaque Deployment, Service, ConfigMap, Secret des étudiants, et chaque PVC avec
ses données. Ce finalizer est la raison pour laquelle la migration ne pouvait pas se
contenter de supprimer les Applications en priant.</p>
<p><strong>Fait 2 — les Applications étaient vivantes.</strong> Le contrôleur d'applications d'ArgoCD
rafraîchit chaque Application à son cycle de reconciliation, en réécrivant les champs de
status à chaque passe. Chacune de ces écritures incrémente le <code>resourceVersion</code> de
l'objet — le jeton de concurrence que Kubernetes utilise pour rejeter les écritures
basées sur des données périmées.</p>
<p>La logique du job de migration, par Application :</p>
<ol>
<li class=""><strong>Convertir</strong> l'Application ArgoCD en <code>Workspace</code> CR (même nom, même namespace cible,
utilisateur et invités extraits des Helm values) ;</li>
<li class=""><strong>Créer</strong> le Workspace CR et <strong>attendre</strong> que l'opérateur le réconcilie — polling
jusqu'à ce que le workspace passe <code>Active</code> avec toutes les ressources de l'enveloppe
créées ;</li>
<li class=""><strong>Retirer le finalizer de cascade</strong> de l'Application, pour que sa suppression ne
supprime que l'objet Application ;</li>
<li class=""><strong>Supprimer</strong> l'Application ArgoCD.</li>
</ol>
<p>Les déploiements, services et volumes des étudiants n'ont jamais été du ressort d'ArgoCD
— ils étaient installés par notre application service via Helm, directement dans le
namespace. Sur le papier, la passation était propre : l'opérateur reprend l'enveloppe, et
les affaires de l'étudiant n'ont jamais été à supprimer par ArgoCD.</p>
<!-- -->
<p>Et le job lui-même était réellement soigné. Il traitait les Applications par lots avec
des pauses entre les lots, limitait le débit de ses appels API, suivait sa progression
dans un fichier sur un volume persistant pour pouvoir reprendre, supportait un mode
dry-run, et refusait de supprimer une Application avant que son Workspace CR soit
totalement réconcilié. Nous en étions fiers. Ce n'est pas de l'ironie — chacune de ces
décisions était bonne. Le bug était ailleurs.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="la-répétition">La répétition<a href="https://blog.djovap.com/fr/the-migration-that-deleted-every-workspace#la-r%C3%A9p%C3%A9tition" class="hash-link" aria-label="Lien direct vers La répétition" title="Lien direct vers La répétition" translate="no">​</a></h2>
<p>Nous avons d'abord testé le job en préprod. La préprod avait une poignée de workspaces.</p>
<p>Le run a pris quelques minutes. Chaque Application a été convertie, chaque Workspace CR
réconcilié presque instantanément, chaque finalizer retiré, chaque Application
supprimée. Nous avons comparé les namespaces avant et après : identiques, enveloppe
comprise. Nous avons laissé tourner l'opérateur, vérifié que les workspaces se
self-heal, et déclaré le test concluant.</p>
<p>Il l'était — pour une plateforme de la taille de la préprod. Ce que nous avions testé,
c'était le code. Ce que nous n'avions pas testé, c'était l'horloge. Gardez cette idée en
tête.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="production-un-jeudi">Production, un jeudi<a href="https://blog.djovap.com/fr/the-migration-that-deleted-every-workspace#production-un-jeudi" class="hash-link" aria-label="Lien direct vers Production, un jeudi" title="Lien direct vers Production, un jeudi" translate="no">​</a></h2>
<p>Début décembre 2025, nous avons lancé la migration en production. La configuration était
celle prévue pour notre échelle : tous les workspaces (<code>WORKSPACES=*</code>), suppression
activée (<code>DELETE_ARGOCD=true</code>), des lots de 25 Applications avec une pause de 180
secondes entre les lots, cinq migrations concurrentes, et un timeout de 15 minutes pour
que l'opérateur réconcilie chaque Workspace.</p>
<p>Le run a démarré au vert. Les premières Applications ont été converties, réconciliées et
supprimées exactement comme en préprod. Le job enchaînait les lots, en remplissant les
logs de petites cases cochées.</p>
<p>Les deux cents premiers workspaces environ ont migré parfaitement.</p>
<p>Puis, sans que rien ne change — aucune erreur, aucun redémarrage, aucun seuil franchi —
les workspaces derrière les cases cochées ont commencé à mourir.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="la-course-que-nous-ne-savions-pas-courir">La course que nous ne savions pas courir<a href="https://blog.djovap.com/fr/the-migration-that-deleted-every-workspace#la-course-que-nous-ne-savions-pas-courir" class="hash-link" aria-label="Lien direct vers La course que nous ne savions pas courir" title="Lien direct vers La course que nous ne savions pas courir" translate="no">​</a></h2>
<p>Voici le mécanisme, et il est embarrassant de simplicité une fois qu'on le voit.</p>
<p>Le job avait récupéré <strong>toutes</strong> les Applications en un seul <code>LIST</code> au tout début du
run. À partir de ce moment, chaque objet Application qu'il tenait en mémoire a commencé
à vieillir. Pendant ce temps, le contrôleur d'applications d'ArgoCD continuait son
travail, rafraîchissant chaque Application à son cycle et incrémentant le
<code>resourceVersion</code> de chaque objet en réécrivant le status.</p>
<p>Pour chaque Application, le job ensuite :</p>
<ol>
<li class="">créait le Workspace CR,</li>
<li class="">attendait — jusqu'à quinze minutes — que l'opérateur le réconcilie,</li>
<li class="">et seulement ensuite tentait de retirer le finalizer de cascade, via un <strong><code>UPDATE</code>
d'objet complet</strong> de l'objet qu'il détenait depuis le début du run.</li>
</ol>
<p>Un <code>UPDATE</code> d'objet complet est un read-modify-write avec concurrence optimiste :
l'écriture transporte le <code>resourceVersion</code> que vous avez lu, et si l'objet vivant a
avancé depuis, le serveur API la rejette avec un <code>409 Conflict</code>. Au moment où le job
arrivait à une Application — après la création et la réconciliation de son Workspace CR,
après les lots et les pauses — l'objet qu'il détenait était <strong>vieux de minutes à
heures</strong>. ArgoCD l'avait réécrit de nombreuses fois.</p>
<div class="language-go codeBlockContainer_j5cZ theme-code-block" style="--prism-color:#F8F8F2;--prism-background-color:#282A36"><div class="codeBlockContent_Nbbu"><pre tabindex="0" class="prism-code language-go codeBlock_BIxk thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_Esqw"><div class="token-line" style="color:#F8F8F2"><span class="token comment" style="color:rgb(98, 114, 164)">// l'étape de retrait, réduite à l'essentiel</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">finalizers</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token boolean">_</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token boolean">_</span><span class="token plain"> </span><span class="token operator">:=</span><span class="token plain"> unstructured</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">NestedStringSlice</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">app</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">Object</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">"metadata"</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">"finalizers"</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)">// ...on retire le finalizer ArgoCD de la copie en mémoire...</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token boolean">_</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> err </span><span class="token operator">:=</span><span class="token plain"> dynamicClient</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Resource</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">applicationsGVR</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token function" style="color:rgb(80, 250, 123)">Namespace</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">app</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">GetNamespace</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token function" style="color:rgb(80, 250, 123)">Update</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">ctx</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> app</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> metav1</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">UpdateOptions</span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> </span><span class="token comment" style="color:rgb(98, 114, 164)">// écriture d'objet complet d'un objet périmé</span><br></div></code></pre></div></div>
<p>Pour les premières Applications, traitées quand le run était jeune, l'objet en mémoire
était encore assez frais pour que l'écriture gagne la course. Le finalizer était retiré,
l'Application supprimée proprement, et l'opérateur reprenait un namespace intact.</p>
<p>Pour chaque Application suivante, l'écriture perdait la course. Le serveur API la
rejetait. Le finalizer survivait. Et le job — qui considérait un échec de retrait comme
une raison de logger et de continuer, pas de s'arrêter — supprimait quand même
l'Application.</p>
<!-- -->
<p>Et le finalizer de cascade était une promesse. ArgoCD a supprimé chaque ressource que
cette Application avait jamais créée — le ResourceQuota, le LimitRange, les
NetworkPolicies, les bindings RBAC, et <strong>le namespace lui-même</strong>. Supprimer un namespace
supprime tout son contenu : chaque Deployment, StatefulSet, Service, ConfigMap, Secret
des étudiants, et chaque PVC avec ses données.</p>
<p>La courbe de péremption explique la frontière que nous avons observée. Le lot <em>k</em>
tournait à peu près à <code>T0 + k × (attente de réconciliation + délai entre lots)</code>. La
probabilité qu'une Application ait été touchée par ArgoCD depuis <code>T0</code> passe de «
possible » à « certaine » sur les deux premières heures. Deux cents workspaces plus
loin, le job avait franchi la ligne entre « gagne la course en général » et « la perd
toujours ». Rien dans le code n'avait changé à ce moment-là. Seule l'horloge avançait.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="le-silence">Le silence<a href="https://blog.djovap.com/fr/the-migration-that-deleted-every-workspace#le-silence" class="hash-link" aria-label="Lien direct vers Le silence" title="Lien direct vers Le silence" translate="no">​</a></h2>
<p>Voici la partie qui me semble encore la plus troublante : <strong>rien n'a échoué</strong>.</p>
<p>Le job de migration a rapporté du succès, car de là où il se tenait, tout avait réussi.
Le Workspace CR était créé — vrai. L'Application était supprimée — vrai aussi. Le job a
terminé, affiché son résumé, et ressorti avec un code de retour nul.</p>
<p>ArgoCD n'a rien signalé, parce que supprimer les ressources derrière une Application avec
le finalizer de cascade n'est pas une erreur — c'est le contrat. ArgoCD n'a même pas mal
agi ce jour-là : quelque part dans le cluster, un contrôleur honorait fidèlement une
promesse que nous avions faite un an plus tôt et oubliée.</p>
<p>Notre opérateur n'a rien signalé non plus. Sa boucle de réconciliation a vu des
namespaces qui n'existaient plus, et a fait exactement ce pour quoi il est conçu : il a
recréé l'enveloppe — namespace, quota, limit range, network policies, RBAC — par
server-side apply. La plateforme avait l'air <em>vivante</em>. Des workspaces up, accessibles,
et creux.</p>
<p>Et nos logs ? Le run n'a produit aucun warning qui soit parvenu à quelqu'un. Le seul
composant qui aurait pu signaler le mode de panne — l'étape de retrait du finalizer —
était écrit pour survivre à l'échec de son propre garde : logger, et continuer. Un garde
qui n'arrête pas le run n'est pas un garde ; c'est une clause de non-responsabilité. Le
post-mortem l'a trouvé dans le code en quelques minutes. Le retrouver dans les logs,
après coup, au milieu d'un million de lignes vertes, c'était une autre affaire.</p>
<p>Les premiers signaux sont venus des utilisateurs : des workspaces up, accessibles, et
vides.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="le-week-end">Le week-end<a href="https://blog.djovap.com/fr/the-migration-that-deleted-every-workspace#le-week-end" class="hash-link" aria-label="Lien direct vers Le week-end" title="Lien direct vers Le week-end" translate="no">​</a></h2>
<p>C'est la partie de l'histoire où je peux être reconnaissant au lieu d'être malin.</p>
<p>Nous avions des backups Velero. De tout — les objets Kubernetes et les données des
volumes. Pas parce que nous sommes des prophètes, mais parce que « le cluster mange un
namespace » figurait sur notre liste de risques depuis le premier jour, et que Velero
était la réponse que nous avions mise en place avant d'arrêter d'y penser.</p>
<p>L'équipe a passé le week-end à restaurer. Chaque namespace de workspace, chaque objet,
chaque PVC et les données qu'il contenait, ramenés à l'état dans lequel ils étaient
avant le run. Ce fut un travail long, peu glorieux : vérifier l'ordre de restauration,
reconcilier ce qui appartenait à quoi, contrôler que chaque workspace revenait entier.
Mais c'était <em>possible</em>, et lundi la plateforme était de retour, et l'incident est devenu
une histoire au lieu d'une fin.</p>
<!-- -->
<p>Deux choses ont fait la différence :</p>
<ul>
<li class=""><strong>Les backups couvraient les bonnes choses.</strong> Les objets Kubernetes <em>et</em> les données
des volumes persistants. Un backup de l'un sans l'autre aurait restauré la lettre et
perdu l'esprit.</li>
<li class=""><strong>Personne n'a eu à improviser.</strong> La procédure de restauration existait, l'outil était
installé, les backups étaient là. Le week-end a servi à exécuter, pas à concevoir.</li>
</ul>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="le-correctif-dont-nous-navions-plus-besoin">Le correctif dont nous n'avions plus besoin<a href="https://blog.djovap.com/fr/the-migration-that-deleted-every-workspace#le-correctif-dont-nous-navions-plus-besoin" class="hash-link" aria-label="Lien direct vers Le correctif dont nous n'avions plus besoin" title="Lien direct vers Le correctif dont nous n'avions plus besoin" translate="no">​</a></h2>
<p>Pour être complet : le job a bien été corrigé. L'étape de retrait a été remplacée par une
suppression qui demande à Kubernetes de rendre les dépendants orphelins, et — plus
important — le job a appris à compter. Avant de supprimer une Application, il comptait
les Deployments, StatefulSets et Services du namespace cible ; après la suppression, il
recomptait, et faisait échouer l'entrée si le nombre avait baissé. Un canari par
namespace, pas cher et sans pitié.</p>
<p>Cela n'a plus beaucoup compté, car il n'y avait alors plus rien à migrer : la cascade a
fait la conversion au sens le plus littéral. Tous les workspaces <em>étaient</em> gérés par
l'opérateur. C'est la ligne la plus sombre de cette histoire, et la plus vraie : <strong>la
migration a réussi. Nous avions juste prévu qu'elle se termine par une conversion, pas
par une suppression.</strong></p>
<p>Quelques jours plus tard, nous avons supprimé le job de migration du dépôt. Les nouveaux
workspaces naissent en Workspace CRs. Plus personne ne lancera ce job, et la prochaine
plateforme n'aura jamais à le faire.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="ce-que-nous-avons-appris">Ce que nous avons appris<a href="https://blog.djovap.com/fr/the-migration-that-deleted-every-workspace#ce-que-nous-avons-appris" class="hash-link" aria-label="Lien direct vers Ce que nous avons appris" title="Lien direct vers Ce que nous avons appris" translate="no">​</a></h2>
<p><strong>1. L'échelle est une dimension de test.</strong> Nous avons testé le job sur une poignée de
workspaces et il est passé, parce qu'il était correct <em>pour une poignée de workspaces</em>.
Le mode de panne n'existe qu'aux durées de run supérieures à la fenêtre de fraîcheur des
objets migrés. Le correctif de notre stratégie de test : monter en charge
délibérément — 10, puis 100, puis 1 000, puis tous — et considérer qu'un run vert à une
échelle donnée ne prouve rien au-delà de cette échelle.</p>
<p><strong>2. Le temps est une dimension de test.</strong> La préprod était verte parce qu'elle était
<em>petite</em> : tout le run tenait dans la fenêtre où rien n'était périmé. La production a
tourné des heures, et le bug vit dans les heures. Tester en conditions réelles ne veut
pas dire tester sur des données de taille production — cela veut dire tester avec des
<em>durées</em> de forme production, ou accepter qu'un bug dépendant du temps soit invisible à
un run court.</p>
<p><strong>3. Jamais de read-modify-write d'état périmé sur un chemin destructif.</strong> L'étape de
retrait détenait un objet pendant des minutes-heures puis réécrivait tout. Les bons
patterns sont ennuyeux et connus : patcher le seul champ qui compte, ou relire l'objet
et recommencer en cas de conflit, ou utiliser le server-side apply avec un field manager
dédié. Nous les connaissions. L'opérateur lui-même est construit sur le server-side
apply précisément parce que cela évite les courses read-modify-write. Le job de
migration n'était pas tenu au même standard que la chose vers laquelle il migrait. Cette
asymétrie est la vraie cause racine.</p>
<p><strong>4. Un garde qui n'arrête pas le run n'est pas un garde.</strong> Le retrait du finalizer
pouvait échouer, logger, et laisser la suppression continuer. Sur un chemin qui finit par
un <code>DELETE</code>, chaque précondition manquée doit tout arrêter — bruyamment, et de préférence
au niveau du lot, pas de l'élément. « Warn and continue » est un défaut raisonnable pour
des retries et catastrophique pour des étapes irréversibles.</p>
<p><strong>5. Mesurez des résultats, pas des étapes.</strong> Le job vérifiait ses propres actions : CR
créé, Application supprimée. Deux fois vrai. Aucune des deux n'était ce qui comptait. Le
job corrigé comptait les ressources du namespace avant et après — un canari qui aurait
transformé la cascade silencieuse en échec franc dès le premier lot. Dix lignes de code,
qu'elles auraient dû exister dès le départ.</p>
<p><strong>6. Les finalizers sont des armes chargées.</strong>
<code>resources-finalizer.argocd.argoproj.io</code> n'est pas un détail d'implémentation ; c'est un
ordre permanent de détruire tout ce que l'objet a créé, namespace inclus. Avant toute
migration qui supprime des objets, auditez vers quoi chaque finalizer va cascader. Nous
avions écrit cet ordre nous-mêmes, un an plus tôt, et oublié qu'il était toujours en
vigueur.</p>
<p><strong>7. La panne la plus dangereuse, c'est chaque composant qui fonctionne comme prévu.</strong> Le
job a réussi. ArgoCD a honoré son contrat. L'opérateur a soigné les enveloppes. Personne
n'a menti, rien n'a planté, rien n'a alerté — et plusieurs milliers de workspaces
avaient disparu. Quand chaque couche rapporte du succès, il faut une couche qui mesure le
<em>réel</em>, pas l'intention.</p>
<p><strong>8. Les backups sont la différence entre une histoire et une fin.</strong> Velero, couvrant
objets et volumes, avec une procédure de restauration à laquelle quelqu'un avait
vraiment réfléchi. Le week-end a été long ; sans les backups, il vaut mieux ne pas
imaginer. Les exercices de restauration sont une assurance bon marché contre le pire jour
de votre trimestre.</p>
<p><strong>9. Les défauts dangereux survivent à leur contexte.</strong> Le chart du job embarquait
<code>DELETE_ARGOCD=true</code> et <code>WORKSPACES=*</code> en dur — la configuration avec laquelle
l'incident a tourné. Chaque défaut d'un outil destructif doit être le réglage sûr, le
réglage dangereux devant exiger une surcharge explicite et délibérée.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="à-retenir">À retenir<a href="https://blog.djovap.com/fr/the-migration-that-deleted-every-workspace#%C3%A0-retenir" class="hash-link" aria-label="Lien direct vers À retenir" title="Lien direct vers À retenir" translate="no">​</a></h2>
<p>L'opérateur gère les workspaces depuis — self-heal des enveloppes, propagation du
template, les deux comportements GitOps dont nous avions vraiment besoin. Il n'a jamais
supprimé ce qu'il ne fallait pas, en partie parce que sa conception refuse les courses
read-modify-write, et en partie parce que nous savons maintenant exactement vers quoi nos
chemins destructifs peuvent cascader.</p>
<p>La migration est la partie de l'histoire que je voudrais le moins revivre et celle dont
je suis le plus content qu'elle soit écrite. Si vous planifiez une migration entre deux
systèmes de gestion, avec des milliers d'objets actifs et une étape de suppression au
milieu : testez l'horloge, pas seulement le code. Patchez, ne réécrivez pas. Arrêtez tout
si un garde échoue. Comptez ce qui existe avant et après. Et gardez des backups
ennuyeux, complets, et répétés.</p>
<p>L'alternative, c'est un flux de logs très silencieux, une ligne de résumé bien verte, et
un lundi matin plein de namespaces vides.</p>]]></content:encoded>
            <category>Kubernetes</category>
            <category>GitOps</category>
            <category>Construction</category>
        </item>
        <item>
            <title><![CDATA[Les watchers Kubernetes à l'échelle : un seul watch, des milliers de dashboards]]></title>
            <link>https://blog.djovap.com/fr/kubernetes-watcher-at-scale</link>
            <guid>https://blog.djovap.com/fr/kubernetes-watcher-at-scale</guid>
            <pubDate>Wed, 28 Oct 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Comment nous avons construit une interface temps réel adossée à Kubernetes pour des milliers d'utilisateurs simultanés, sans multiplier les watches sur l'API server — watches par scope, propriété Redis, leases à la demande et fan-out d'événements.]]></description>
            <content:encoded><![CDATA[<p>Kappsul est une plateforme éducative construite à l'Université de Lorraine. Un étudiant
choisit un service dans un catalogue, obtient un namespace Kubernetes, et un dashboard
montre ce qui tourne à l'intérieur. Ce dashboard, c'est le produit : il doit être temps
réel. Il doit aussi survivre à trois mille onglets ouverts en même temps.</p>
<p>C'est l'histoire du petit système distribué que nous avons placé entre le navigateur et
l'API Kubernetes pour que ces deux affirmations soient vraies en même temps.</p>
<p><img decoding="async" loading="lazy" alt="Un porte-conteneurs entièrement chargé de conteneurs" src="https://blog.djovap.com/fr/assets/images/2026-10-28-kubernetes-watcher-at-scale-899d1a15e164a412abd7cd8dbbf4a4bf.webp" width="4988" height="3325" class="img_kvSm"></p>
<!-- -->
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="le-piège--une-session-est-une-très-mauvaise-unité-déchelle">Le piège : une session est une très mauvaise unité d'échelle<a href="https://blog.djovap.com/fr/kubernetes-watcher-at-scale#le-pi%C3%A8ge--une-session-est-une-tr%C3%A8s-mauvaise-unit%C3%A9-d%C3%A9chelle" class="hash-link" aria-label="Lien direct vers Le piège : une session est une très mauvaise unité d'échelle" title="Lien direct vers Le piège : une session est une très mauvaise unité d'échelle" translate="no">​</a></h2>
<p>« Temps réel » sonne comme une préoccupation d'interface. Dans un produit adossé à
Kubernetes, c'est une préoccupation d'API server, et les implémentations évidentes
échouent de deux manières très différentes.</p>
<p><strong>Le polling.</strong> Chaque dashboard demande l'état courant au backend toutes les quelques
secondes. Avec trois mille dashboards ouverts et un poll toutes les cinq secondes, cela
fait environ six cents requêtes par seconde avant même que quiconque clique. Chaque
réponse est une lecture complète : lister les deployments, les statefulsets, les pods, le
resource quota. La charge utile grandit avec le nombre d'objets, et les données sont
périmées par définition. Vous avez construit un générateur de charge contre votre propre
control plane, et vous affichez quand même aux utilisateurs des chiffres faux de quelques
secondes.</p>
<p><strong>Un watch par navigateur.</strong> Kubernetes fournit une API de streaming, donc le réflexe est
d'ouvrir un flux par onglet. Un seul dashboard a besoin de plus d'un flux : deployments et
statefulsets pour un workspace, ou pods pour une application précise, ou namespaces pour
la vue admin. Trois mille utilisateurs deviennent six à neuf mille flux longue durée,
chacun étant une connexion que l'API server doit maintenir, bufferiser et fan-out. L'API
server est une ressource partagée et rare : chaque flux qu'il sert pour votre UI est de la
capacité qu'il ne consacre pas à faire tourner le cluster.</p>
<p>Il y a un troisième piège, plus subtil : lancer un watch par pod backend sans coordination.
Vous passez le service à dix réplicas, et chaque réplica ouvre son propre watch pour le
même namespace. L'UI a l'air correcte. L'API server voit dix flux identiques. Mettre à
l'échelle votre propre service multiplie la charge sur le composant que vous essayiez de
protéger.</p>
<p>L'erreur est la même dans les trois cas : <strong>nous avons fait du watch une propriété de
l'utilisateur.</strong> Un watch est une propriété de la donnée. Si mille personnes regardent le
même workspace, il n'y a aucune raison pour que l'API server en connaisse plus d'une.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="watch-101-en-une-page">Watch 101, en une page<a href="https://blog.djovap.com/fr/kubernetes-watcher-at-scale#watch-101-en-une-page" class="hash-link" aria-label="Lien direct vers Watch 101, en une page" title="Lien direct vers Watch 101, en une page" translate="no">​</a></h2>
<p>Un watch Kubernetes est un flux de deltas sur une collection. On liste d'abord la
collection pour obtenir un <code>metadata.resourceVersion</code>, puis on regarde à partir de cette
version. Le serveur envoie des événements <code>ADDED</code>, <code>MODIFIED</code>, <code>DELETED</code> et <code>ERROR</code> ;
chaque objet porte le <code>resourceVersion</code> nécessaire pour reprendre. Le watch est borné par
un timeout, et quand le serveur le ferme — sur timeout, sur erreur, ou parce que
l'historique sous-jacent a expiré — le client est censé rembobiner et regarder à nouveau
depuis la dernière version qu'il a vue.</p>
<p>Deux détails font l'essentiel du travail dans un design comme le nôtre :</p>
<ul>
<li class=""><strong>Les sélecteurs.</strong> Un watch n'est aussi coûteux que l'ensemble qu'il observe. Le
cloisonnement par namespace et les label selectors (<code>app.kubernetes.io/instance=my-app</code>,
<code>meta.kappsul.io/user-ns=yes</code>) réduisent le flux à exactement la tranche dont l'UI a
besoin.</li>
<li class=""><strong>Une durée bornée.</strong> Un watch qui tourne indéfiniment est un watch que personne ne
réévalue. Un watch borné est un point de contrôle naturel : quand la fenêtre se ferme,
vous pouvez demander si quelqu'un s'y intéresse encore avant d'en ouvrir une autre.</li>
</ul>
<p>Si vous avez écrit un controller, vous connaissez la réponse standard : un informer. Un
watch par type de ressource et par processus, un cache en mémoire, et des handlers qui
fan-out vers ceux qui ont besoin de la donnée. Les informers sont la bonne brique de base
pour un controller. Ce ne sont pas une réponse complète pour une application web
multi-tenant, parce qu'un informer est local au processus. Dix réplicas signifient toujours
dix informers, et vous ne voulez pas non plus d'un informer par utilisateur final. Ce qu'il
faut réellement coordonner, c'est le <strong>watch</strong>, et l'unité de coordination n'est ni la
connexion ni le processus. C'est le scope.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="lunité-de-partage--un-scope">L'unité de partage : un scope<a href="https://blog.djovap.com/fr/kubernetes-watcher-at-scale#lunit%C3%A9-de-partage--un-scope" class="hash-link" aria-label="Lien direct vers L'unité de partage : un scope" title="Lien direct vers L'unité de partage : un scope" translate="no">​</a></h2>
<p>Un scope est la tranche du cluster qu'un groupe de spectateurs a en commun. Dans Kappsul,
nous en avons trois :</p>
<table><thead><tr><th>Scope</th><th>Objets Kubernetes</th><th>Sélecteur</th><th>Qui le regarde</th></tr></thead><tbody><tr><td><code>allWorkspaces</code></td><td>Namespaces</td><td><code>meta.kappsul.io/user-ns=yes</code></td><td>Vues admin</td></tr><tr><td><code>workspace:{name}</code></td><td>Deployments, StatefulSets</td><td>limité au namespace</td><td>Tous les utilisateurs d'un dashboard de workspace</td></tr><tr><td><code>app:{workspace}:{app}</code></td><td>Pods</td><td><code>app.kubernetes.io/instance={app}</code></td><td>Tous les utilisateurs d'une page de détail d'application</td></tr></tbody></table>
<p>C'est toute l'astuce, exprimée sous forme de tableau. Un scope est une promesse : <em>ces
spectateurs regardent la même donnée, donc ils peuvent partager le même flux.</em> Le nombre de
watches que voit l'API server devient le nombre de scopes actifs, pas le nombre
d'utilisateurs.</p>
<p>Règle de trois : si chaque dashboard avait besoin de trois flux et que chaque utilisateur
avait le sien, trois mille utilisateurs voudraient dire neuf mille watches. Si ces
utilisateurs sont répartis sur six cents workspaces, et que la vue admin se réduit à un
seul scope global, le système a besoin d'environ six cent un. Les utilisateurs sont une
dimension de l'UI, pas du watch.</p>
<!-- -->
<p>Remarquez ce qui n'est pas dans le diagramme : une flèche de chaque navigateur vers l'API
server. La seule chose qui touche Kubernetes est l'unique propriétaire du scope.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="un-propriétaire-par-scope">Un propriétaire par scope<a href="https://blog.djovap.com/fr/kubernetes-watcher-at-scale#un-propri%C3%A9taire-par-scope" class="hash-link" aria-label="Lien direct vers Un propriétaire par scope" title="Lien direct vers Un propriétaire par scope" translate="no">​</a></h2>
<p>La couche de coordination est un petit package Go, <code>watch-manager</code>, partagé par les
services admin, workspace et application. Il ne connaît rien à Kubernetes. Il implémente un
lease : exactement une instance de conteneur possède un scope à la fois, et le lease est
stocké dans Redis sous une clé dérivée du scope.</p>
<div class="language-text codeBlockContainer_j5cZ theme-code-block" style="--prism-color:#F8F8F2;--prism-background-color:#282A36"><div class="codeBlockContent_Nbbu"><pre tabindex="0" class="prism-code language-text codeBlock_BIxk thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_Esqw"><div class="token-line" style="color:#F8F8F2"><span class="token plain">watch-all-workspaces</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">watch-workspace:{workspace}</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">watch-app:{workspace}:{app}</span><br></div></code></pre></div></div>
<p>Démarrer un watch est une décision à trois branches : rejoindre, revendiquer, ou prendre
le relais.</p>
<!-- -->
<p>La branche « rejoindre » est celle qui rend des milliers d'utilisateurs peu coûteux. Un
second spectateur ne crée pas un second watch ; il prouve que le scope est toujours
désiré en repoussant le lease, et renvoie le propriétaire existant.</p>
<div class="language-go codeBlockContainer_j5cZ theme-code-block" style="--prism-color:#F8F8F2;--prism-background-color:#282A36"><div class="codeBlockContent_Nbbu"><pre tabindex="0" class="prism-code language-go codeBlock_BIxk thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_Esqw"><div class="token-line" style="color:#F8F8F2"><span class="token comment" style="color:rgb(98, 114, 164)">// watch-manager/manager.go (trimmed)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">watchKey </span><span class="token operator">:=</span><span class="token plain"> handler</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">GenerateWatchKey</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">watchCtx</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">currentWatcher</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token boolean">_</span><span class="token plain"> </span><span class="token operator">:=</span><span class="token plain"> c</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">redisClient</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Get</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">ctx</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> watchKey</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Result</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">if</span><span class="token plain"> currentWatcher </span><span class="token operator">!=</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">""</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    alive</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token boolean">_</span><span class="token plain"> </span><span class="token operator">:=</span><span class="token plain"> c</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">isContainerStillWatching</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">ctx</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> currentWatcher</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> config</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">if</span><span class="token plain"> alive </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token comment" style="color:rgb(98, 114, 164)">// Someone already watches this scope: join it, do not duplicate the stream.</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        ttl </span><span class="token operator">:=</span><span class="token plain"> time</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Duration</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">config</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">WatchRedisTTL</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> </span><span class="token operator">*</span><span class="token plain"> time</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">Second</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        c</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">redisClient</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Set</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">ctx</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> watchKey</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> currentWatcher</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> ttl</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">return</span><span class="token plain"> </span><span class="token operator">&amp;</span><span class="token plain">WatchResult</span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain">Success</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token boolean">true</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> WatchingContainerID</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> currentWatcher</span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token boolean">nil</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token comment" style="color:rgb(98, 114, 164)">// The owner is gone: exactly one contender wins the takeover.</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    taken</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token boolean">_</span><span class="token plain"> </span><span class="token operator">:=</span><span class="token plain"> c</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">attemptTakeover</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">ctx</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> currentWatcher</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> watchKey</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> config</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">if</span><span class="token plain"> </span><span class="token operator">!</span><span class="token plain">taken </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">return</span><span class="token plain"> </span><span class="token operator">&amp;</span><span class="token plain">WatchResult</span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain">Success</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token boolean">false</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> Message</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">"takeover lost"</span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token boolean">nil</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)">// Nobody owns the scope: claim it, then start the actual watch.</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">ttl </span><span class="token operator">:=</span><span class="token plain"> time</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Duration</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">config</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">WatchRedisTTL</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> </span><span class="token operator">*</span><span class="token plain"> time</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">Second</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">c</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">redisClient</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Set</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">ctx</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> watchKey</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> c</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">containerID</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> ttl</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">c</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">startHeartbeat</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">watchKey</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> config</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">if</span><span class="token plain"> err </span><span class="token operator">:=</span><span class="token plain"> handler</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">StartWatch</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">ctx</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> watchCtx</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"> err </span><span class="token operator">!=</span><span class="token plain"> </span><span class="token boolean">nil</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    c</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">stopHeartbeat</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">watchKey</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    c</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">redisClient</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Del</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">ctx</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> watchKey</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">return</span><span class="token plain"> </span><span class="token boolean">nil</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> err</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><br></div></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_tQxV" id="prouver-que-le-propriétaire-est-vivant">Prouver que le propriétaire est vivant<a href="https://blog.djovap.com/fr/kubernetes-watcher-at-scale#prouver-que-le-propri%C3%A9taire-est-vivant" class="hash-link" aria-label="Lien direct vers Prouver que le propriétaire est vivant" title="Lien direct vers Prouver que le propriétaire est vivant" translate="no">​</a></h3>
<p>La propriété seule ne suffit pas : un pod peut mourir en gardant la clé. Le propriétaire
prouve sa vivacité avec un heartbeat, et chaque concurrent le vérifie avant de lui faire
confiance. Le heartbeat est écrit toutes les trente secondes avec un TTL de soixante
secondes, et un heartbeat plus vieux que soixante secondes est considéré comme mort.</p>
<div class="language-go codeBlockContainer_j5cZ theme-code-block" style="--prism-color:#F8F8F2;--prism-background-color:#282A36"><div class="codeBlockContent_Nbbu"><pre tabindex="0" class="prism-code language-go codeBlock_BIxk thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_Esqw"><div class="token-line" style="color:#F8F8F2"><span class="token comment" style="color:rgb(98, 114, 164)">// A per-container heartbeat, refreshed by the owner's active watch loops.</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">heartbeatKey </span><span class="token operator">:=</span><span class="token plain"> config</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">HeartbeatPrefix </span><span class="token operator">+</span><span class="token plain"> c</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">containerID</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">ticker </span><span class="token operator">:=</span><span class="token plain"> time</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">NewTicker</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">time</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Duration</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">config</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">HeartbeatInterval</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> </span><span class="token operator">*</span><span class="token plain"> time</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">Second</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">go</span><span class="token plain"> </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">func</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">for</span><span class="token plain"> </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">range</span><span class="token plain"> ticker</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">C </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        ts </span><span class="token operator">:=</span><span class="token plain"> strconv</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">FormatInt</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">time</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Now</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Unix</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token number">10</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        c</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">redisClient</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Set</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">ctx</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> heartbeatKey</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> ts</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token number">2</span><span class="token operator">*</span><span class="token plain">time</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Duration</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">config</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">HeartbeatInterval</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token operator">*</span><span class="token plain">time</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">Second</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)">// ...and on the reader side:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">timeSinceHeartbeat </span><span class="token operator">:=</span><span class="token plain"> time</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Now</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Unix</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> </span><span class="token operator">-</span><span class="token plain"> timestamp</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">return</span><span class="token plain"> timeSinceHeartbeat </span><span class="token operator">&lt;</span><span class="token plain"> </span><span class="token number">60</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token boolean">nil</span><br></div></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_tQxV" id="prendre-le-relais-sans-stampede">Prendre le relais sans stampede<a href="https://blog.djovap.com/fr/kubernetes-watcher-at-scale#prendre-le-relais-sans-stampede" class="hash-link" aria-label="Lien direct vers Prendre le relais sans stampede" title="Lien direct vers Prendre le relais sans stampede" translate="no">​</a></h3>
<p>Quand le propriétaire est déclaré mort, chaque réplica qui le remarque peut tenter de
prendre le relais. La revendication doit être atomique, sinon vous obtenez exactement ce
que vous essayiez d'éviter : plusieurs pods convaincus de posséder le scope, chacun
ouvrant un watch. Nous faisons le compare-and-swap dans Redis avec un script Lua, pour que
la vérification et l'écriture soient une seule opération.</p>
<div class="language-lua codeBlockContainer_j5cZ theme-code-block" style="--prism-color:#F8F8F2;--prism-background-color:#282A36"><div class="codeBlockContent_Nbbu"><pre tabindex="0" class="prism-code language-lua codeBlock_BIxk thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_Esqw"><div class="token-line" style="color:#F8F8F2"><span class="token comment" style="color:rgb(98, 114, 164)">-- takeover.lua: only replace the owner we all agreed was dead.</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">local</span><span class="token plain"> current </span><span class="token operator">=</span><span class="token plain"> redis</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">call</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token string" style="color:rgb(255, 121, 198)">'get'</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> KEYS</span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token number">1</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">if</span><span class="token plain"> current </span><span class="token operator">==</span><span class="token plain"> ARGV</span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token number">1</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token plain"> </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">then</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    redis</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">call</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token string" style="color:rgb(255, 121, 198)">'set'</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> KEYS</span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token number">1</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> ARGV</span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token number">2</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">'EX'</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> ARGV</span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token number">3</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">return</span><span class="token plain"> </span><span class="token number">1</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">else</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">return</span><span class="token plain"> </span><span class="token number">0</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">end</span><br></div></code></pre></div></div>
<p>Un conteneur concurrent obtient <code>1</code>, démarre le watch et commence un heartbeat. Les autres
obtiennent <code>0</code> et se retirent. Le gagnant supprime aussi la clé de heartbeat du
propriétaire mort, pour que le concurrent suivant voie un état propre.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="le-lease-est-la-source-de-vérité-pas-le-watch">Le lease est la source de vérité, pas le watch<a href="https://blog.djovap.com/fr/kubernetes-watcher-at-scale#le-lease-est-la-source-de-v%C3%A9rit%C3%A9-pas-le-watch" class="hash-link" aria-label="Lien direct vers Le lease est la source de vérité, pas le watch" title="Lien direct vers Le lease est la source de vérité, pas le watch" translate="no">​</a></h2>
<p>Le changement le plus utile de tout le design a été d'arrêter de penser le watch comme une
ressource que l'on démarre et que l'on arrête, et de le penser comme un lease que l'on
maintient en vie.</p>
<p>Arrêter un watch ne <strong>supprime pas</strong> la clé. Cela abaisse le TTL à soixante secondes et
arrête le heartbeat. Cette période de grâce compte pour trois raisons :</p>
<ul>
<li class="">un autre utilisateur peut encore regarder le même scope ;</li>
<li class="">le même utilisateur peut recharger la page ou se reconnecter via un réseau instable ;</li>
<li class="">tuer le flux immédiatement garantirait un démarrage à froid à la requête suivante.</li>
</ul>
<p>Le frontend est l'autre moitié du lease. Un hook React démarre le watch au montage, le
renouvelle toutes les deux minutes tant que la page est ouverte, et l'arrête au démontage.
Le renouvellement n'est pas un nouveau watch ; c'est la même branche « rejoindre » que le
backend supporte déjà, qui prolonge le lease si le propriétaire est vivant et prend le
relais sinon.</p>
<div class="language-ts codeBlockContainer_j5cZ theme-code-block" style="--prism-color:#F8F8F2;--prism-background-color:#282A36"><div class="codeBlockContent_Nbbu"><pre tabindex="0" class="prism-code language-ts codeBlock_BIxk thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_Esqw"><div class="token-line" style="color:#F8F8F2"><span class="token comment" style="color:rgb(98, 114, 164)">// useWatch.ts (trimmed)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">const</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"> enabled </span><span class="token operator">=</span><span class="token plain"> </span><span class="token boolean">true</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> renewalInterval </span><span class="token operator">=</span><span class="token plain"> </span><span class="token number">2</span><span class="token plain"> </span><span class="token operator">*</span><span class="token plain"> </span><span class="token number">60</span><span class="token plain"> </span><span class="token operator">*</span><span class="token plain"> </span><span class="token number">1000</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"> </span><span class="token operator">=</span><span class="token plain"> options</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token function" style="color:rgb(80, 250, 123)">useEffect</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> </span><span class="token operator">=&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">if</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token operator">!</span><span class="token plain">enabled</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">return</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token function" style="color:rgb(80, 250, 123)">startWatch</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"> </span><span class="token comment" style="color:rgb(98, 114, 164)">// claim or join the lease</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">const</span><span class="token plain"> timer </span><span class="token operator">=</span><span class="token plain"> </span><span class="token function" style="color:rgb(80, 250, 123)">setInterval</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">renewWatch</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> renewalInterval</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"> </span><span class="token comment" style="color:rgb(98, 114, 164)">// keep the lease fresh</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">return</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> </span><span class="token operator">=&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token function" style="color:rgb(80, 250, 123)">clearInterval</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">timer</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token function" style="color:rgb(80, 250, 123)">stopWatch</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"> </span><span class="token comment" style="color:rgb(98, 114, 164)">// drop the lease, not the stream</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">enabled</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> config</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">type</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><br></div></code></pre></div></div>
<p>Cela donne au système trois horloges indépendantes, et il vaut la peine d'être explicite
sur ce que chacune protège :</p>
<table><thead><tr><th>Horloge</th><th>Valeur</th><th>Où elle vit</th><th>Ce qu'elle protège</th></tr></thead><tbody><tr><td>Fenêtre de watch Kubernetes</td><td>90s</td><td>flux vers l'API server</td><td>borne chaque flux et force un rembobinage</td></tr><tr><td>Intervalle de heartbeat</td><td>30s</td><td>pod propriétaire → Redis</td><td>prouve que le propriétaire est vivant</td></tr><tr><td>Péremption du heartbeat</td><td>60s</td><td>Redis / lecteur</td><td>déclare le propriétaire mort</td></tr><tr><td>TTL du lease</td><td>180s</td><td>Redis</td><td>conserve la propriété tant que le scope est regardé</td></tr><tr><td>Renouvellement client</td><td>120s</td><td>navigateur</td><td>garde le lease frais tant que la page est ouverte</td></tr><tr><td>Arrêt gracieux</td><td>60s</td><td>Redis</td><td>laisse les reconnexions et les autres spectateurs gagner</td></tr></tbody></table>
<p>L'ordre n'est pas accidentel. Le client renouvelle avant que le lease n'expire. Le
heartbeat est bien plus fréquent que le lease, donc un propriétaire mort est remarqué bien
avant que le lease lui-même n'arrive à échéance. La fenêtre de watch Kubernetes est
indépendante des deux : elle est là pour rendre le flux fini, pas pour maintenir la
propriété.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="le-watch-lui-même--borné-rembobiné-et-volontairement-ennuyeux">Le watch lui-même : borné, rembobiné, et volontairement ennuyeux<a href="https://blog.djovap.com/fr/kubernetes-watcher-at-scale#le-watch-lui-m%C3%AAme--born%C3%A9-rembobin%C3%A9-et-volontairement-ennuyeux" class="hash-link" aria-label="Lien direct vers Le watch lui-même : borné, rembobiné, et volontairement ennuyeux" title="Lien direct vers Le watch lui-même : borné, rembobiné, et volontairement ennuyeux" translate="no">​</a></h2>
<p>Le <code>watch-manager</code> décide <em>qui</em> regarde. Le service décide <em>quoi</em> regarder, et il le fait
avec une boucle de rewatch manuelle. Pour un workspace, cela signifie les deployments et
les statefulsets d'un namespace, chacun rembobiné depuis le dernier <code>resourceVersion</code> vu.</p>
<div class="language-go codeBlockContainer_j5cZ theme-code-block" style="--prism-color:#F8F8F2;--prism-background-color:#282A36"><div class="codeBlockContent_Nbbu"><pre tabindex="0" class="prism-code language-go codeBlock_BIxk thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_Esqw"><div class="token-line" style="color:#F8F8F2"><span class="token comment" style="color:rgb(98, 114, 164)">// workspace-service, WatchWorkspaceResources (trimmed)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">for</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    deploymentWatcher</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token boolean">_</span><span class="token plain"> </span><span class="token operator">:=</span><span class="token plain"> ws</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">k8sClient</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">WatchDeployments</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">ctx</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> workspace</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> metav1</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">ListOptions</span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        ResourceVersion</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> deploymentResourceVersion</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        TimeoutSeconds</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain">  </span><span class="token operator">&amp;</span><span class="token plain">timeout</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token comment" style="color:rgb(98, 114, 164)">// 90 seconds</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    statefulSetWatcher</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token boolean">_</span><span class="token plain"> </span><span class="token operator">:=</span><span class="token plain"> ws</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">k8sClient</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">WatchStatefulSets</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">ctx</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> workspace</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> metav1</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">ListOptions</span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        ResourceVersion</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"> statefulSetResourceVersion</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        TimeoutSeconds</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain">  </span><span class="token operator">&amp;</span><span class="token plain">timeout</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">watchLoop</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">for</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">select</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">case</span><span class="token plain"> event</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> ok </span><span class="token operator">:=</span><span class="token plain"> </span><span class="token operator">&lt;-</span><span class="token plain">deploymentWatcher</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">ResultChan</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">if</span><span class="token plain"> </span><span class="token operator">!</span><span class="token plain">ok </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                statefulSetWatcher</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Stop</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">break</span><span class="token plain"> watchLoop </span><span class="token comment" style="color:rgb(98, 114, 164)">// window closed: rewind with the last version</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">if</span><span class="token plain"> d</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> ok </span><span class="token operator">:=</span><span class="token plain"> event</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">Object</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token operator">*</span><span class="token plain">appsv1</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">Deployment</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"> ok </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">                deploymentResourceVersion </span><span class="token operator">=</span><span class="token plain"> d</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">ResourceVersion</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            ws</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">emitWorkspaceChanged</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">ctx</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> workspace</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">"watch-deployment"</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">case</span><span class="token plain"> event</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> ok </span><span class="token operator">:=</span><span class="token plain"> </span><span class="token operator">&lt;-</span><span class="token plain">statefulSetWatcher</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">ResultChan</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token comment" style="color:rgb(98, 114, 164)">// same shape for StatefulSets</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">case</span><span class="token plain"> </span><span class="token operator">&lt;-</span><span class="token plain">ctx</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Done</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">:</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            deploymentWatcher</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Stop</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            statefulSetWatcher</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Stop</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">            </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">return</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">        </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    time</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">Sleep</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">time</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token plain">Second</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> </span><span class="token comment" style="color:rgb(98, 114, 164)">// small backoff before rewinding</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><br></div></code></pre></div></div>
<p>Deux choses méritent d'être soulignées.</p>
<p><strong>Le rembobinage est l'endroit où l'on gère les parties désagréables.</strong> Un watch peut se
fermer pour une raison ordinaire (timeout) ou mauvaise (<code>ERROR</code>, historique expiré).
Transporter le dernier <code>resourceVersion</code> à travers le rembobinage évite les trous dans le
cas courant. Si l'API server répond que la version est trop ancienne — le cas <code>410 Gone</code> —
la bonne récupération n'est pas de réessayer la même version indéfiniment, mais de lister à
nouveau et de repartir de zéro. La fenêtre bornée existe en partie pour rendre cette
décision peu coûteuse : vous n'êtes jamais à plus de quatre-vingt-dix secondes d'un
redémarrage propre.</p>
<p><strong>Les sélecteurs font partie du contrat, pas de l'optimisation.</strong> Le watcher admin liste
les namespaces avec <code>meta.kappsul.io/user-ns=yes</code>. Le watcher d'application liste les pods
avec <code>app.kubernetes.io/instance={app}</code> et regarde depuis le <code>resourceVersion</code> de la liste.
Le watcher de workspace reste à l'intérieur d'un namespace. Si vous vous surprenez à
regarder une collection large et à filtrer en mémoire, vous avez déplacé le coût de l'API
server vers votre propre processus et conservé la pire partie du flux.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="fan-out--envoyer-des-signaux-pas-des-objets">Fan-out : envoyer des signaux, pas des objets<a href="https://blog.djovap.com/fr/kubernetes-watcher-at-scale#fan-out--envoyer-des-signaux-pas-des-objets" class="hash-link" aria-label="Lien direct vers Fan-out : envoyer des signaux, pas des objets" title="Lien direct vers Fan-out : envoyer des signaux, pas des objets" translate="no">​</a></h2>
<p>À ce stade, le côté Kubernetes est réglé : un flux par scope actif. La question restante
est de savoir comment un flux devient des mises à jour pour trois mille navigateurs.</p>
<p>La réponse courte est que le navigateur ne voit jamais un objet Kubernetes. Il voit un
petit signal, puis il lit la vérité via l'API normale.</p>
<!-- -->
<p>Le service émet un événement de topic avec une routing key dans l'espace <code>client.*</code>. Le
gateway possède une queue durable <code>client</code> liée à <code>client.#</code> sur l'exchange <code>events</code>. Il
consomme l'événement, transforme la routing key en nom de souscription GraphQL, et publie
dans Redis Pub/Sub. Redis est ce qui rend le gateway horizontalement scalable : un
WebSocket peut être connecté à n'importe quel réplica, et l'événement l'atteint quand même.</p>
<div class="language-ts codeBlockContainer_j5cZ theme-code-block" style="--prism-color:#F8F8F2;--prism-background-color:#282A36"><div class="codeBlockContent_Nbbu"><pre tabindex="0" class="prism-code language-ts codeBlock_BIxk thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_Esqw"><div class="token-line" style="color:#F8F8F2"><span class="token comment" style="color:rgb(98, 114, 164)">// gateway: routing key -&gt; subscription name</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">private</span><span class="token plain"> </span><span class="token function" style="color:rgb(80, 250, 123)">getSubscriptionName</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">routingKey</span><span class="token operator">:</span><span class="token plain"> </span><span class="token builtin" style="color:rgb(189, 147, 249)">string</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token operator">:</span><span class="token plain"> </span><span class="token builtin" style="color:rgb(189, 147, 249)">string</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">return</span><span class="token plain"> routingKey</span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">split</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token regex regex-delimiter">/</span><span class="token regex regex-source language-regex char-class char-class-punctuation punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token regex regex-source language-regex char-class">._-</span><span class="token regex regex-source language-regex char-class char-class-punctuation punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token regex regex-delimiter">/</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">filter</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">part</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> </span><span class="token operator">=&gt;</span><span class="token plain"> part </span><span class="token operator">!==</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">'client'</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">map</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">part</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> i</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> </span><span class="token operator">=&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">i </span><span class="token operator">===</span><span class="token plain"> </span><span class="token number">0</span><span class="token plain"> </span><span class="token operator">?</span><span class="token plain"> part </span><span class="token operator">:</span><span class="token plain"> part</span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token number">0</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">toUpperCase</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> </span><span class="token operator">+</span><span class="token plain"> part</span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">slice</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token number">1</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token punctuation" style="color:rgb(248, 248, 242)">.</span><span class="token function" style="color:rgb(80, 250, 123)">join</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token string" style="color:rgb(255, 121, 198)">''</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token comment" style="color:rgb(98, 114, 164)">// client.workspace-resources.changed -&gt; workspaceResourcesChanged</span><br></div></code></pre></div></div>
<p>La charge utile est volontairement minuscule : un nom de workspace, un nom d'application,
et une phase comme <code>initial</code>, <code>watch-deployment</code> ou <code>watch-statefulset</code>. C'est un message
d'invalidation de cache, pas un transfert de données. Le frontend s'abonne, filtre par les
arguments (<code>workspace</code>, et pour les applications aussi <code>app</code>), et rafraîchit via la même
requête qu'il aurait utilisée au premier chargement.</p>
<div class="language-ts codeBlockContainer_j5cZ theme-code-block" style="--prism-color:#F8F8F2;--prism-background-color:#282A36"><div class="codeBlockContent_Nbbu"><pre tabindex="0" class="prism-code language-ts codeBlock_BIxk thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_Esqw"><div class="token-line" style="color:#F8F8F2"><span class="token comment" style="color:rgb(98, 114, 164)">// The event is a signal. Read the truth through the API.</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token function" style="color:rgb(80, 250, 123)">useEffect</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> </span><span class="token operator">=&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">if</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token plain">subscriptionData</span><span class="token operator">?.</span><span class="token plain">workspaceResourcesChanged</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">    </span><span class="token function" style="color:rgb(80, 250, 123)">refetch</span><span class="token punctuation" style="color:rgb(248, 248, 242)">(</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain">  </span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#F8F8F2"><span class="token plain"></span><span class="token punctuation" style="color:rgb(248, 248, 242)">}</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> </span><span class="token punctuation" style="color:rgb(248, 248, 242)">[</span><span class="token plain">subscriptionData</span><span class="token punctuation" style="color:rgb(248, 248, 242)">,</span><span class="token plain"> refetch</span><span class="token punctuation" style="color:rgb(248, 248, 242)">]</span><span class="token punctuation" style="color:rgb(248, 248, 242)">)</span><span class="token punctuation" style="color:rgb(248, 248, 242)">;</span><br></div></code></pre></div></div>
<p>Ce choix apporte trois choses :</p>
<ul>
<li class=""><strong>Bande passante et couplage.</strong> Les objets Kubernetes sont gros et versionnés ; un signal
de changement n'est ni l'un ni l'autre. Le navigateur n'a pas besoin de comprendre les
Deployments pour savoir que les deployments ont changé.</li>
<li class=""><strong>L'autorisation reste sur le chemin de lecture.</strong> L'événement dit « quelque chose a
changé » ; le refetch passe par la requête GraphQL authentifiée normale, avec les règles
d'accès normales.</li>
<li class=""><strong>La cohérence reste là où elle vit déjà.</strong> Le chemin de requête sait assembler le
dashboard depuis la base et le cluster. Le chemin d'événement n'a pas à réimplémenter cet
assemblage.</li>
</ul>
<p>Le coût est l'amplification des refetchs : un vrai changement peut déclencher un refetch
par spectateur connecté. C'est généralement le bon compromis à cette échelle — un refetch
est une lecture bon marché et cacheable, alors qu'un flux par utilisateur ne l'est pas —
mais c'est un coût à surveiller, pas à ignorer.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="léchec-est-le-cas-normal">L'échec est le cas normal<a href="https://blog.djovap.com/fr/kubernetes-watcher-at-scale#l%C3%A9chec-est-le-cas-normal" class="hash-link" aria-label="Lien direct vers L'échec est le cas normal" title="Lien direct vers L'échec est le cas normal" translate="no">​</a></h2>
<p>Le design part du principe que les pods meurent. Quand le propriétaire d'un scope meurt,
rien n'est supprimé ; le lease cesse simplement d'être rafraîchi.</p>
<!-- -->
<p>Un heartbeat plus vieux que soixante secondes suffit à un autre réplica pour tenter un
takeover, et le compare-and-swap Lua garantit qu'un seul réussit. La fenêtre d'échec
pratique est de l'ordre d'une minute, plus le temps qu'un renouvellement ou un scan de
démarrage le remarque.</p>
<p>La récupération au démarrage utilise les mêmes primitives. Chaque service scanne son propre
préfixe dans Redis, restaure les scopes qu'il possède déjà, et tente de prendre le relais
sur les scopes dont le propriétaire est mort. C'est pourquoi un rolling restart ne produit
pas de stampede de démarrages à froid : le nouveau pod ne revendique pas aveuglément tous
les scopes qu'il voit ; il vérifie d'abord le heartbeat.</p>
<p>Le système est volontairement <strong>eventually consistent</strong> pendant un failover. Pendant une
courte fenêtre, deux watchers peuvent observer le même scope. C'est acceptable parce que
les événements sont des signaux d'invalidation idempotents : l'UI refetch et converge. Un
bref watch en double est un problème bien plus petit qu'un protocole de coordination qui
bloque sur un processus mort.</p>
<!-- -->
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="ce-que-ce-design-coûte">Ce que ce design coûte<a href="https://blog.djovap.com/fr/kubernetes-watcher-at-scale#ce-que-ce-design-co%C3%BBte" class="hash-link" aria-label="Lien direct vers Ce que ce design coûte" title="Lien direct vers Ce que ce design coûte" translate="no">​</a></h2>
<p>Il serait malhonnête de présenter cela comme gratuit. La charge sur l'API server n'a pas
disparu ; elle s'est déplacée, et les nouveaux endroits sont moins chers et plus faciles à
scaler indépendamment, mais ce sont quand même des endroits.</p>
<ul>
<li class=""><strong>Redis est sur le chemin chaud.</strong> Chaque démarrage, renouvellement et contrôle de
vivacité est un aller-retour Redis. C'est un petit nombre d'opérations par scope, pas par
utilisateur, mais Redis fait désormais partie de votre histoire de disponibilité.
Traitez-le comme tel : Sentinel ou un déploiement managé, et un plan pour ce qui se passe
quand il est lent.</li>
<li class=""><strong>La vivacité dépend des horloges.</strong> Le contrôle de heartbeat compare des timestamps
écrits par différents pods. Une discipline d'horloge raisonnable suffit, mais un pod avec
une horloge très décalée peut paraître mort ou immortel. Un signal de vivacité purement
basé sur le TTL est une piste de durcissement.</li>
<li class=""><strong>Les refetchs peuvent partir en stampede.</strong> Une rafale qui touche cinq cents pods produit
une rafale d'invalidations, puis une rafale de refetchs. Le debounce ou le coalescing par
scope, et le jitter sur les rafraîchissements client, sont les prochains leviers évidents.</li>
<li class=""><strong>Des watches en double existent brièvement.</strong> Le failover n'est pas atomique à travers
l'API server. Acceptez-le, et assurez-vous que des flux en double ne peuvent pas causer
des effets de bord en double.</li>
<li class=""><strong>Il y a plus de surface à opérer.</strong> Clés Redis, heartbeats, TTL de leases, un broker de
messages, une couche pub/sub et des réplicas WebSocket. Chacun est simple ; la
combinaison est un système qu'il faut observer.</li>
</ul>
<p>Le compromis reste largement en faveur de ce design, parce que la ressource qu'il protège —
l'API server Kubernetes — est celle qui est partagée par tout le reste du cluster.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="régler-les-paramètres">Régler les paramètres<a href="https://blog.djovap.com/fr/kubernetes-watcher-at-scale#r%C3%A9gler-les-param%C3%A8tres" class="hash-link" aria-label="Lien direct vers Régler les paramètres" title="Lien direct vers Régler les paramètres" translate="no">​</a></h2>
<p>Les chiffres ne sont pas magiques. Ils encodent quelques relations simples :</p>
<table><thead><tr><th>Paramètre</th><th>Valeur Kappsul</th><th>Contrainte</th></tr></thead><tbody><tr><td><code>WatchExpirationTime</code></td><td>90s</td><td>la fenêtre entre deux rembobinages</td></tr><tr><td><code>WatchRedisTTL</code></td><td>180s</td><td>doit dépasser l'intervalle de renouvellement client</td></tr><tr><td><code>HeartbeatInterval</code></td><td>30s</td><td>doit être bien inférieur au seuil de péremption</td></tr><tr><td>Péremption du heartbeat</td><td>60s</td><td>doit être inférieur au TTL du lease</td></tr><tr><td>Renouvellement client</td><td>120s</td><td>doit être inférieur à <code>WatchRedisTTL</code></td></tr><tr><td>TTL d'arrêt gracieux</td><td>60s</td><td>assez court pour libérer le scope, assez long pour survivre à un reload</td></tr></tbody></table>
<p>Si vous ne retenez qu'une règle de ce tableau, retenez celle-ci : <strong>le client doit
renouveler avant que le lease n'expire, et le heartbeat doit expirer avant le lease.</strong>
Inversez cet ordre et vous perdrez soit des watches vivants, soit vous garderez des watches
morts.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="ce-que-je-mesurerais-ensuite">Ce que je mesurerais ensuite<a href="https://blog.djovap.com/fr/kubernetes-watcher-at-scale#ce-que-je-mesurerais-ensuite" class="hash-link" aria-label="Lien direct vers Ce que je mesurerais ensuite" title="Lien direct vers Ce que je mesurerais ensuite" translate="no">​</a></h2>
<p>Le design n'est défendable qu'avec des chiffres, et les chiffres qui comptent sont
principalement du côté de l'API server :</p>
<ul>
<li class=""><strong>Les watches par type de ressource</strong>, et comment ce nombre suit les scopes actifs plutôt
que les utilisateurs connectés. C'est l'affirmation centrale du design.</li>
<li class=""><strong>Le QPS de list et de watch</strong>, plus le taux de réponses <code>410 Gone</code>. Un taux de 410 qui
monte signifie que votre rembobinage est trop lent ou que vos fenêtres sont trop longues.</li>
<li class=""><strong>La latence de livraison des événements</strong>, p50 et p99, depuis l'événement Kubernetes
jusqu'au refetch du navigateur. C'est ce que les utilisateurs ressentent vraiment.</li>
<li class=""><strong>Le taux de refetch par scope.</strong> C'est là qu'une rafale devient une stampede.</li>
<li class=""><strong>Le temps de failover</strong>, depuis la mort du propriétaire jusqu'au watch d'un nouveau
propriétaire. Les valeurs de heartbeat et de lease ci-dessus impliquent une cible ;
mesurez si vous l'atteignez.</li>
</ul>
<p>Si je devais durcir cela davantage, je commencerais par le debounce par scope des signaux
d'invalidation, du jitter sur les renouvellements client, et un contrôle de vivacité plus
strict qui ne dépend pas de la comparaison d'horloges murales entre pods.</p>
<h2 class="anchor anchorTargetStickyNavbar_tQxV" id="à-retenir">À retenir<a href="https://blog.djovap.com/fr/kubernetes-watcher-at-scale#%C3%A0-retenir" class="hash-link" aria-label="Lien direct vers À retenir" title="Lien direct vers À retenir" translate="no">​</a></h2>
<ul>
<li class=""><strong>Faites du watch une propriété de la donnée, pas de l'utilisateur.</strong> Définissez des
scopes — ensemble de ressources, sélecteur et namespace — et partagez un flux par scope.</li>
<li class=""><strong>Élisez un propriétaire par scope.</strong> Une clé Redis avec un TTL suffit, à condition
d'ajouter un heartbeat pour qu'un propriétaire mort ne la garde pas indéfiniment.</li>
<li class=""><strong>Rendez le takeover atomique.</strong> Un compare-and-swap Lua évite la stampede de failover
qui recréerait le problème que vous avez résolu.</li>
<li class=""><strong>Traitez le watch comme un lease.</strong> Démarrez à la consultation, renouvelez tant que
c'est consulté, baissez le TTL à l'arrêt, et laissez-le expirer naturellement.</li>
<li class=""><strong>Bornez et rembobinez le flux.</strong> Une fenêtre finie vous force à réévaluer la demande et
vous donne un endroit propre pour gérer les <code>resourceVersion</code> expirés.</li>
<li class=""><strong>Fan-out des signaux, pas des objets.</strong> Laissez un événement Kubernetes devenir une
petite invalidation, et laissez chaque client lire la vérité via l'API normale.</li>
<li class=""><strong>Partez du principe que l'échec est normal.</strong> Récupérez les scopes au démarrage,
acceptez un bref chevauchement, et rendez les événements en double inoffensifs.</li>
<li class=""><strong>Protégez d'abord l'API server.</strong> C'est la ressource partagée ; tout le reste de ce
design existe pour la garder hors du chemin chaud.</li>
</ul>]]></content:encoded>
            <category>Kubernetes</category>
            <category>Temps réel</category>
            <category>Systèmes distribués</category>
        </item>
    </channel>
</rss>