使用 HostAliases 向 Pod /etc/hosts 文件添加条目

当 DNS 配置以及其它选项不合理的时候,通过向 Pod 的 /etc/hosts 文件中添加条目, 可以在 Pod 级别覆盖对主机名的解析。你可以通过 PodSpec 的 HostAliases 字段来添加这些自定义条目。

建议通过使用 HostAliases 来进行修改,因为该文件由 Kubelet 管理,并且 可以在 Pod 创建/重启过程中被重写。

默认 hosts 文件内容

让我们从一个 Nginx Pod 开始,该 Pod 被分配一个 IP:

  1. kubectl run nginx --image nginx --generator=run-pod/v1
  1. pod/nginx created

检查 Pod IP:

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

主机文件的内容如下所示:

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

默认情况下,hosts 文件只包含 IPv4 和 IPv6 的样板内容,像 localhost 和主机名称。

通过 HostAliases 增加额外条目

除了默认的样板内容,我们可以向 hosts 文件添加额外的条目。 例如,要将 foo.localbar.local 解析为 127.0.0.1, 将 foo.remotebar.remote 解析为 10.1.2.3,我们可以在 .spec.hostAliases 下为 Pod 配置 HostAliases。

  1. apiVersion: v1
  2. kind: Pod
  3. metadata:
  4. name: hostaliases-pod
  5. spec:
  6. restartPolicy: Never
  7. hostAliases:
  8. - ip: "127.0.0.1"
  9. hostnames:
  10. - "foo.local"
  11. - "bar.local"
  12. - ip: "10.1.2.3"
  13. hostnames:
  14. - "foo.remote"
  15. - "bar.remote"
  16. containers:
  17. - name: cat-hosts
  18. image: busybox
  19. command:
  20. - cat
  21. args:
  22. - "/etc/hosts"

你可以使用以下命令用此配置启动 Pod:

  1. kubectl apply -f hostaliases-pod.yaml
  1. pod/hostaliases-pod created

检查 Pod 详情,查看其 IPv4 地址和状态:

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

hosts 文件的内容看起来类似如下这样:

  1. kubectl logs hostaliases-pod
  1. # Kubernetes-managed hosts file.
  2. 127.0.0.1 localhost
  3. ::1 localhost ip6-localhost ip6-loopback
  4. fe00::0 ip6-localnet
  5. fe00::0 ip6-mcastprefix
  6. fe00::1 ip6-allnodes
  7. fe00::2 ip6-allrouters
  8. 10.200.0.5 hostaliases-pod
  9. # Entries added by HostAliases.
  10. 127.0.0.1 foo.local bar.local
  11. 10.1.2.3 foo.remote bar.remote

在最下面额外添加了一些条目。

为什么 kubelet 管理 hosts 文件?

kubelet 管理 Pod 中每个容器的 hosts 文件,避免 Docker 在容器已经启动之后去 修改 该文件。

注意:

请避免手工更改容器内的 hosts 文件内容。

如果你对 hosts 文件做了手工修改,这些修改都会在容器退出时丢失。

最后修改 July 01, 2021 at 3:08 PM PST : [zh]move HostAliases page to tasks (a5e12d04d)