Deployment 教學:自動補位、擴縮、滾動更新與回滾

K8s Deployment 管一群相同的 Pod:壞了自動補、要幾個就幾個,換版時一個一個換,出事一行回滾。

第 11 篇直接建的 Pod 有兩個大問題:刪了不會補、大部分設定改不了。正式環境真正在用的是 Deployment。這篇在 Cloud Shell 把 Deployment 的四大能力各做一次:刪 Pod 看它 1 秒補回來、從 3 個擴到 5 個、把 nginx 從 1.30 滾動更新到 1.31(實測 3 個換完 8.8 秒);最後故意換一個不存在的版本,看舊的 3 個 Pod 怎麼繼續撐住網站,再用一行指令回滾。

這是「容器系列」的第 12 篇。全部在 Cloud Shell 實際跑過,輸出都是真實結果(2026 年 11 月實測,Minikube v1.38.1、Kubernetes v1.35.1)。Pod 和 YAML 的基本寫法請先看第 11 篇:Pod 是什麼?寫第一個 YAML 把容器跑進 K8s。

Deployment 管 ReplicaSet、ReplicaSet 管 Pod:實測 web 這個 Deployment 底下的 ReplicaSet web-544b69cccb 保持剛好 3 個 Pod

為什麼你需要知道

  • 正式環境幾乎都用 Deployment:網站、API 這類「不用記住自己狀態」的程式,在 Kubernetes 上 9 成以上都是用 Deployment 部署的
  • 更新不停機:一次把舊版全關掉再開新版,中間網站會斷;Deployment 的滾動更新是一個一個換,使用者幾乎感覺不到
  • 出事能馬上退:新版本有 bug,kubectl rollout undo 一行就回到上一版。這是值班工程師半夜最需要的一招
  • 面試和證照必考:「滾動更新怎麼運作」「怎麼回滾」是 Kubernetes 面試的經典題;CKAD 上機考會直接要你換版和回滾

Deployment 是什麼

Deployment 是一份「我要幾個什麼樣的 Pod」的設定,Kubernetes 會一直幫你維持這個數量,並且負責換版本。

  • 比喻:餐廳的排班表寫「現場要 3 位廚師」。有人請假,店長馬上叫替補;換新菜單時,不會一次把 3 位都叫去受訓(那餐廳就沒人煮了),而是一位一位輪流去學
  • 來龍去脈:deployment 是英文的「部署」。早期 Kubernetes 用 ReplicationController 維持 Pod 數量,但換版本要自己手動處理;後來出現 Deployment,把「維持數量」和「換版本」包在一起,現在是官方推薦的做法(Kubernetes 官方說明:Deployments)
  • 為什麼要學:不用 Deployment,你就得自己盯著每個 Pod、自己一個一個換版本;用了它,這些事都交給控制器

ReplicaSet 是什麼

ReplicaSet 是「保持剛好 N 個相同 Pod」的控制器,Deployment 透過它來管 Pod。

  • 比喻:排班表是 Deployment,ReplicaSet 是「某一版菜單的廚師名單」。換菜單時,店長開一張新名單(新的 ReplicaSet),慢慢把人從舊名單移過去;舊名單先留著,萬一新菜單出問題可以馬上換回去
  • 來龍去脈:replica 是「複製品、副本」。它取代了舊的 ReplicationController
  • 為什麼要學:你幾乎不會自己建 ReplicaSet,但排錯時一定會看到它。每換一次版本,Deployment 就建一個新的 ReplicaSet,舊的留著當回滾用

三層關係:Deployment → ReplicaSet → Pod。Pod 名字 web-544b69cccb-h5rd2 就是「Deployment 名字-ReplicaSet 代號-隨機 5 個字」。

標籤選擇器(selector):Deployment 怎麼認得自己的 Pod

選擇器是「用標籤挑東西」的條件。 Deployment 的 YAML 有兩個地方要寫一樣的標籤:

  • spec.selector.matchLabels:我要管「標籤是 app: web」的 Pod
  • spec.template.metadata.labels:我建出來的 Pod 要貼上 app: web

兩邊對不上,kubectl apply 會直接報錯。可以想成「排班表上寫要管穿藍色制服的人,那你招進來的人就要發藍色制服」。


滾動更新是什麼

滾動更新(Rolling Update)是一次只換幾個 Pod,新的好了才關舊的,直到全部換完。 這是 Deployment 的預設做法。

  • 比喻:3 位廚師輪流去學新菜單,現場一直有人在煮
  • 來龍去脈:相對的做法叫 Recreate(全部重建):先把舊的全部關掉,再開新的。簡單,但中間一定會斷線。只有「新舊版本不能同時存在」的程式(例如兩版會搶同一個資料庫結構)才用 Recreate
  • 為什麼要學:滾動更新的速度和安全性,由兩個數字決定,面試很愛問

maxSurge 和 maxUnavailable 怎麼算

設定白話預設小數怎麼處理
maxSurge換版時,最多可以比設定的數量多開幾個25%無條件進位
maxUnavailable換版時,最多可以有幾個不能用25%無條件捨去

(Kubernetes 官方說明:Rolling Update Deployment,2026 年 11 月查)

算一次,用這篇的 3 個副本:

  • maxSurge:3 × 25%=0.75 → 進位=1,所以換版時最多有 3+1=4 個 Pod
  • maxUnavailable:3 × 25%=0.75 → 捨去=0,所以換版時至少 3 個都能用
滾動更新怎麼算:3 個副本時 maxSurge 0.75 進位成 1、maxUnavailable 0.75 捨去成 0,所以最多 4 個、至少 3 個能用;先多開 1 個新的、新的好了再關 1 個舊的

意思是:先多開 1 個新的,新的好了才關 1 個舊的,一直保持 3 個可用。實作的步驟 10 會看到 Kubernetes 印出 4 total | 3 available,跟算出來的一模一樣。

數字變大會怎樣:如果副本是 10 個,maxSurge=2.5 進位成 3、maxUnavailable=2.5 捨去成 2,換版時最多 13 個、至少 8 個能用,一次可以換比較多個,速度比較快,但同時要多準備 3 個 Pod 的資源。maxSurge 越大越快、越吃資源;maxUnavailable 越大越快、但服務能力降得越多。


動手做:Deployment 的補位、擴縮、更新、回滾

這段在 Cloud Shell(不用設專案) 做,不會花錢,大約 20 分鐘。怎麼打開 Cloud Shell 請看第 1 篇的步驟,跳出「授權 Cloud Shell」按「拒絕」就好。截圖裡的提示字元有縮短,你的畫面會是「你的帳號@cloudshell:~$」。

步驟 1:開資料夾和叢集

mkdir -p ~/k8s-deploy && cd ~/k8s-deploy; minikube start | tail -1
(前面省略:版本提醒和硬碟空間警告)
🏄  Done! kubectl is now configured to use "minikube" cluster and "default" namespace by default
建立 k8s-deploy 資料夾並啟動 minikube,最後一行顯示 Done

步驟 2:寫 Deployment 的 YAML 並建立

cat > deployment.yaml <<'EOF'
apiVersion: apps/v1
kind: Deployment
metadata:
  name: web
spec:
  replicas: 3
  selector:
    matchLabels:
      app: web
  template:
    metadata:
      labels:
        app: web
    spec:
      containers:
      - name: nginx
        image: nginx:1.30
        ports:
        - containerPort: 80
EOF
kubectl apply -f deployment.yaml; sleep 20; kubectl get deployment,replicaset,pod
deployment.apps/web created
NAME                  READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/web   3/3     3            3           20s

NAME                             DESIRED   CURRENT   READY   AGE
replicaset.apps/web-544b69cccb   3         3         3       20s

NAME                       READY   STATUS    RESTARTS   AGE
pod/web-544b69cccb-h5rd2   1/1     Running   0          20s
pod/web-544b69cccb-rd679   1/1     Running   0          20s
pod/web-544b69cccb-td5pn   1/1     Running   0          20s
kubectl apply 建立 Deployment web,底下一個 ReplicaSet web-544b69cccb 和 3 個 Running 的 Pod

跟第 11 篇 Pod 的 YAML 比,差在這幾行:

  • apiVersion: apps/v1:Deployment 屬於 apps 這組 API,不是 Pod 用的 v1
  • replicas: 3:要 3 個
  • selector.matchLabels:我管標籤 app: web 的 Pod
  • template: 底下:Pod 的範本,內容就是第 11 篇那份 Pod YAML 的 metadata 和 spec,只是不用寫名字(名字由 Deployment 自動產生)

READY 3/3、DESIRED 3 / CURRENT 3 / READY 3 都對上了,代表 3 個都健康。

步驟 3:刪一個 Pod,看它自動補回來

kubectl delete $(kubectl get pods -l app=web -o name | head -1); kubectl get pods
pod "web-544b69cccb-h5rd2" deleted from default namespace
NAME                   READY   STATUS    RESTARTS   AGE
web-544b69cccb-84zt7   1/1     Running   0          1s
web-544b69cccb-rd679   1/1     Running   0          28s
web-544b69cccb-td5pn   1/1     Running   0          28s
刪掉 web-544b69cccb-h5rd2 之後,立刻出現新的 web-544b69cccb-84zt7,AGE 1 秒、已經 Running

$( … ) 是「先跑括號裡的指令,把結果放進來」,這裡是挑出第一個 Pod 的名字。刪掉 h5rd2 後立刻多了一個 84zt7,AGE 1s 就已經 Running(映像檔已經在節點上,不用再下載)。第 11 篇直接建的 Pod 刪了就沒了,這就是差別。

步驟 4:擴成 5 個

kubectl scale deployment web --replicas=5; sleep 5; kubectl get pods
deployment.apps/web scaled
NAME                   READY   STATUS    RESTARTS   AGE
web-544b69cccb-84zt7   1/1     Running   0          12s
web-544b69cccb-rd679   1/1     Running   0          39s
web-544b69cccb-spftg   1/1     Running   0          5s
web-544b69cccb-td5pn   1/1     Running   0          39s
web-544b69cccb-xc8mm   1/1     Running   0          5s
kubectl scale 擴成 5 個,多了 spftg 和 xc8mm 兩個 5 秒前建立的 Pod

5 秒內就多了 2 個。擴縮(scale)只改數量,不會換版本,所以新的 Pod 跟舊的屬於同一個 ReplicaSet(544b69cccb)。

步驟 5:再 apply 一次檔案,又變回 3 個

kubectl apply -f deployment.yaml; sleep 5; kubectl get deployment web; kubectl get pods
deployment.apps/web configured
NAME   READY   UP-TO-DATE   AVAILABLE   AGE
web    3/3     3            3           50s
NAME                   READY   STATUS    RESTARTS   AGE
web-544b69cccb-84zt7   1/1     Running   0          23s
web-544b69cccb-rd679   1/1     Running   0          50s
web-544b69cccb-td5pn   1/1     Running   0          50s
再 apply 一次 deployment.yaml,Deployment 從 5 個縮回檔案裡寫的 3 個

檔案裡寫的是 replicas: 3,apply 之後就回到 3 個,步驟 4 用指令擴出來的 2 個被刪掉了。指令改的和檔案寫的不一樣時,以最後一次送出的為準。正式環境通常以檔案(放在 Git 裡的 YAML)為準,用指令臨時改的東西,下次有人 apply 就會被蓋掉。

步驟 6:滾動更新,把 nginx 從 1.30 換成 1.31

先幫目前這一版寫個備註,再換映像檔,最後用 rollout status 看進度,前面加 time 計時:

kubectl annotate deployment web kubernetes.io/change-cause='nginx 1.30 first release'; kubectl set image deployment/web nginx=nginx:1.31; time kubectl rollout status deployment/web
deployment.apps/web annotated
deployment.apps/web image updated
Waiting for deployment "web" rollout to finish: 1 out of 3 new replicas have been updated...
Waiting for deployment "web" rollout to finish: 1 out of 3 new replicas have been updated...
Waiting for deployment "web" rollout to finish: 1 out of 3 new replicas have been updated...
Waiting for deployment "web" rollout to finish: 2 out of 3 new replicas have been updated...
Waiting for deployment "web" rollout to finish: 2 out of 3 new replicas have been updated...
Waiting for deployment "web" rollout to finish: 2 out of 3 new replicas have been updated...
Waiting for deployment "web" rollout to finish: 2 out of 3 new replicas have been updated...
Waiting for deployment "web" rollout to finish: 1 old replicas are pending termination...
Waiting for deployment "web" rollout to finish: 1 old replicas are pending termination...
Waiting for deployment "web" rollout to finish: 1 old replicas are pending termination...
deployment "web" successfully rolled out

real    0m8.796s
user    0m0.082s
sys     0m0.030s
kubectl set image 觸發滾動更新,rollout status 顯示 1 out of 3、2 out of 3 逐步更新,8.8 秒後 successfully rolled out
  • annotate(註記)是在東西上加一段說明文字。kubernetes.io/change-cause 這個名字比較特別,rollout history 會把它當成「這一版改了什麼」顯示出來
  • set image deployment/web nginx=nginx:1.31:把 web 裡叫 nginx 的容器,映像檔換成 nginx:1.31。容器名字就是 YAML 裡 - name: nginx 那個
  • rollout status 會一直顯示進度直到完成:1 out of 3 → 2 out of 3 → 1 old replicas are pending termination(剩 1 個舊的在收尾)→ 完成

3 個 Pod 換完一共 8.8 秒,過程中一直有 3 個可以用。

步驟 7:看新舊兩個 ReplicaSet

kubectl annotate deployment web kubernetes.io/change-cause='upgrade to nginx 1.31' --overwrite; kubectl get replicaset; kubectl get pods -o custom-columns=NAME:.metadata.name,IMAGE:.spec.containers[0].image
deployment.apps/web annotated
NAME             DESIRED   CURRENT   READY   AGE
web-544b69cccb   0         0         0       69s
web-56649cb68c   3         3         3       14s
NAME                   IMAGE
web-56649cb68c-4crkv   nginx:1.31
web-56649cb68c-8wjzq   nginx:1.31
web-56649cb68c-s69fd   nginx:1.31
滾動更新後有兩個 ReplicaSet:舊的 web-544b69cccb 是 0 個、新的 web-56649cb68c 是 3 個,Pod 映像檔都是 nginx:1.31
  • 新版本的備註用 --overwrite 蓋過去(同一個註記名字要覆蓋,不加會報錯)
  • 舊的 ReplicaSet 544b69cccb 沒有被刪,只是變成 0 個,留著當回滾用;新的 56649cb68c 有 3 個
  • -o custom-columns=欄名:路徑 是自己挑要顯示哪幾欄,這裡看 Pod 名字和映像檔:3 個都是 nginx:1.31

預設會保留最近 10 個舊的 ReplicaSet(revisionHistoryLimit: 10,第 10 篇用 -o yaml 看過這行)。

步驟 8:看版本歷史

kubectl rollout history deployment/web
deployment.apps/web
REVISION  CHANGE-CAUSE
1         nginx 1.30 first release
2         upgrade to nginx 1.31
kubectl rollout history 顯示兩個版本:1 是 nginx 1.30 first release、2 是 upgrade to nginx 1.31

每一個 REVISION(版本)就是一個 ReplicaSet。 CHANGE-CAUSE 就是步驟 6、7 用 annotate 寫的備註;沒寫的話這欄會是 <none>,半年後回頭看就不知道每一版改了什麼。

步驟 9:故意換一個不存在的版本

nginx 沒有 9.99 這個版本,模擬「工程師打錯版本號」:

kubectl set image deployment/web nginx=nginx:9.99; kubectl annotate deployment web kubernetes.io/change-cause='bad tag 9.99' --overwrite; sleep 25; kubectl get pods; kubectl rollout status deployment/web --timeout=5s
deployment.apps/web image updated
deployment.apps/web annotated
NAME                   READY   STATUS             RESTARTS   AGE
web-56649cb68c-4crkv   1/1     Running            0          43s
web-56649cb68c-8wjzq   1/1     Running            0          51s
web-56649cb68c-s69fd   1/1     Running            0          44s
web-c97647d7c-z9sm7    0/1     ImagePullBackOff   0          26s
Waiting for deployment "web" rollout to finish: 1 out of 3 new replicas have been updated...
error: timed out waiting for the condition
換成不存在的 nginx:9.99 後,新的 Pod 卡在 ImagePullBackOff,舊的 3 個 nginx:1.31 Pod 照樣 Running

這是滾動更新最有價值的地方:

  • 新的 Pod(c97647d7c-z9sm7)拉不到映像檔,卡在 ImagePullBackOff(拉映像檔失敗,等一下再試),第 18 篇會專門講這個錯誤
  • 舊的 3 個 Pod 完全沒被動,網站照常服務。因為 maxUnavailable 是 0,新的沒好之前,一個舊的都不會關
  • rollout status --timeout=5s 等 5 秒還沒完成就放棄,印出 timed out。不加 --timeout 的話它會一直等

如果是 Recreate 策略,舊的 3 個會先全部被關掉,這時網站就整個掛了。

步驟 10:看卡住的狀態

kubectl get replicaset; kubectl describe deployment web | grep -E 'Replicas:|StrategyType|RollingUpdateStrategy'
NAME             DESIRED   CURRENT   READY   AGE
web-544b69cccb   0         0         0       116s
web-56649cb68c   3         3         3       61s
web-c97647d7c    1         1         0       36s
Replicas:               3 desired | 1 updated | 4 total | 3 available | 1 unavailable
StrategyType:           RollingUpdate
RollingUpdateStrategy:  25% max unavailable, 25% max surge
三個 ReplicaSet:1.30 那版 0 個、1.31 那版 3 個、9.99 那版 1 個但 READY 0;describe 顯示 4 total、3 available、1 unavailable

Replicas: 3 desired | 1 updated | 4 total | 3 available | 1 unavailable:想要 3 個、1 個已換成新版、總共 4 個、3 個能用、1 個不能用。跟前面算的「最多 4 個、至少 3 個能用」完全一樣。下面兩行確認策略是 RollingUpdate、兩個參數都是預設的 25%。

步驟 11:一行指令回滾

kubectl rollout undo deployment/web; kubectl rollout status deployment/web; kubectl get pods -o custom-columns=NAME:.metadata.name,IMAGE:.spec.containers[0].image,STATUS:.status.phase
deployment.apps/web rolled back
deployment "web" successfully rolled out
NAME                   IMAGE        STATUS
web-56649cb68c-4crkv   nginx:1.31   Running
web-56649cb68c-8wjzq   nginx:1.31   Running
web-56649cb68c-s69fd   nginx:1.31   Running
web-c97647d7c-z9sm7    nginx:9.99   Pending
kubectl rollout undo 回到上一版,3 個 nginx:1.31 的 Pod Running,壞掉的 9.99 Pod 還在清理中

rollout undo 是回到上一個版本。回滾馬上就完成了,因為 1.31 的 3 個 Pod 本來就還在跑,只要把壞掉那個收掉就好。那個 9.99 的 Pod 還出現在清單上(phase 是 Pending,它從來沒成功跑起來過),是正在被清掉,過幾秒就會消失。

想回到更早的版本,可以加 --to-revision=版本號,版本號用 rollout history 查。

步驟 12:回滾後的版本歷史

kubectl rollout history deployment/web
deployment.apps/web
REVISION  CHANGE-CAUSE
1         nginx 1.30 first release
3         bad tag 9.99
4         upgrade to nginx 1.31
回滾後 rollout history 剩 1、3、4 三個版本,原本的第 2 版變成第 4 版

版本 2 不見了,多了一個版本 4,備註是 upgrade to nginx 1.31。回滾不是「倒退」,而是把舊版本的設定拿出來,當成最新的一版重新發布,所以它拿到新的號碼 4,原本的 2 就合併進去了。

步驟 13:舊教學的 –record 已經棄用

網路上很多教學用 --record 自動記錄變更原因,實際打一次看看:

kubectl set image deployment/web nginx=nginx:1.31 --record
Flag --record has been deprecated, --record will be removed in the future
deployment.apps/web image updated
kubectl set image 加 --record 跳出 Flag --record has been deprecated 的警告

deprecated(已棄用):還能用,但官方不建議,未來會移除。現在的做法就是步驟 6、7 用的 kubectl annotate ... kubernetes.io/change-cause=...,自己寫備註,內容也比較清楚。

Deployment 必學指令:scale 改數量、set image 換映像檔、rollout status 看進度、rollout history 列歷史、rollout undo 回上一版、annotate 寫 change-cause 備註

實測時的意外

1. 版本號會跳號

回滾之後 rollout history 從 1、2、3 變成 1、3、4,版本 2 消失。很多人以為 undo 會「回到第 2 版」,其實是「複製第 2 版的設定,發布成第 4 版」。所以看歷史時要看 CHANGE-CAUSE 備註,不要只看號碼。

2. rollout status 說成功時,壞掉的 Pod 還在

步驟 11 的 rollout status 已經印 successfully rolled out,但清單上還看得到 9.99 那個 Pod。因為 rollout status 看的是「想要的 Pod 都準備好了沒」,壞掉的那個只是還沒清完,過幾秒就不見了。

3. 沒加 –timeout 會一直等

rollout status 預設會一直等到更新完成。Deployment 有一個 progressDeadlineSeconds: 600(第 10 篇 -o yaml 看得到),代表 600 秒(10 分鐘)內沒有進展,Kubernetes 才會把這次更新標成失敗。寫在自動化流程(例如 Cloud Build)裡時,記得自己加 --timeout,不然壞掉的更新會讓流程卡 10 分鐘。

4. 指令擴出來的 Pod 被檔案蓋掉

步驟 4 用 kubectl scale 擴成 5 個,步驟 5 一 apply 檔案就變回 3 個。實際工作中最常見的情況是:值班工程師半夜手動擴容撐流量,隔天有人照 Git 裡的 YAML 部署新版,Pod 數量就被打回原形。要長期改數量,就改檔案;要自動依流量調整,用第 17 篇會教的 HPA。


用完記得刪

kubectl delete -f deployment.yaml; sleep 3; kubectl get all; minikube delete | tail -1
deployment.apps "web" deleted from default namespace
NAME                 TYPE        CLUSTER-IP   EXTERNAL-IP   PORT(S)   AGE
service/kubernetes   ClusterIP   10.96.0.1    <none>        443/TCP   2m36s
💀  Removed all traces of the "minikube" cluster.
kubectl delete -f 刪掉 Deployment,get all 只剩內建的 kubernetes Service,minikube delete 刪掉叢集

刪 Deployment 會連同底下所有 ReplicaSet 和 Pod 一起刪掉,get all 只剩叢集內建的 service/kubernetes。~/k8s-deploy/deployment.yaml 留在家目錄,第 13 篇講 Service 時可以接著用。


到了 GCP 上叫什麼

  • GKE:這份 deployment.yaml 不用改就能 apply 到 GKE,滾動更新、回滾的指令完全一樣。第 25 篇〈GKE 部署教學〉會實際搬過去
  • Cloud Run:沒有 Deployment 和 ReplicaSet,但概念很像。Cloud Run 每次部署會產生一個不能修改的「修訂版本(revision)」,回滾就是把流量切回舊的修訂版本,還可以「新版 10%、舊版 90%」慢慢切。第 20 篇:Cloud Run 是什麼?Cloud Run 教學:部署容器、版本與流量分割會實際做
概念Kubernetes DeploymentCloud Run
一個版本ReplicaSet(REVISION)修訂版本(Revision)
換版滾動更新部署新修訂版本,流量自動切過去
回滾kubectl rollout undo把流量切回舊的修訂版本
部分流量測試要另外設計(兩個 Deployment 或其他工具)內建流量分割

面試/證照會怎麼問

面試常見題

  • 「Deployment、ReplicaSet、Pod 是什麼關係?」:Deployment 管 ReplicaSet、ReplicaSet 維持 Pod 數量;每換一次版本,Deployment 建一個新的 ReplicaSet,舊的縮成 0 留著當回滾用
  • 「滾動更新怎麼運作?」:一次換幾個,由 maxSurge(最多多開幾個,進位)和 maxUnavailable(最多幾個不能用,捨去)決定;預設都是 25%
  • 「新版本有 bug 怎麼辦?」:kubectl rollout undo;要回到特定版本加 --to-revision
  • 「RollingUpdate 和 Recreate 差在哪?」:RollingUpdate 不停機但新舊版會同時存在;Recreate 先全關再全開,會斷線,適合新舊版不能共存的程式
  • 「換版時打錯映像檔名會怎樣?」:新 Pod 卡 ImagePullBackOff,舊 Pod 照跑(maxUnavailable 為 0 時一個都不會關),回滾就好

Kubernetes 證照(CKAD、CKA)

上機實作考(445 美元、2 小時,2026 年 11 月查 Linux Foundation 官方頁)。Deployment 常見題型:

  • 建一個 Deployment,指定映像檔和副本數(kubectl create deployment 加 --replicas,或 YAML)
  • 把映像檔換成新版本,並確認滾動更新完成(set image+rollout status)
  • 回滾到上一版或指定版本(rollout undo、--to-revision)
  • 調整 maxSurge、maxUnavailable 或改成 Recreate 策略(改 YAML 的 spec.strategy)

看到這些字,就想到這個

題目關鍵字想到
「無狀態應用」「維持固定數量」Deployment
「不停機更新」RollingUpdate
「先全部停掉再更新」Recreate
「回到上一版」kubectl rollout undo
「換版時最多多開幾個」maxSurge
「換版時最多幾個不能用」maxUnavailable
「記錄每一版改了什麼」kubernetes.io/change-cause 註記

常見問答

Deployment 和 ReplicaSet 有什麼不同?

ReplicaSet 只負責「保持剛好 N 個相同的 Pod」;Deployment 在它上面多了「換版本」和「回滾」。每換一次映像檔,Deployment 建一個新的 ReplicaSet,舊的縮成 0 個保留下來。實測換版後有兩個 ReplicaSet:舊的 544b69cccb 是 0 個、新的 56649cb68c 是 3 個。

滾動更新會讓網站斷線嗎?

預設設定下,換版過程一直保持設定的數量可以用。實測 3 個副本換版時,最多 4 個、至少 3 個可用,8.8 秒換完。要做到使用者完全無感,還需要搭配 Service 分流量(第 13 篇)和健康檢查 Probe(第 17 篇),讓流量只送給真的準備好的 Pod。

更新到一半失敗怎麼辦?

先看 kubectl get pods,新 Pod 卡在 ImagePullBackOff、CrashLoopBackOff 這類狀態時,舊 Pod 通常還在服務。接著 kubectl rollout undo deployment/名字 回到上一版。實測換成不存在的 nginx:9.99,舊的 3 個 Pod 一直 Running,undo 之後馬上恢復。

rollout history 的 CHANGE-CAUSE 是空的怎麼辦?

這欄來自 Deployment 上的 kubernetes.io/change-cause 註記。每次換版後用 kubectl annotate deployment 名字 kubernetes.io/change-cause='這次改了什麼' --overwrite 寫一行說明就好。舊教學用的 --record 實測會跳出 Flag --record has been deprecated 警告,不建議再用。

用 kubectl scale 還是改 YAML 檔?

臨時調整可以用 kubectl scale,但下次有人 kubectl apply -f 檔案時,數量會被改回檔案寫的值。實測擴到 5 個後再 apply 檔案,就變回 3 個。要長期改就改檔案;要依流量自動調整,用 HPA。

回滾後版本號為什麼跳號?

回滾是把舊版本的設定拿出來,當成最新的一版重新發布,所以會拿到一個新號碼,原本的號碼從歷史中消失。實測回滾前是 1、2、3,回滾後變成 1、3、4,版本 4 的備註就是原本版本 2 的「upgrade to nginx 1.31」。


重點整理

  • Deployment → ReplicaSet → Pod:Deployment 負責換版和回滾,ReplicaSet 負責維持數量;刪一個 Pod 實測 1 秒補回
  • 滾動更新的兩個數字:maxSurge(進位)、maxUnavailable(捨去),預設 25%;3 個副本時最多 4 個、至少 3 個可用,實測 4 total | 3 available
  • 換錯版本不會掛站:新 Pod 卡 ImagePullBackOff,舊的 3 個照跑;kubectl rollout undo 一行回滾
  • 用 annotate 寫 change-cause:--record 已棄用;回滾會產生新的版本號
  • 檔案是最後的依據:指令臨時擴的數量,apply 檔案後會被蓋掉

延伸閱讀

本系列

站上相關文章


Deployment 讓 Pod 可以自己補位、自己換版,下一步就是讓使用者連得到這群 Pod。如果你想有系統地從容器一路學到在 Google Cloud 上部署服務,可以看看東東的 GCP 課程,或加 LINE 聊聊你現在的狀況,一起找出最適合你的學習順序。

Table of Contents
返回頂端