通过文件将Pod信息呈现给容器
此页面描述Pod如何使用DownwardAPIVolumeFile把自己的信息呈现给pod中运行的容器。DownwardAPIVolumeFile可以呈现pod的字段和容器字段。
- 准备开始
- Downward API
- 存储Pod字段
- 存储容器字段
- Capabilities of the Downward API
- 投射密钥到指定路径并且指定文件权限
- Downward API的动机
- 接下来
准备开始
你必须拥有一个 Kubernetes 的集群,同时你的 Kubernetes 集群必须带有 kubectl 命令行工具。 如果你还没有集群,你可以通过 Minikube 构建一 个你自己的集群,或者你可以使用下面任意一个 Kubernetes 工具构建:
要获知版本信息,请输入 kubectl version
.
Downward API
有两种方式可以将Pod和Container字段呈现给运行中的容器:
- 环境变量
- DownwardAPIVolumeFile
这两种呈现Pod和Container字段的方式都称为*Downward API*。
存储Pod字段
在这个练习中,你将创建一个包含一个容器的pod。这是该pod的配置文件:
pods/inject/dapi-volume.yaml
|
---|
|
在配置文件中,你可以看到Pod有一个downwardAPI
类型的Volume,并且挂载到容器中的/etc
。
查看downwardAPI
下面的items
数组。每个数组元素都是一个DownwardAPIVolumeFile。
第一个元素指示Pod的metadata.labels
字段的值保存在名为labels
的文件中。
第二个元素指示Pod的annotations
字段的值保存在名为annotations
的文件中。
注意: 本示例中的字段是Pod字段,不是Pod中容器的字段。
创建 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/labels
输出显示Pod的所有labels都已写入labels
文件。
cluster="test-cluster1"
rack="rack-22"
zone="us-est-coast"
同样,查看annotations
文件:
/# cat /etc/annotations
查看/etc
目录下的文件:
/# ls -laR /etc
在输出中可以看到,labels
和 annotations
文件都在一个临时子目录中:这个例子,..2019_12_05_07_00_34.813117769
。在/etc
目录中,..data
是一个指向临时子目录
的符号链接。/etc
目录中,labels
和 annotations
也是符号链接。
/etc/podinfo # ls -alRL
.:
total 8
drwxrwxrwt 3 root root 120 Dec 5 07:00 .
drwxr-xr-x 1 root root 21 Dec 5 07:00 ..
drwxr-xr-x 2 root root 80 Dec 5 07:00 ..2019_12_05_07_00_34.813117769
drwxr-xr-x 2 root root 80 Dec 5 07:00 ..data
-rw-r--r-- 1 root root 1123 Dec 5 07:00 annotations
-rw-r--r-- 1 root root 39 Dec 5 07:00 labels
./..2019_12_05_07_00_34.813117769:
total 8
drwxr-xr-x 2 root root 80 Dec 5 07:00 .
drwxrwxrwt 3 root root 120 Dec 5 07:00 ..
-rw-r--r-- 1 root root 1123 Dec 5 07:00 annotations
-rw-r--r-- 1 root root 39 Dec 5 07:00 labels
./..data:
total 8
drwxr-xr-x 2 root root 80 Dec 5 07:00 .
drwxrwxrwt 3 root root 120 Dec 5 07:00 ..
-rw-r--r-- 1 root root 1123 Dec 5 07:00 annotations
-rw-r--r-- 1 root root 39 Dec 5 07:00 labels
用符号链接可实现元数据的动态原子刷新;更新将写入一个新的临时目录,然后..data
符号链接完成原子更新,通过使用rename(2)。
退出shell:
/# exit
存储容器字段
前面的练习中,你将Pod字段保存到DownwardAPIVolumeFile中。接下来这个练习,你将存储容器字段。这里是包含一个容器的pod的配置文件:
pods/inject/dapi-volume-resources.yaml
|
---|
|
在这个配置文件中,你可以看到Pod有一个downwardAPI
类型的Volume,并且挂载到容器的/etc
目录。
查看downwardAPI
下面的items
数组。每个数组元素都是一个DownwardAPIVolumeFile。
第一个元素指定名为client-container
的容器中limits.cpu
字段的值应保存在名为cpu_limit
的文件中。
创建Pod:
kubectl apply -f https://k8s.io/examples/pods/inject/dapi-volume-resources.yaml
进入Pod中运行的容器,打开一个shell:
kubectl exec -it kubernetes-downwardapi-volume-example-2 -- sh
在shell中,查看cpu_limit
文件:
/# cat /etc/cpu_limit
你可以使用同样的命令查看cpu_request
, mem_limit
和mem_request
文件.
Capabilities of the Downward API
下面这些信息可以通过环境变量和DownwardAPIVolumeFiles提供给容器:
能通过fieldRef
获得的:
* metadata.name
- Pod名称
* metadata.namespace
- Pod名字空间
* metadata.uid
- Pod的UID, 版本要求 v1.8.0-alpha.2
* metadata.labels['<KEY>']
- 单个 pod 标签值 <KEY>
(例如, metadata.labels['mylabel']
); 版本要求 Kubernetes 1.9+
* metadata.annotations['<KEY>']
- 单个 pod 的标注值 <KEY>
(例如, metadata.annotations['myannotation']
); 版本要求 Kubernetes 1.9+
能通过resourceFieldRef
获得的:
* 容器的CPU约束值
* 容器的CPU请求值
* 容器的内存约束值
* 容器的内存请求值
* 容器的临时存储约束值, 版本要求 v1.8.0-beta.0
* 容器的临时存储请求值, 版本要求 v1.8.0-beta.0
此外,以下信息可通过DownwardAPIVolumeFiles从fieldRef
获得:
metadata.labels
- all of the pod’s labels, formatted aslabel-key="escaped-label-value"
with one label per linemetadata.annotations
- all of the pod’s annotations, formatted asannotation-key="escaped-annotation-value"
with one annotation per linemetadata.labels
- 所有Pod的标签,以label-key="escaped-label-value"
格式显示,每行显示一个labelmetadata.annotations
- Pod的注释,以annotation-key="escaped-annotation-value"
格式显示,每行显示一个标签
以下信息可通过环境变量从fieldRef
获得:
status.podIP
- 节点IPspec.serviceAccountName
- Pod服务帐号名称, 版本要求 v1.4.0-alpha.3spec.nodeName
- 节点名称, 版本要求 v1.4.0-alpha.3status.hostIP
- 节点IP, 版本要求 v1.7.0-alpha.1
注意: 如果容器未指定CPU和memory limits,则Downward API默认为节点可分配值。
投射密钥到指定路径并且指定文件权限
你可以将密钥投射到指定路径并且指定每个文件的访问权限。更多信息,请参阅Secrets.
Downward API的动机
对于容器来说,有时候拥有自己的信息是很有用的,可避免与Kubernetes过度耦合。Downward API使得容器使用自己或者集群的信息,而不必通过Kubernetes客户端或API服务器。
一个例子是有一个现有的应用假定要用一个非常熟悉的环境变量来保存一个唯一标识。一种可能是给应用增加处理层,但这样是冗余和易出错的,而且它违反了低耦合的目标。更好的选择是使用Pod名称作为标识,把Pod名称注入这个环境变量中。
接下来
反馈
此页是否对您有帮助?
感谢反馈。如果您有一个关于如何使用 Kubernetes 的特定的、需要答案的问题,可以访问 Stack Overflow. 在 GitHub 仓库上登记新的问题 报告问题 或者 提出改进建议.