使用 HostAliases 將條目新增到 Pod /etc/hosts

當 DNS 和其他選項不適用時,向 Pod 的 /etc/hosts 檔案新增條目可以提供 Pod 級別的hostname解析覆蓋。你可以使用 PodSpec 中的 HostAliases 欄位來新增這些自定義條目。

Kubernetes 專案建議使用 hostAliases 欄位(Pod .spec 的一部分)修改 DNS 配置,而不是使用 init 容器或其他方式直接編輯 /etc/hosts。透過其他方式進行的更改可能會在 Pod 建立或重啟期間被 kubelet 覆蓋。

預設 hosts 檔案內容

啟動一個 Nginx Pod,它被分配了一個 Pod IP

kubectl run nginx --image nginx
pod/nginx created

檢查 Pod IP

kubectl get pods --output=wide
NAME     READY     STATUS    RESTARTS   AGE    IP           NODE
nginx    1/1       Running   0          13s    10.200.0.4   worker0

hosts 檔案內容將如下所示

kubectl exec nginx -- cat /etc/hosts
# Kubernetes-managed hosts file.
127.0.0.1	localhost
::1	localhost ip6-localhost ip6-loopback
fe00::0	ip6-localnet
fe00::0	ip6-mcastprefix
fe00::1	ip6-allnodes
fe00::2	ip6-allrouters
10.200.0.4	nginx

預設情況下,hosts 檔案只包含 IPv4 和 IPv6 的樣板內容,如 localhost 及其自己的 hostname。

使用 hostAliases 新增額外條目

除了預設的樣板內容,你還可以向 hosts 檔案新增額外條目。例如:要將 foo.localbar.local 解析為 127.0.0.1,將 foo.remotebar.remote 解析為 10.1.2.3,你可以為 Pod 在 .spec.hostAliases 下配置 HostAliases。

apiVersion: v1
kind: Pod
metadata:
  name: hostaliases-pod
spec:
  restartPolicy: Never
  hostAliases:
  - ip: "127.0.0.1"
    hostnames:
    - "foo.local"
    - "bar.local"
  - ip: "10.1.2.3"
    hostnames:
    - "foo.remote"
    - "bar.remote"
  containers:
  - name: cat-hosts
    image: busybox:1.28
    command:
    - cat
    args:
    - "/etc/hosts"

你可以透過執行以下命令啟動一個使用該配置的 Pod

kubectl apply -f https://k8s.io/examples/service/networking/hostaliases-pod.yaml
pod/hostaliases-pod created

檢查 Pod 的詳細資訊以檢視其 IPv4 地址和狀態

kubectl get pod --output=wide
NAME                           READY     STATUS      RESTARTS   AGE       IP              NODE
hostaliases-pod                0/1       Completed   0          6s        10.200.0.5      worker0

hosts 檔案內容如下所示

kubectl logs hostaliases-pod
# Kubernetes-managed hosts file.
127.0.0.1	localhost
::1	localhost ip6-localhost ip6-loopback
fe00::0	ip6-localnet
fe00::0	ip6-mcastprefix
fe00::1	ip6-allnodes
fe00::2	ip6-allrouters
10.200.0.5	hostaliases-pod

# Entries added by HostAliases.
127.0.0.1	foo.local	bar.local
10.1.2.3	foo.remote	bar.remote

其中底部指定了額外的條目。

為什麼 kubelet 管理 hosts 檔案?

kubelet 管理 Pod 中每個容器的 hosts 檔案,以防止容器執行時在容器啟動後修改該檔案。歷史上,Kubernetes 總是使用 Docker Engine 作為其容器執行時,而 Docker Engine 會在每個容器啟動後修改 /etc/hosts 檔案。

當前的 Kubernetes 可以使用各種容器執行時;即便如此,kubelet 仍然管理每個容器內的 hosts 檔案,以確保無論使用哪種容器執行時,結果都符合預期。

最後修改時間:2024 年 10 月 3 日下午 4:50 PST:移除重複資訊 (05c1f011d4)