Kubernetes Downward API Concepts: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
Line 8: Line 8:


=Overview=
=Overview=
Kubernetes is exposing pod information to the containers running inside the pod through [[#File_Projection|files]] or environment variables, which are projected in the container by a mechanism known as the Downward API. Individual pieces of information are declared as "items" under a "downwardAPI" volume declaration, and the corresponding content will be projected as individual files in the pod filesystem.
Kubernetes is exposing pod information to the containers running inside the pod through [[#File_Projection|files]] or [[#Environment_Variable_Projection|environment variables]], which are projected in the container by a mechanism known as the Downward API. Individual pieces of information are declared as "items" under a "downwardAPI" volume declaration, and the corresponding content will be projected as individual files in the pod filesystem.


The pieces of information to expose can be read from [[#Pod|pods]] or [[#Container|containers]].
The pieces of information to expose can be read from [[#Pod|pods]] or [[#Container|containers]].

Revision as of 01:41, 19 June 2020

External

Internal

Overview

Kubernetes is exposing pod information to the containers running inside the pod through files or environment variables, which are projected in the container by a mechanism known as the Downward API. Individual pieces of information are declared as "items" under a "downwardAPI" volume declaration, and the corresponding content will be projected as individual files in the pod filesystem.

The pieces of information to expose can be read from pods or containers.

File Projection

This is how the pod name and namespace can be projected as files available to containers running inside the pod.

Declare a "downwardAPI" volume, conventionally named "podinfo" and mount it in the pod:

apiVersion: v1
kind: Pod
metadata:
  name: loop
spec:
  containers:
  - name: loop
    image: docker.io/ovidiufeodorov/loop:latest
    volumeMounts:
      - name: "podinfo"
        mountPath: "/etc/podinfo"
  volumes:
  - name: podinfo
    downwardAPI:
      items:
        - path: "metadata/name"
          fieldRef:
            fieldPath: "metadata.name"

Note that individual downwardAPI items can declare a hierarchical path - the directories will be created automatically.

Environment Variable Projection

Sources

Pod

Container