Skip to content

6. Rolling update et rollback

Formation suivie via le blog de Stéphane Robert : Rolling updates et rollbacks.

  1. Création d’un nouveau ReplicaSet
  2. Le nombre de replicas du nouveau ReplicaSet augmente progressivement
  3. Attente : les nouveaux pods doivent être Ready puis Available (si minReadySeconds est défini)
  4. Réduction progressive du nombre de replicas de l’ancien ReplicaSet
  5. Rollout complet quand tous les nouveaux replicas sont Available et les anciens supprimés
Terminal window
kubectl rollout restart deployment/mon-app
kubectl get deployment mon-app -o jsonpath='{.spec.template.metadata.annotations}'

La commande ci-dessus écrit une annotation horodatée dans le Pod template. Le template a changé donc une nouvelle révision est créée et un rollout progressif démarre.

Terminal window
kubectl set image deployment/mon-app conteneur=image:nouvelle-version

Laisse une trace exploitable.

deployment.yaml
spec:
template:
spec:
containers:
- name: nginx
image: nginx:1.27.4@sha256:<xxx> # anciennement 1.27.3
Terminal window
kubectl apply -f deployment.yaml

Ouvre le manifeste courant et applique la modification à l’enregistrement du fichier.

Terminal window
kubectl edit deployment/mon-app

Trois niveaux d’observation :

Question Commande
Statut en temps réel : le rollout avance-t-il ? kubectl rollout status deployment/nginx-rolling
Observer les Pods : quels Pods sont concernés ? kubectl get pods -l app=nginx-rolling -w
Voir les ReplicaSets : où en sont les ReplicaSets ? kubectl get rs -l app=nginx-rolling

Paramètre .spec.strategy, en prenant en compte la règle suivante : plus il y a de Pods indisponibles, plus la mise à jour est rapide.

Paramètres clés :

apiVersion: apps/v1
kind: Deployment
metadata:
name: nginx-rolling
spec:
replicas: 4
strategy:
type: RollingUpdate
rollingUpdate:
maxSurge: 1 # Combien de Pods en plus pendant l'update
maxUnavailable: 1 # Combien de Pods peuvent être indisponibles
progressDeadlineSeconds: 600 # Timeout pour détecter un rollout bloqué
minReadySeconds: 10 # Attendre 10s après Ready avant de continuer
selector:
matchLabels:
app: nginx-rolling
template:
metadata:
labels:
app: nginx-rolling
spec:
containers:
- name: nginx
image: nginx:1.27.3@sha256:bc2f6a7c8ddbccf55bdb19659ce3b0a92ca6559e86d42677a5a02ef6bda2fcef
readinessProbe:
httpGet:
path: /
port: 80
initialDelaySeconds: 5
periodSeconds: 3
  • readinessProbe
  • maxSurge et maxUnavailable : en nombre entier de Pods ou en pourcentage du champ replicas. Si non précisé, K8S prend 25 % pour les deux.

Un rollout qui n’aboutit pas ne s’annule pas tout seul : les anciens Pods continuent de servir, et le contrôleur continue d’essayer indéfiniment.

Paramètres à connaître :

progressDeadlineSeconds

Définit le délai après lequel K8S considère que le rollout n’avance plus. Il ne revient pas en arrière pour autant ! Il faut lancer la commande kubectl rollout undo pour revenir en arrière.

kubectl rollout status --timeout

L’option --timeout borne l’attente côté client, indépendamment de progressDeadlineSeconds qui agit côté contrôleur.

Recreate est la seule alternative à RollingUpdate. Elle supprime la totalité des Pods de l’ancienne révision, attend leur disparition effective, puis crée ceux de la nouvelle (interruption de service complète). maxSurge et maxUnavailable ne s’y appliquent pas.

spec:
strategy:
type: Recreate
Terminal window
kubectl rollout undo deployment/nginx-rolling
kubectl get deployment nginx-rolling -o jsonpath='{.spec.template.spec.containers[0].image}'

La première commande restaure le Pod template de l’avant-dernière révision. La seconde vérifie l’image restaurée en interrogeant un seul champ.

Le retour arrière est enregistré comme une nouvelle révision : l’historique s’allonge au lieu de reculer. Un undo répété fait donc alterner entre deux versions, et chaque opération crée une nouvelle révision.

Terminal window
kubectl rollout history deployment/nginx-rolling
kubectl rollout history deployment/nginx-rolling --revision=2
  • Chaque révision correspond à un ReplicaSet conservé.
  • La colonne CHANGE-CAUSE reste vide tant que l’annotation n’est pas posée (voir plus bas).
  • --revision=N affiche le Pod template complet enregistré pour cette révision : utile pour contrôler la cible avant un rollback.
Terminal window
kubectl rollout undo deployment/nginx-rolling --to-revision=1

Si ce numéro de révision n’existe plus, la commande échoue sans rien modifier.

Documenter la raison d’un changement : change-cause

Section titled “Documenter la raison d’un changement : change-cause”

L’annotation kubernetes.io/change-cause remplit la colonne CHANGE-CAUSE de l’historique. Elle remplace l’ancienne option --record, dépréciée.

Terminal window
# Poser la raison
kubectl annotate deployment/nginx-rolling kubernetes.io/change-cause="Correctif CVE-2025-23419, passage a nginx 1.27.4"
# La réécrire pour le changement suivant
kubectl annotate deployment/nginx-rolling --overwrite kubernetes.io/change-cause="Passage a nginx 1.28"
# La retirer (tiret final)
kubectl annotate deployment/nginx-rolling kubernetes.io/change-cause-

Une bonne raison contient un numéro de ticket, une référence de CVE ou un nom de version.

Limiter l’historique : revisionHistoryLimit

Section titled “Limiter l’historique : revisionHistoryLimit”
spec:
revisionHistoryLimit: 5
  • Valeur par défaut : 10.
  • À 0, il ne reste plus aucune révision : le rollback devient impossible.
Terminal window
kubectl rollout pause deployment/nginx-rolling
# ... plusieurs modifications du template ...
kubectl rollout resume deployment/nginx-rolling

Pause

Fige la prise en compte des modifications du template, y compris au milieu d’un rollout.

Reprise

Applique toutes les modifications accumulées en une seule révision.

  1. Toujours configurer une readinessProbe
  2. Définir minReadySeconds
  3. Définir progressDeadlineSeconds
  4. Annoter les déploiements
  5. Conserver un historique raisonnable
Anti-pattern Problèmes Solution
Pas de readinessProbe Pods exposés avant d’être prêts Configurer une probe réaliste
revisionHistoryLimit: 0 Impossible de faire un rollback Laisser le défaut de 10, ou descendre à 3-5 en connaissance de cause
Rollback sur Deployment pausé Échoue Reprendre d’abord avec resume
Supposer « zéro downtime » garanti Le rollout dépend de la config et des ressources Configurer stratégie + probes + tests
Utiliser Recreate pour la persistance Interruption de service, pas de garantie d’ordre Utiliser un StatefulSet
Modifier le selector après création Immutable en apps/v1 Recréer le Deployment si nécessaire
Enchaîner les apply sans vérifier Rollover peut créer de la confusion Attendre rollout status entre les déploiements