Pod Sandbox 是什麼?看懂 pause 容器、CRI 沙盒與節點網路呼叫鏈

在 Kubernetes 節點內部,「建立 Pod 網路」的標準呼叫順序通常被概括為三步:kubelet 透過 CRI(Container Runtime Interface)要求 runtime 建立 Pod sandbox;runtime 在建立 sandbox 時呼叫 CNI(Container Network Interface)外掛程式;CNI 替 sandbox 建立網路介面、分配 IP 並接入 Pod 網路。

這條呼叫鏈看似條理分明,但其中最容易引發混淆的關鍵詞正是 Pod sandbox。它在文件與日常討論中常呈現多重面貌:有時是抽象介面,有時是 gRPC API 物件,有時又被具象化為節點上神秘的 pause 容器。


PodSandbox 首先是 CRI 的 API 規格物件

從架構本質來看,sandbox 最初是一個介面概念,具體落實為一份 gRPC API 契約,最後才由各 container runtime 提供底層實作。

2016 年 CRI 公告中給出了原始定義:

A Pod is composed of a group of application containers in an isolated environment with resource constraints. In CRI, this environment is called PodSandbox.

換言之,CRI 規範將「受隔離且具備資源限制的執行環境」正式命名為 Pod sandbox。

CRI 的 Protocol Buffers API 主要劃分為兩個 gRPC 服務:ImageService 負責映像檔拉取與管理,RuntimeService 則負責 Pod 與容器的完整生命週期管理,包含 exec、attach 與 port-forward 等互動通道。

在 RuntimeService 中,sandbox 是具備獨立生命週期的一等公民,擁有一組專屬的 RPC 介面:

為什麼 CRI 在 API 設計上強制遵循「先建沙盒、後建容器」的順序?因為在 CreateContainer 的請求結構中,第一項必要欄位就是 pod_sandbox_id(「ID of the PodSandbox in which the container should be created」)。

這項約束背後有明確的技術相依性:業務容器行程需要加入的 network namespace、需要綁定的 pod-level cgroup,以及 Pod 專屬的 IP 位址,都必須在沙盒階段就緒,後續容器才能正常啟動。

這個順序也反映在 Pod 的狀態條件上。Pod condition 中的 PodReadyToStartContainers 定義為「the Pod sandbox has been successfully created, networking configured, storage volumes mounted…」。唯有沙盒與基礎網路到位,Pod 才算進入可承載業務容器的就緒狀態。


抽象規範與底層實體:官方設計的「刻意留白」

既然 sandbox 在 API 層是抽象規範,那它在底層究竟是容器、虛擬機器,還是其他機制?CRI 設計者在最初的設計公告中便指明:

We intentionally leave some room for the container runtimes to interpret the PodSandbox differently based on how they operate internally. For hypervisor-based runtimes, PodSandbox might represent a virtual machine. For others, such as Docker, it might be Linux namespaces.

這項設計原則至今依舊有效。

目前 Kubernetes Pod 生命週期文件在描述沙盒異常重啟時,仍然明確涵蓋 VM 情境:「for container runtimes that use virtual machines for isolation, the Pod sandbox virtual machine rebooting, which then requires creating a new sandbox and fresh container network configuration.」

因此,直接將「Pod sandbox」等同於「pause 容器」並不精確。pause 容器只是沙盒在 Linux 容器型 runtime(如 containerd、CRI-O)上的實作方式,而非 sandbox 的通用定義。

定義本身是「Pod 層級的隔離環境」這個介面位置;至於這個位置由 Linux namespace 或微型虛擬機器填補,完全交由底層 runtime 決定。

  1. CRI Interface: PodSandbox
    1. Linux Namespace / cgroupcontainerd / CRI-O
    1. Sandboxed RuntimeKata / gVisor

Linux 節點實體:pause 容器的解剖與原始碼

在 Linux 節點主流的 containerd 或 CRI-O 環境中,sandbox 的實體通常就是 pause 容器。

當 kubelet 呼叫 RunPodSandbox 時,containerd 內部會先建立 Pod 專屬的 network namespace,透過 CNI 完成網路設定,接著在 Pod 的 cgroup 與 namespace 中啟動一個專門的 pause 容器作為沙盒容器。

pause 容器的原始程式碼極度精簡,位於 Kubernetes 儲存庫的 build/pause/linux/pause.c。它的主函式核心即是呼叫 Unix 系統呼叫 pause(2) 讓行程進入休眠,直到接收到系統訊號為止。雖然程式碼短小,但它承擔了關鍵的系統級職責:

1. Namespace 與 cgroup 的生命週期錨點(核心職責)

Linux 核心的規則是:只要仍有行程在某個 network namespace 內運作,該 namespace 就不會被核心銷毀。

CNI 在建立並設定好 Pod 網路後,pause 容器進駐並持續運作,將該 network namespace「錨定」在記憶體中。後續建立的業務容器只需加入該 namespace,便能天然共享相同的網路堆疊、IP 與 localhost 網路環境。

2. PID 1 代理與 Zombie 行程回收(條件生效)

社群中常有「pause 容器完全不做事」的說法。嚴格來說,pause 預設確實以休眠為核心;但檢視 pause.c 原始程式碼,會發現它內建註冊了 SIGCHLD handler:

static void sigreap(int signo) {
  while (waitpid(-1, NULL, WNOHANG) > 0)
    ;
}

這個非阻塞的回收迴圈只在特定情境下發揮作用。在預設情況下,Pod 內各容器各自擁有獨立的 PID namespace,應用程式自行擔任 PID 1。

唯有在 Pod 規格中啟用 shareProcessNamespace: true 時,全 Pod 容器才會共享同一個行程空間。此時 pause 接管整個 Pod 的 PID 1,在收到 SIGCHLD 訊號時及時回收殘留的殭屍行程(zombie process)。


節點網路呼叫鏈的時序與演進

在了解 pause 如何在 Linux 核心層錨定 namespace 後,我們把視角拉回節點元件層級,檢視由 RunPodSandbox 驅動的完整網路呼叫時序:

 Kubelet          Runtime (containerd)     CNI
    |                      |                |
    | 1. RunPodSandbox     |                |
    |--------------------->|                |
    |                      |                |
    |                      |--+ 2. Create   |
    |                      |  |    netns    |
    |                      |<-+             |
    |                      |                |
    |                      | 3. CNI ADD     |
    |                      |--------------->|
    |                      |                |
    |                      |                |--+ 4. Setup
    |                      |                |  |    veth/IP
    |                      |                |<-+
    |                      |                |
    |                      | 5. Return IP   |
    |                      |<---------------|
    |                      |                |
    |                      |--+ 6. Launch   |
    |                      |  |    pause    |
    |                      |<-+             |
    |                      |                |
    | 7. SANDBOX_READY     |                |
    |<---------------------|                |
    |                      |                |
    | 8. CreateContainer   |                |
    |--------------------->|                |
    |                      |                |
    |                      |--+ 9. App      |
    |                      |  |    joins    |
    |                      |<-+             |

這條時序圖印證了三個關鍵事實:

  1. kubelet 透過 CRI 請求 runtime 建立 sandbox:kubelet 透過 gRPC 發起 RunPodSandbox,不直接介入具體的網路裝置操作。
  2. 由 runtime 呼叫 CNI:在 Kubernetes 1.24 移除 dockershim 之前,kubelet 曾透過 --cni-bin-dir 與 --network-plugin 自行呼叫 CNI;自 1.24 起,CNI 的管理責任完全收斂至 CRI runtime 內部。
  3. IP 位址隸屬於 sandbox:CNI 建立虛擬網路卡(veth pair)並配發 IP 後,IP 資訊記錄在 CRI 的 PodSandboxNetworkStatus 中。業務容器本身沒有獨立的 IP,所有容器看到的 eth0 與 IP 都來自所加入的沙盒 network namespace。

若 Pod 設定了 hostNetwork: true,runtime 將直接共用節點的 network namespace,此時不觸發 CNI 呼叫,沙盒的網路狀態在 API 層會被忽略,Pod IP 即等同於節點 IP。


生命週期與節點故障排除:當 Sandbox 損毀時

在正常的終止流程中,kubelet 依序停止業務容器,隨後發起 StopPodSandbox(觸發 CNI DEL 回收網路與 IP 資源),最後呼叫 RemovePodSandbox 清理沙盒結構。

沙盒崩潰與重建機制

若節點發生非預期重啟,或底層虛擬機器沙盒損毀,kubelet 偵測到沙盒失效後會將 PodReadyToStartContainers 置為 False,並啟動全新沙盒。

沙盒重建意味著整個 Pod 的基礎環境完全重置:現存業務容器將被全數銷毀,CNI 重新執行網路設定,Pod IP 通常也會重新配發(除非底層 CNI 具備固定 IP 策略)。在 CRI 中,PodSandboxMetadata.attempt 序號會隨每次重建而遞增。

觀察面向:crictl 與 kubectl 的視角差異

在查修網路或啟動異常時,需要清楚兩層工具的觀察點差異:

# 1. 檢查節點上所有沙盒的運行狀態與重建次數 (ATTEMPT)
crictl pods

# 2. 檢視特定沙盒的網路配置與 IP 分配細節
crictl inspectp <sandbox-id>

# 3. 檢查叢集層回報的 Pod Conditions 與 Pod IP
kubectl describe pod <pod-name>
kubectl get pod <pod-name> -o jsonpath='{.status.podIP}'

當 Pod 長時間卡在 ContainerCreating 且事件日誌提示網路設定逾時,問題通常出在 RunPodSandbox 階段的 CNI 外掛程式呼叫或 IPAM(IP Address Management)配發 IP 失敗,應優先到節點上透過 crictl pods 與 runtime 日誌進行診斷。


名詞辨析:CRI 沙盒與安全隔離沙盒

在雲原生領域中,「sandbox」一詞常出現在不同的技術層級,主要區分為以下兩種範疇:

比較面向CRI PodSandbox(本文主題)Sandboxed Runtime(安全隔離)
核心定位Kubernetes 資源聚合與生命週期錨點增強型工作負載安全防禦邊界
技術實作Linux Namespaces、cgroups 或 pause 容器使用者空間核心(gVisor / runsc)或輕量微型 VM(Kata Containers)
接入層級CRI RuntimeService 核心規範透過 Kubernetes RuntimeClass 指定 handler
主要目的讓同 Pod 多容器共享網路與各項資源攔截敏感系統呼叫,防止容器逃逸與多租戶干擾

引入 gVisor 或 Kata Containers 等安全沙盒技術時,只改變「填補 sandbox 位置的隔離技術」,並未更動 CRI 的 PodSandbox 抽象架構。

kubelet 的生命週期呼叫鏈與 RunPodSandbox 介面保持不變,維持了 Kubernetes 控制平面的高度一致性與擴充能力。