返回列表

AWS國際企業帳號 Kubernetes Deployment 實戰:實現應用部署與滾動更新

亞馬遜雲AWS / 2026-10-21 15:54:14

# 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 啟動失敗、更新卡住、服務無流量等問題時,處理會快很多。

Telegram售前客服
客服ID
@cloudcup
联系
Telegram售后客服
客服ID
@yanhuacloud
联系