第9章 アプリケーションでの設定マップの使用

手順

• configMapKeyRef セクションを使用して、Pod のこの ConfigMap のキーを使用できます。

  特定の環境変数を注入するように設定されている Pod 仕様のサンプル

  apiVersion: v1
  kind: Pod
  metadata:
    name: dapi-test-pod
  spec:
    securityContext:
      runAsNonRoot: true
      seccompProfile:
        type: RuntimeDefault
    containers:
      - name: test-container
        image: gcr.io/google_containers/busybox
        command: [ "/bin/sh", "-c", "env" ]
        env:
          - name: SPECIAL_LEVEL_KEY
            valueFrom:
              configMapKeyRef:
                name: special-config
                key: special.how
          - name: SPECIAL_TYPE_KEY
            valueFrom:
              configMapKeyRef:
                name: special-config
                key: special.type
                optional: true
        envFrom:
          - configMapRef:
              name: env-config
        securityContext:
          allowPrivilegeEscalation: false
          capabilities:
            drop: [ALL]
    restartPolicy: Never

  各項目の説明:

  spec.containers.env

  config map から取得する環境変数を指定します。

  spec.containers.env.name

  キーの値を注入する Pod 環境変数の名前を指定します。

  spec.containers.env.valueFrom.configMapKeyRef.name

  特定の環境変数を取得する config map の名前を指定します。

  spec.containers.env.valueFrom.configMapKeyRef.key

  config map から取得する環境変数を指定します。

  spec.containers.env.valueFrom.configMapKeyRef.optional

  環境変数が省略可能であることを指定します。オプションとして、指定された config map とキーが存在しない場合でも、Pod は起動されます。

  spec.containers.envFrom.configMapRef

  環境変数をすべて取得する config map の名前を指定します。

  この Pod が実行されると、Pod のログには以下の出力が含まれます。

  SPECIAL_LEVEL_KEY=very
  log_level=INFO

  注記

  SPECIAL_TYPE_KEY=charm は出力例にリスト表示されません。optional: true が設定されているためです。

手順

• コンテナー内のコマンドに値を注入するには、環境変数として使用するキーを使用する必要があります。次に、$(VAR_NAME) 構文を使用してコンテナーのコマンドでそれらを参照することができます。

  特定の環境変数を注入するように設定されている Pod 仕様のサンプル

  apiVersion: v1
  kind: Pod
  metadata:
    name: dapi-test-pod
  spec:
    securityContext:
      runAsNonRoot: true
      seccompProfile:
        type: RuntimeDefault
    containers:
      - name: test-container
        image: gcr.io/google_containers/busybox
        command: [ "/bin/sh", "-c", "echo $(SPECIAL_LEVEL_KEY) $(SPECIAL_TYPE_KEY)" ]
        env:
          - name: SPECIAL_LEVEL_KEY
            valueFrom:
              configMapKeyRef:
                name: special-config
                key: special.how
          - name: SPECIAL_TYPE_KEY
            valueFrom:
              configMapKeyRef:
                name: special-config
                key: special.type
        securityContext:
          allowPrivilegeEscalation: false
          capabilities:
            drop: [ALL]
    restartPolicy: Never

  各項目の説明:

  spec.containers.command

  環境変数として使用するキーで、コンテナー内のコマンドに注入する値を指定します。

  この Pod が実行されると、test-container コンテナーで実行される echo コマンドの出力は以下のようになります。

  very charm

手順

• config map を使用してコンテンツをボリュームに注入するための最も基本的な方法は、キーがファイル名であり、ファイルの内容がキーの値になっているファイルでボリュームを設定する方法です。

  apiVersion: v1
  kind: Pod
  metadata:
    name: dapi-test-pod
  spec:
    securityContext:
      runAsNonRoot: true
      seccompProfile:
        type: RuntimeDefault
    containers:
      - name: test-container
        image: gcr.io/google_containers/busybox
        command: [ "/bin/sh", "-c", "cat", "/etc/config/special.how" ]
        volumeMounts:
        - name: config-volume
          mountPath: /etc/config
        securityContext:
          allowPrivilegeEscalation: false
          capabilities:
            drop: [ALL]
    volumes:
      - name: config-volume
        configMap:
          name: special-config
    restartPolicy: Never

  各項目の説明:

  spec.volumes.configMap.name

  キーを含むファイルを指定します。

  この Pod が実行されると、cat コマンドの出力は以下のようになります。

  very

• 設定マップキーが投影されるボリューム内のパスを制御することもできます。

  apiVersion: v1
  kind: Pod
  metadata:
    name: dapi-test-pod
  spec:
    securityContext:
      runAsNonRoot: true
      seccompProfile:
        type: RuntimeDefault
    containers:
      - name: test-container
        image: gcr.io/google_containers/busybox
        command: [ "/bin/sh", "-c", "cat", "/etc/config/path/to/special-key" ]
        volumeMounts:
        - name: config-volume
          mountPath: /etc/config
        securityContext:
          allowPrivilegeEscalation: false
          capabilities:
            drop: [ALL]
    volumes:
      - name: config-volume
        configMap:
          name: special-config
          items:
          - key: special.how
            path: path/to/special-key
    restartPolicy: Never

  各項目の説明:

  spec.volumes.configMap.items.path

  config map キーへのパスを指定します。

  この Pod を実行すると、cat コマンドの出力は very です。