使用 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.local
、bar.local
解析為 127.0.0.1
,將 foo.remote
、bar.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 檔案,以確保無論使用哪種容器執行時,結果都符合預期。
注意
避免手動更改容器內的 hosts 檔案。
如果你手動更改 hosts 檔案,當容器退出時,這些更改將丟失。