3.12 访问Pod元数据

野性酷女 2022-12-15 12:54 119阅读 0赞

### 文章目录 ###

*  一、通过环境变量形式传递元数据
 *  二、通过Downward API传递元数据
 *  三、Downward API比环境变量优势

在 [ConfigMap][]和 [Secret][]章节中可知，可以通过ConfigMap和Secret向应用中传递Pod创建前可预先知道的数据，但不能传递Pod创建后未知的一些元数据，比如pod的名字，pod的ip，因为这些信息都是pod创建后才会知道，在创建pod时不可以通过ConfigMap和Secret传递数据，可以通过下列方式传递pod的一些元数据信息：环境变量和Downward API。  
Pod中可传递的元数据包括如下数据：

*  pod的名称
 *  pod的IP
 *  pod所在的命名空间
 *  pod运行节点的名称
 *  pod运行所归属的服务账户的名称
 *  每个容器请求的CPU和内存的使用量
 *  每个容器可以使用的CPU和内存的限制
 *  pod的标签
 *  pod的注解

# 一、通过环境变量形式传递元数据 #

可以通过环境变量方式把pod和容器的一些元数据信息传递到pod中的容器，在下面资源清单中通过环境变量形式向容器中传递元数据。

apiVersion: v1
    kind: Pod
    metadata:
      name: pod-env
    spec:
      containers:
      - name: busybox
        image: busybox
        imagePullPolicy: IfNotPresent
        command: ["sh", "-c", "sleep 3600"]
        resources:
          requests:
            cpu: 30m
            memory: 1Mi
          limits:
            cpu: 100m
            memory: 5Mi
        env:
        - name: POD_NAME
          valueFrom:
            fieldRef:
              fieldPath: metadata.name
        - name: POD_NAMESPACE
          valueFrom:
            fieldRef:
              fieldPath: metadata.namespace
        - name: POD_IP
          valueFrom:
            fieldRef:
              fieldPath: status.podIP
        - name: NODE_NAME
          valueFrom:
            fieldRef:
              fieldPath: spec.nodeName
        - name: SERVICE_ACCOUNT
          valueFrom:
            fieldRef:
              fieldPath: spec.serviceAccountName
        - name: REQUEST_CPU
          valueFrom:
            resourceFieldRef:
              resource: requests.cpu
              divisor: 1m
        - name: REQUEST_MEMORY
          valueFrom:
            resourceFieldRef:
              resource: requests.memory
              divisor: 1Mi
        - name: CPUT_LIMIT
          valueFrom:
            resourceFieldRef:
              resource: limits.cpu
              divisor: 1m
        - name: MEMORY_LIMIT
          valueFrom:
            resourceFieldRef:
              resource: limits.memory
              divisor: 1Mi

其中，1m表示1 millicore，即千分之一内核，30m表示千分之30内核；1Mi表示1兆

requests:
            cpu: 30m
            memory: 1Mi

通过上面创建pod后，进入pod中容器可以查看传入的元数据信息，如下所示

[root@k8s-master01 downward]# kubectl exec pod-env env
    PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
    HOSTNAME=pod-env
    MEMORY_LIMIT=5
    POD_IP=10.244.2.189
    NODE_NAME=k8s-node02
    REQUEST_MEMORY=1
    REQUEST_CPU=30
    CPUT_LIMIT=100
    POD_NAME=pod-env
    POD_NAMESPACE=default
    SERVICE_ACCOUNT=default
    MYSERVICE_PORT_8080_TCP_PORT=8080
    KUBERNETES_SERVICE_HOST=10.96.0.1
    KUBERNETES_SERVICE_PORT=443
    KUBERNETES_PORT_443_TCP_PORT=443
    MYSERVICE_SERVICE_HOST=10.106.129.199
    MYSERVICE_SERVICE_PORT=8080
    MYSERVICE_PORT_8080_TCP=tcp://10.106.129.199:8080
    KUBERNETES_PORT=tcp://10.96.0.1:443
    KUBERNETES_PORT_443_TCP=tcp://10.96.0.1:443
    KUBERNETES_PORT_443_TCP_ADDR=10.96.0.1
    KUBERNETES_PORT_443_TCP_PROTO=tcp
    MYSERVICE_SERVICE_PORT_HTTP=8080
    MYSERVICE_PORT_8080_TCP_PROTO=tcp
    KUBERNETES_SERVICE_PORT_HTTPS=443
    MYSERVICE_PORT=tcp://10.106.129.199:8080
    MYSERVICE_PORT_8080_TCP_ADDR=10.106.129.199
    HOME=/root

# 二、通过Downward API传递元数据 #

上述方式是通过环境变量形式把元数据传递到容器中，也可以通过文件卷的方式把元数据传递到容器中，即本节讲的Down可以ward API方式，把Downward API卷挂载到容器中。Downward API可以给Pod中运行的容器暴露pod的元数据，如下所示

apiVersion: v1
    kind: Pod
    metadata:
      name: mydownward
      labels:
        prod: dev
      annotations:
        description: this is description for downward
        date: 2020-10-18
    spec:
      containers:
      - name: busybox
        image: busybox
        imagePullPolicy: IfNotPresent
        command: ["sh", "-c", "sleep 3600"]
        resources:
          requests:
            cpu: 30m 
            memory: 1Mi 
          limits:
            cpu: 100m
            memory: 5Mi 
        volumeMounts:
        - name: downward
          mountPath: /etc/downward
      volumes:
      - name: downward
        downwardAPI:
          items:
          - path: podName
            fieldRef:
              fieldPath: metadata.name
          - path: podNamespace
            fieldRef:
              fieldPath: metadata.namespace
          - path: labels
            fieldRef:
              fieldPath: metadata.labels
          - path: annotations
            fieldRef:
              fieldPath: metadata.annotations
          - path: requst-cpu
            resourceFieldRef:
              containerName: busybox
              resource: requests.cpu
              divisor: 1m
          - path: limits-memory
            resourceFieldRef:
              containerName: busybox
              resource: limits.memory
              divisor: 1Mi

通过上述资源清单创建pod后，可以进入容器内部查看downward API挂在卷，发现annotations、labels等对象已经挂载到了容器中。

[root@k8s-master01 downward]# kubectl exec mydownward -it -- /bin/sh
    / # cd /etc/
    /etc # ls
    downward     group        hostname     hosts        localtime    mtab         network      passwd       resolv.conf  shadow
    /etc # cd downward
    /etc/downward # ls
    annotations    labels         limits-memory  podName        podNamespace   requst-cpu

# 三、Downward API比环境变量优势 #

**1、环境变量方式不可以暴露labels和annotations两种元数据，而Downward API可以；  
2、运行的pod修改标签和注解后，Downward API可以更新挂载卷中内容，获取最新修改的元数据，而环境变量的方式，标签和注解修改后，无法把新修改的值暴露到容器内部，所以环境变量方式不能传递标签和注解两种元数据。**

--------------------

*  *参考《kubenetes in action》*

[ConfigMap]: https://blog.csdn.net/u010502101/article/details/107872567
[Secret]: https://blog.csdn.net/u010502101/article/details/108090244