AWS國際企業帳號 Kubernetes Deployment 實戰:實現應用部署與滾動更新
# Kubernetes Deployment 實戰:實現應用部署與滾動更新
很多人搜尋這個主題,並不是想知道 Deployment 是什麼,而是想解決幾個實際問題:如何把應用部署到 Kubernetes、怎麼安全更新版本、更新失敗怎麼回滾、為什麼 Pod 一直起不來、服務更新時怎麼避免中斷。本文直接從操作出發,按建立資源、發布應用、滾動更新、驗證結果、故障排查的順序,完成一套可落地的 Deployment 實戰流程。
---
AWS國際企業帳號 ## 一、實際操作前,先明確你要解決的問題
在真實場景裡,使用者通常在以下幾步遇到問題:
1. **YAML 寫好了,但 Deployment 建立失敗**
2. **Pod 被建立了,但容器一直 CrashLoopBackOff**
3. **更新鏡像後,舊版本沒退出或新版本一直無法就緒**
4. **滾動更新過程中服務短暫不可用**
5. **更新後發現有問題,不知道怎麼回滾**
所以本文重點不是概念,而是:
- 如何編寫可用的 Deployment YAML
- 如何配置副本數、更新策略、探針與資源限制
- 如何執行滾動更新
- 如何檢查更新進度
- 如何快速回滾
- 如何排查部署失敗
---
## 二、開始前的環境準備
先確認本機能正常操作 Kubernetes 叢集:
```bash
kubectl version --client
kubectl get nodes
```
如果 `kubectl get nodes` 無法返回節點狀態,先處理 kubeconfig 或叢集連通性問題。
建議準備一個獨立 namespace,避免和其他業務資源混在一起:
```bash
kubectl create namespace demo-app
```
查看是否建立成功:
```bash
kubectl get ns
```
---
## 三、建立第一個 Deployment
下面以 Nginx 為例,先完成一個最小可用部署。
### 1. 建立 deployment.yaml
```yaml
apiVersion: apps/v1
kind: Deployment
metadata:
name: web-demo
namespace: demo-app
spec:
replicas: 3
selector:
matchLabels:
app: web-demo
strategy:
type: RollingUpdate
rollingUpdate:
maxSurge: 1
maxUnavailable: 1
template:
metadata:
labels:
app: web-demo
spec:
containers:
- name: nginx
image: nginx:1.25
ports:
- containerPort: 80
resources:
requests:
cpu: "100m"
memory: "128Mi"
limits:
cpu: "500m"
memory: "256Mi"
readinessProbe:
httpGet:
path: /
port: 80
initialDelaySeconds: 5
periodSeconds: 5
livenessProbe:
httpGet:
path: /
port: 80
initialDelaySeconds: 15
periodSeconds: 10
```
### 2. 套用配置
```bash
kubectl apply -f deployment.yaml
```
### 3. 查看部署狀態
```bash
kubectl get deployment -n demo-app
kubectl get pods -n demo-app -o wide
```
如果想持續觀察 Pod 啟動過程:
```bash
kubectl get pods -n demo-app -w
```
---
## 四、YAML 中最容易出錯的幾個位置
### 1. selector 和 labels 不一致
這是最常見錯誤之一。下面這兩處必須對應:
```yaml
selector:
matchLabels:
app: web-demo
```
和:
```yaml
template:
metadata:
labels:
app: web-demo
```
如果不一致,Deployment 會直接報錯或無法正確管理 Pod。
### 2. 鏡像名稱或標籤寫錯
例如:
```yaml
image: nginx:1.25
```
如果寫成不存在的 tag,Pod 會進入 `ImagePullBackOff`。
排查方式:
```bash
kubectl describe pod -n demo-app
```
重點查看 Events 區塊。
### 3. 探針配置過於激進
如果應用啟動慢,但 `readinessProbe` 或 `livenessProbe` 設定太早,容器會反覆被判定失敗。
例如 Java 應用、Python 大型服務、初始化依賴外部資料庫的應用,通常需要把 `initialDelaySeconds` 調大。
---
## 五、為 Deployment 暴露服務
只建立 Deployment 還不夠,通常還需要 Service 讓其他 Pod 或外部流量訪問。
AWS國際企業帳號 ### 1. 建立 service.yaml
```yaml
apiVersion: v1
kind: Service
metadata:
name: web-demo-svc
namespace: demo-app
spec:
selector:
app: web-demo
ports:
- protocol: TCP
port: 80
targetPort: 80
type: ClusterIP
```
套用:
```bash
kubectl apply -f service.yaml
```
查看:
```bash
kubectl get svc -n demo-app
```
### 2. 測試 Service 是否可用
可以臨時起一個測試 Pod:
```bash
kubectl run curl-test -n demo-app --image=curlimages/curl:8.5.0 --rm -it -- sh
```
在容器裡測試:
```bash
curl http://web-demo-svc
```
如果返回 Nginx 頁面內容,表示 Service 到 Pod 的流量正常。
---
## 六、Deployment 滾動更新實戰
實際工作中,Deployment 最大的用途就是版本更新。
### 1. 修改鏡像版本
例如把 Nginx 從 `1.25` 更新到 `1.25.3`:
```bash
kubectl set image deployment/web-demo nginx=nginx:1.25.3 -n demo-app
```
### 2. 觀察更新進度
```bash
kubectl rollout status deployment/web-demo -n demo-app
```
### 3. 查看 ReplicaSet 變化
```bash
kubectl get rs -n demo-app
```
你會看到新的 ReplicaSet 逐步增加,舊的 ReplicaSet 逐步減少,這就是滾動更新過程。
---
## 七、滾動更新參數怎麼設
Deployment 是否能平滑更新,關鍵看這兩個參數:
```yaml
strategy:
type: RollingUpdate
rollingUpdate:
maxSurge: 1
maxUnavailable: 1
```
### 1. maxSurge
表示更新過程中,最多可以比期望副本數多出多少 Pod。
AWS國際企業帳號 例如目前 `replicas: 3`,`maxSurge: 1`,更新時最多會有 4 個 Pod 同時存在。
### 2. maxUnavailable
表示更新過程中,最多允許多少 Pod 不可用。
如果你的服務不能接受流量明顯下降,這個值不要設太大。
### 3. 配置建議
#### 小型服務
AWS國際企業帳號 - replicas: 2~3
- maxSurge: 1
- maxUnavailable: 0 或 1
#### 生產流量服務
- replicas: 至少 3
- maxSurge: 25%
- maxUnavailable: 0
如果要求更新期間完全不掉流量,通常建議:
```yaml
rollingUpdate:
maxSurge: 1
maxUnavailable: 0
```
前提是叢集資源足夠,能先拉起新 Pod,再下線舊 Pod。
---
## 八、更新失敗時如何回滾
版本更新後,如果發現新 Pod 無法啟動,或業務驗證失敗,可以直接回滾。
### 1. 查看發布歷史
```bash
kubectl rollout history deployment/web-demo -n demo-app
```
### 2. 回滾到上一版本
```bash
kubectl rollout undo deployment/web-demo -n demo-app
```
AWS國際企業帳號 ### 3. 回滾到指定版本
```bash
kubectl rollout undo deployment/web-demo --to-revision=2 -n demo-app
```
### 4. 確認回滾結果
AWS國際企業帳號 ```bash
kubectl rollout status deployment/web-demo -n demo-app
kubectl get pods -n demo-app
```
如果你在更新後立刻發現錯誤,回滾通常是最快止損方式,不要一開始就手動改 YAML 再重新 apply,這樣會拖慢恢復速度。
---
## 九、實戰中常見的部署失敗排查方法
下面這部分是實際操作最常用的。
AWS國際企業帳號 ### 1. Pod 一直 Pending
先看 Pod 詳情:
```bash
kubectl describe pod -n demo-app
```
常見原因:
- 節點資源不足,CPU 或記憶體不夠
- PVC 沒綁定成功
- 節點選擇器或污點容忍設定不匹配
- 映像拉取 Secret 缺失
如果 Events 裡看到 `Insufficient cpu` 或 `Insufficient memory`,就要調小 requests,或增加節點資源。
AWS國際企業帳號 ### 2. Pod 一直 ImagePullBackOff
常見原因:
AWS國際企業帳號 - 鏡像名稱錯誤
- Tag 不存在
- 私有鏡像倉庫未配置拉取憑證
- 節點無法訪問鏡像倉庫
排查命令:
```bash
kubectl describe pod -n demo-app
```
AWS國際企業帳號 如果是私有倉庫,需配置 `imagePullSecrets`:
```yaml
spec:
imagePullSecrets:
- name: regcred
```
### 3. Pod 一直 CrashLoopBackOff
這類問題通常不是 Kubernetes 本身故障,而是容器內進程啟動失敗。
查看日誌:
```bash
kubectl logs -n demo-app
```
如果容器頻繁重啟,查看上一次啟動日誌:
```bash
kubectl logs -n demo-app --previous
```
常見原因:
AWS國際企業帳號 - 啟動命令錯誤
- 環境變數缺失
- 配置檔掛載錯誤
- 程式連不上資料庫或 Redis
- 監聽端口和探針端口不一致
### 4. Deployment 更新卡住
用下面命令看發布狀態:
```bash
kubectl rollout status deployment/web-demo -n demo-app
```
再結合:
```bash
kubectl get pods -n demo-app
kubectl describe pod -n demo-app
```
很多更新卡住,其實是新 Pod 沒通過 `readinessProbe`,導致 Deployment 不繼續替換舊 Pod。
### 5. Service 沒流量
先確認 Service selector 是否選中了正確 Pod:
```bash
kubectl get endpoints web-demo-svc -n demo-app
```
如果 endpoints 為空,通常有兩種可能:
- Service selector 寫錯
- Pod readiness probe 未通過,尚未加入服務端點
---
## 十、部署業務應用時的實用 YAML 範例
下面是一個更接近真實業務的 Deployment,包含環境變數、ConfigMap、滾動更新策略與資源限制。
```yaml
apiVersion: apps/v1
kind: Deployment
metadata:
name: myapp
namespace: demo-app
spec:
replicas: 3
revisionHistoryLimit: 5
selector:
matchLabels:
app: myapp
strategy:
type: RollingUpdate
rollingUpdate:
maxSurge: 1
maxUnavailable: 0
template:
metadata:
labels:
app: myapp
spec:
containers:
- name: myapp
image: myrepo/myapp:v1.0.0
ports:
- containerPort: 8080
env:
- name: SPRING_PROFILES_ACTIVE
value: prod
- name: TZ
value: Asia/Taipei
resources:
requests:
cpu: "200m"
memory: "256Mi"
limits:
cpu: "1"
memory: "512Mi"
readinessProbe:
httpGet:
path: /actuator/health
port: 8080
initialDelaySeconds: 20
periodSeconds: 5
timeoutSeconds: 2
failureThreshold: 6
livenessProbe:
httpGet:
path: /actuator/health
port: 8080
initialDelaySeconds: 60
periodSeconds: 10
timeoutSeconds: 2
failureThreshold: 3
```
這份配置適合大多數 HTTP 類應用作為起點,再依照實際啟動速度調整探針參數。
---
## 十一、部署時的最佳實踐
### 1. 不要直接使用 latest 標籤
錯誤示例:
```yaml
image: myrepo/myapp:latest
```
建議使用可追蹤版本:
```yaml
image: myrepo/myapp:v1.0.3
```
這樣回滾、排查、審計都更清晰。
### 2. 一定要配置 readinessProbe
沒有 readinessProbe,Pod 只要容器啟動就可能被加入流量,應用實際上還沒準備好,容易出現剛發布就報錯。
### 3. requests 不要亂填過大
很多 Pod 排程不上節點,不是應用真的需要那麼多資源,而是 requests 配太高。應先按實際壓測結果設定,再逐步調整。
### 4. 為回滾保留歷史版本
```yaml
revisionHistoryLimit: 5
```
如果設成太小,回滾歷史可能被清掉。
### 5. 先在測試 namespace 驗證再進生產
至少要先驗證:
- Pod 能正常啟動
- 探針能通過
- Service 能通
- 配置與 Secret 掛載正確
- 滾動更新與回滾可用
---
## 十二、常用命令清單
### 建立 Deployment
```bash
kubectl apply -f deployment.yaml
```
### 查看 Deployment
```bash
kubectl get deployment -n demo-app
kubectl describe deployment web-demo -n demo-app
```
### 查看 Pod
```bash
kubectl get pods -n demo-app -o wide
kubectl describe pod -n demo-app
```
### 查看日誌
```bash
kubectl logs -n demo-app
kubectl logs -n demo-app --previous
```
### 更新鏡像
```bash
kubectl set image deployment/web-demo nginx=nginx:1.25.3 -n demo-app
```
### 查看更新進度
```bash
kubectl rollout status deployment/web-demo -n demo-app
```
### 查看發布歷史
```bash
kubectl rollout history deployment/web-demo -n demo-app
```
### 回滾
```bash
kubectl rollout undo deployment/web-demo -n demo-app
```
### 擴容或縮容
```bash
kubectl scale deployment/web-demo --replicas=5 -n demo-app
```
---
## 十三、總結
Kubernetes Deployment 的核心工作不是「把 YAML 提交上去」這麼簡單,而是確保整個發布流程可控:
- 建立 Deployment 時,labels、selector、鏡像、探針要正確
- 對外提供服務時,要檢查 Service 與 endpoints 是否正常
- 做版本更新時,要合理設定 `maxSurge` 和 `maxUnavailable`
- 發布失敗時,要先看 `describe`、`logs`、`rollout status`
- 發現新版本異常時,優先使用 `rollout undo` 快速回滾
如果你正在實際部署業務系統,建議把本文中的 Deployment 範例改成你自己的鏡像、端口與健康檢查路徑,先在測試環境完整跑一遍建立、更新、回滾流程,再推到正式環境。這樣遇到 Pod 啟動失敗、更新卡住、服務無流量等問題時,處理會快很多。

