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.
Formation suivie via le blog de Stéphane Robert : Rolling updates et rollbacks.
minReadySeconds est défini)kubectl rollout restartkubectl rollout restart deployment/mon-appkubectl 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.
kubectl set imagekubectl set image deployment/mon-app conteneur=image:nouvelle-versionLaisse une trace exploitable.
spec: template: spec: containers: - name: nginx image: nginx:1.27.4@sha256:<xxx> # anciennement 1.27.3kubectl apply -f deployment.yamlkubectl editOuvre le manifeste courant et applique la modification à l’enregistrement du fichier.
kubectl edit deployment/mon-appTrois 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/v1kind: Deploymentmetadata: name: nginx-rollingspec: 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: 3readinessProbemaxSurge 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: Recreatekubectl rollout undo deployment/nginx-rollingkubectl 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.
kubectl rollout history deployment/nginx-rollingkubectl rollout history deployment/nginx-rolling --revision=2CHANGE-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.kubectl rollout undo deployment/nginx-rolling --to-revision=1Si ce numéro de révision n’existe plus, la commande échoue sans rien modifier.
change-causeL’annotation kubernetes.io/change-cause remplit la colonne CHANGE-CAUSE de l’historique. Elle remplace l’ancienne option --record, dépréciée.
# Poser la raisonkubectl annotate deployment/nginx-rolling kubernetes.io/change-cause="Correctif CVE-2025-23419, passage a nginx 1.27.4"
# La réécrire pour le changement suivantkubectl 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.
revisionHistoryLimitspec: revisionHistoryLimit: 5kubectl rollout pause deployment/nginx-rolling# ... plusieurs modifications du template ...kubectl rollout resume deployment/nginx-rollingPause
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.
readinessProbeminReadySecondsprogressDeadlineSeconds| 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 |