这两种呈现 Pod 和 Container 字段的方式统称为 Downward API。
一、通过环境变量将 Pod 信息传递给容器
在文章开始之前,我们先在目录 pods/inject/dapi-envars-pod.yaml
中创建一个包含一个容器的 Pod。这是该 Pod 的配置文件:
apiVersion: v1
kind: Pod
metadata:
name: dapi-envars-fieldref
spec:
containers:
- name: test-container
image: k8s.gcr.io/busybox
command: [ "sh", "-c"]
args:
- while true; do
echo -en '\n';
printenv MY_NODE_NAME MY_POD_NAME MY_POD_NAMESPACE;
printenv MY_POD_IP MY_POD_SERVICE_ACCOUNT;
sleep 10;
done;
env:
- name: MY_NODE_NAME
valueFrom:
fieldRef:
fieldPath: spec.nodeName
- name: MY_POD_NAME
valueFrom:
fieldRef:
fieldPath: metadata.name
- name: MY_POD_NAMESPACE
valueFrom:
fieldRef:
fieldPath: metadata.namespace
- name: MY_POD_IP
valueFrom:
fieldRef:
fieldPath: status.podIP
- name: MY_POD_SERVICE_ACCOUNT
valueFrom:
fieldRef:
fieldPath: spec.serviceAccountName
restartPolicy: Never
这个配置文件中,你可以看到五个环境变量。env 字段是一个 EnvVars.
对象的数组。 数组中第一个元素指定 MY_NODE_NAME 这个环境变量从 Pod 的 spec.nodeName
字段获取变量值。 同样,其它环境变量也是从 Pod 的字段获取它们的变量值。
- 创建Pod:
$ kubectl apply -f https://k8s.io/examples/pods/inject/dapi-envars-pod.yaml
- 验证 Pod 中的容器运行正常:
$ kubectl get pods
- 查看容器日志:
$ kubectl logs dapi-envars-fieldref
- 输出信息显示了所选择的环境变量的值:
minikube
dapi-envars-fieldref
default
172.17.0.4
default
要了解为什么这些值在日志中,请查看配置文件中的command 和 args字段。 当容器启动时,它将五个环境变量的值写入 stdout。每十秒重复执行一次。
接下来,通过打开一个 Shell 进入 Pod 中运行的容器:
$ kubectl exec -it dapi-envars-fieldref -- sh
在 Shell 中,查看环境变量:
/# printenv
输出信息显示环境变量已经设置为 Pod 字段的值。
MY_POD_SERVICE_ACCOUNT=default
…
MY_POD_NAMESPACE=default
MY_POD_IP=172.17.0.4
…
MY_NODE_NAME=minikube
…
MY_POD_NAME=dapi-envars-fieldref
1.1、用 Container 字段作为环境变量的值
上面我们将 Pod 字段作为环境变量的值。 现在我们将用 Container 字段作为环境变量的值。在目录 pods/inject/dapi-envars-container.yaml
中创建一个包含容器的 Pod 的配置文件:
spec:
containers:
- name: test-container
image: k8s.gcr.io/busybox:1.24
command: [ "sh", "-c"]
args:
- while true; do
echo -en '\n';
printenv MY_CPU_REQUEST MY_CPU_LIMIT;
printenv MY_MEM_REQUEST MY_MEM_LIMIT;
sleep 10;
done;
resources:
requests:
memory: "32Mi"
cpu: "125m"
limits:
memory: "64Mi"
cpu: "250m"
env:
- name: MY_CPU_REQUEST
valueFrom:
resourceFieldRef:
containerName: test-container
resource: requests.cpu
- name: MY_CPU_LIMIT
valueFrom:
resourceFieldRef:
containerName: test-container
resource: limits.cpu
- name: MY_MEM_REQUEST
valueFrom:
resourceFieldRef:
containerName: test-container
resource: requests.memory
- name: MY_MEM_LIMIT
valueFrom:
resourceFieldRef:
containerName: test-container
resource: limits.memory
restartPolicy: Never
这个配置文件中,你可以看到四个环境变量。env 字段是一个 EnvVars.
对象的数组。数组中第一个元素指定 MY_CPU_REQUEST 这个环境变量从 Container 的 requests.cpu
字段获取变量值。同样,其它环境变量也是从 Container 的字段获取它们的变量值。
- 创建Pod:
$ kubectl apply -f https://k8s.io/examples/pods/inject/dapi-envars-container.yaml
- 验证 Pod 中的容器运行正常:
$ kubectl get pods
- 查看容器日志:
$ kubectl logs dapi-envars-resourcefieldref
- 输出信息显示了所选择的环境变量的值:
1
1
33554432
67108864
二、通过文件将 Pod 信息呈现给容器
前面我们学习了使用环境变量的方式,现在我们学习通过文件的方式。
在目录 pods/inject/dapi-volume.yaml
中创建一个包含一个容器的 Pod,并将 Pod 级别的字段作为文件映射到正在运行的容器中。 Pod 的清单如下:
apiVersion: v1
kind: Pod
metadata:
name: kubernetes-downwardapi-volume-example
labels:
zone: us-est-coast
cluster: test-cluster1
rack: rack-22
annotations:
build: two
builder: john-doe
spec:
containers:
- name: client-container
image: k8s.gcr.io/busybox
command: ["sh", "-c"]
args:
- while true; do
if [[ -e /etc/podinfo/labels ]]; then
echo -en '\n\n'; cat /etc/podinfo/labels; fi;
if [[ -e /etc/podinfo/annotations ]]; then
echo -en '\n\n'; cat /etc/podinfo/annotations; fi;
sleep 5;
done;
volumeMounts:
- name: podinfo
mountPath: /etc/podinfo
volumes:
- name: podinfo
downwardAPI:
items:
- path: "labels"
fieldRef:
fieldPath: metadata.labels
- path: "annotations"
fieldRef:
fieldPath: metadata.annotations
在 Pod 清单中,你可以看到 Pod 有一个 downwardAPI 类型的卷,并且挂载到容器中的 /etc/podinfo 目录。
查看 downwardAPI 下面的 items 数组。 数组的每个元素定义一个 downwardAPI 卷。 第一个元素指示 Pod 的 metadata.labels 字段的值保存在名为 labels 的文件中。 第二个元素指示 Pod 的 annotations 字段的值保存在名为 annotations 的文件中。
- 创建 Pod:
$ kubectl apply -f https://k8s.io/examples/pods/inject/dapi-volume.yaml
- 验证Pod中的容器运行正常:
$ kubectl get pods
- 查看容器的日志:
$ kubectl logs kubernetes-downwardapi-volume-example
- 输出显示 labels 和 annotations 文件的内容:
cluster=“test-cluster1”
rack=“rack-22”
zone=“us-est-coast”build=“two”
builder=“john-doe”
- 进入 Pod 中运行的容器,打开一个 Shell:
$ kubectl exec -it kubernetes-downwardapi-volume-example -- sh
- 在该 Shell中,查看 labels 文件:
/# cat /etc/podinfo/labels
网上学习资料一大堆,但如果学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。
一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!
/# cat /etc/podinfo/labels
[外链图片转存中…(img-cqgCzIKW-1714263985536)]
[外链图片转存中…(img-mMLHI0ar-1714263985536)]
网上学习资料一大堆,但如果学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。
一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!