Un bloc resources vide rétrograde silencieusement les pods en BestEffort sur Kubernetes 1.34 à 1.36
Sur Kubernetes 1.34 à 1.36, un bloc `resources: {}` vide au niveau du pod fait passer la classe QoS en BestEffort même quand chaque conteneur déclare ses requêtes et limites, et l’exécuteur Kubernetes de GitLab Runner émettait ce bloc par défaut jusqu’à la version 19.4.3. Vérifiez vos clusters et passez GitLab Runner en 19.5.0 ou plus récent.
Novembre 2025. L’issue #135082 est ouverte sur le dépôt Kubernetes : un bloc resources: {} vide, au niveau du pod, est traité différemment d’un bloc absent. 15 juillet 2026. Le correctif PR #137150 est fusionné pour la 1.37, sans backport. 4 novembre 2026. Une équipe de DevOps Daily publie les mesures qui montrent l’impact réel sur un cluster k3s. Pourquoi c’est important : vos pods peuvent être classés BestEffort et évincés ou étranglés en priorité sans que personne n’ait changé une seule requête — et GitLab Runner émettait ce bloc par défaut.
Un bloc vide n’est pas un bloc absent
La faille tient à une distinction que presque tout le reste de Kubernetes ignore. Le feature gate PodLevelResources — les ressources déclarées au niveau du pod, et non par conteneur — est passé alpha en 1.32 et beta, activé par défaut, en 1.34, dans le cadre du KEP-2837. Avec ce gate, le calcul de la classe QoS emprunte un raccourci dans ComputePodQOS : si le gate est actif et que pod.Spec.Resources n’est pas nil, la fonction détermine la classe à partir des ressources du pod.
Un bloc resources: {} n’est pas nil. Il ne contient ni requête ni limite, donc la fonction renvoie BestEffort — et la boucle sur les conteneurs ne s’exécute jamais. Le helper IsPodLevelResourcesSet, lui, traite {} comme « non défini ». C’est cette divergence entre les deux lectures qui crée le bug, présent dans v1.34.0, v1.35.0 et v1.36.0, et toujours là dans les correctifs v1.34.13, v1.35.10 et v1.36.6 publiés le 27 octobre 2026.
Des conséquences mesurables, pas théoriques
L’équipe a exécuté les mêmes pods sur k3s v1.34.12, v1.35.9, v1.36.5 et v1.37.1, avec cgroup v2 et un seuil d’éviction dur memory.available<2Gi. Les résultats sont sans ambiguïté.
Le kubelet classe en BestEffort les pods porteurs du bloc vide, alors que leurs contrôles identiques conservent Burstable ou Guaranteed. L’oom_score_adj passe à 1000 — le maximum accepté par le noyau — contre 935 pour un Burstable et -997 pour un Guaranteed. Le pod bascule dans le slice kubepods-besteffort.slice, avec un cpu.weight de 1 et sans memory.max au niveau du pod, même si les limites des conteneurs restent en place.
La conséquence la plus parlante est le CPU. À côté d’un voisin qui sature ses deux vCPU, un pod qui demandait 0,5 CPU n’a obtenu que 0,061 à 0,083 cœur, contre 0,573 à 0,580 sans le bloc vide — soit 10,6 % à 14,3 % de sa requête. Un ResourceQuota avec scope BestEffort et pods: "0" rejette le pod sur 1.34 à 1.36 et l’admet sur 1.37. Sur v1.37.1, les classes redeviennent correctes.
Un mythe à corriger au passage
L’étude corrige aussi une croyance répandue. Contrairement à l’idée reçue selon laquelle ces pods seraient « évincés en premier », l’ordre d’éviction du kubelet sous pression mémoire n’a pas changé. Le classement compare l’usage mémoire à la requête déclarée — et pour un bloc vide, cette requête provient toujours des conteneurs. La classe QoS ne fait pas partie du classement. Sur les quatre versions, dans les douze répétitions, l’ordre d’éviction est resté identique.
C’est un rappel utile : la classe QoS gouverne l’oom_score_adj et le placement cgroup, pas l’ordre de récupération mémoire du kubelet. Le danger du bug n’est pas « l’éviction précoce », c’est l’étranglement CPU silencieux et le rejet par quota.
La source concrète : GitLab Runner
Le bug ne resterait qu’une curiosité s’il fallait écrire le bloc vide à la main. GitLab Runner l’a écrit pour vous. Son exécuteur Kubernetes a ajouté les ressources au niveau du pod en 18.10.0 (MR 5922) : le helper podResourcesReference() retourne un objet non nil, et si aucune des options pod_cpu_request, pod_memory_request, pod_cpu_limit ou pod_memory_limit n’est configurée, les deux maps restent vides — le pod part alors vers l’API avec resources: {}.
Le correctif MR 7346, fusionné le 1er octobre 2026 et livré dans 19.5.0, le confirme noir sur blanc : les pods de job « affichaient qosClass: BestEffort au lieu du Burstable attendu », et après la correction, .spec.resources est absent au lieu d’être {}. Les tags 19.3.5 et 19.4.3 du 28 octobre 2026 contenaient encore l’ancienne fonction.
# Détection en dix secondes : tout pod porteur de requêtes/limites
# mais classé BestEffort est un candidat au bug.
kubectl get pods -A -o custom-columns=NS:.metadata.namespace,POD:.metadata.name,QOS:.status.qosClass \
| grep BestEffort
# Vérifier la version de l'exécuteur :
gitlab-runner --version Le verdict
Si vous faites tourner GitLab Runner sur Kubernetes, mettez à niveau vers 19.5.0 ou plus récent — c’est la correction la plus directe, et les tags 19.3.5 et 19.4.3 sont encore affectés. Si vous opérez un cluster en 1.34, 1.35 ou 1.36, lancez la détection ci-dessus et traitez chaque pod BestEffort porteur de requêtes comme un faux positif de classe, car le correctif n’est pas backporté et les derniers correctifs datés du 27 octobre 2026 sont toujours vulnérables. Si vous comptiez sur la classe QoS pour prioriser l’éviction, corrigez votre modèle mental au passage — l’ordre d’éviction du kubelet ne dépend pas de la classe, mais de l’usage relatif à la requête. Le bug est un bon rappel que ce qui compte n’est pas ce que vous croyez avoir déclaré, mais ce que le kubelet a réellement classé.