2.5. 設定マップの作成および使用

前提条件

• config map に追加するデータを含むファイルを含むディレクトリーが必要です。

  次の手順では、サンプルファイル game.properties および ui.properties を使用します。

  $ cat example-files/game.properties

  出力例

  enemies=aliens
  lives=3
  enemies.cheat=true
  enemies.cheat.level=noGoodRotten
  secret.code.passphrase=UUDDLRLRBABAS
  secret.code.allowed=true
  secret.code.lives=30

  $ cat example-files/ui.properties

  出力例

  color.good=purple
  color.bad=yellow
  allow.textmode=true
  how.nice.to.look=fairlyNice

手順

• 次のコマンドを入力して、このディレクトリー内の各ファイルの内容を保持する設定マップを作成します。

  $ oc create configmap game-config \
      --from-file=example-files/

検証

• -o オプションを使用してオブジェクトの oc get コマンドを入力し、キーの値を表示します。

  $ oc get configmaps game-config -o yaml

  出力例

  apiVersion: v1
  data:
    game.properties: |-
      enemies=aliens
      lives=3
      enemies.cheat=true
      enemies.cheat.level=noGoodRotten
      secret.code.passphrase=UUDDLRLRBABAS
      secret.code.allowed=true
      secret.code.lives=30
    ui.properties: |
      color.good=purple
      color.bad=yellow
      allow.textmode=true
      how.nice.to.look=fairlyNice
  kind: ConfigMap
  metadata:
    creationTimestamp: 2016-02-18T18:34:05Z
    name: game-config
    namespace: default
    resourceVersion: "407"
    selflink: /api/v1/namespaces/default/configmaps/game-config
    uid: 30944725-d66e-11e5-8cd0-68f728db1985

前提条件

• config map に追加するデータを含むファイルを含むディレクトリーが必要です。

  次の手順では、サンプルファイル game.properties および ui.properties を使用します。

  $ cat example-files/game.properties

  出力例

  enemies=aliens
  lives=3
  enemies.cheat=true
  enemies.cheat.level=noGoodRotten
  secret.code.passphrase=UUDDLRLRBABAS
  secret.code.allowed=true
  secret.code.lives=30

  $ cat example-files/ui.properties

  出力例

  color.good=purple
  color.bad=yellow
  allow.textmode=true
  how.nice.to.look=fairlyNice

手順

• 特定のファイルを指定して設定マップを作成します。

  $ oc create configmap game-config-2 \
      --from-file=example-files/game.properties \
      --from-file=example-files/ui.properties

• キーと値のペアを指定して、設定マップを作成します。

  $ oc create configmap game-config-3 \
      --from-file=game-special-key=example-files/game.properties

検証

• -o オプションを使用してオブジェクトの oc get コマンドを入力し、ファイルからキーの値を表示します。

  $ oc get configmaps game-config-2 -o yaml

  出力例

  apiVersion: v1
  data:
    game.properties: |-
      enemies=aliens
      lives=3
      enemies.cheat=true
      enemies.cheat.level=noGoodRotten
      secret.code.passphrase=UUDDLRLRBABAS
      secret.code.allowed=true
      secret.code.lives=30
    ui.properties: |
      color.good=purple
      color.bad=yellow
      allow.textmode=true
      how.nice.to.look=fairlyNice
  kind: ConfigMap
  metadata:
    creationTimestamp: 2016-02-18T18:52:05Z
    name: game-config-2
    namespace: default
    resourceVersion: "516"
    selflink: /api/v1/namespaces/default/configmaps/game-config-2
    uid: b4952dc3-d670-11e5-8cd0-68f728db1985

• -o オプションを使用してオブジェクトの oc get コマンドを入力し、key-value (キー/値) ペアからキーの値を表示します。

  $ oc get configmaps game-config-3 -o yaml

  出力例

  apiVersion: v1
  data:
    game-special-key: |- 1
      enemies=aliens
      lives=3
      enemies.cheat=true
      enemies.cheat.level=noGoodRotten
      secret.code.passphrase=UUDDLRLRBABAS
      secret.code.allowed=true
      secret.code.lives=30
  kind: ConfigMap
  metadata:
    creationTimestamp: 2016-02-18T18:54:22Z
    name: game-config-3
    namespace: default
    resourceVersion: "530"
    selflink: /api/v1/namespaces/default/configmaps/game-config-3
    uid: 05f8da22-d671-11e5-8cd0-68f728db1985

  1

  これは、先の手順で設定したキーです。

手順

• リテラル値を指定して設定マップを作成します。

  $ oc create configmap special-config \
      --from-literal=special.how=very \
      --from-literal=special.type=charm

検証

• -o オプションを使用してオブジェクトの oc get コマンドを入力し、キーの値を表示します。

  $ oc get configmaps special-config -o yaml

  出力例

  apiVersion: v1
  data:
    special.how: very
    special.type: charm
  kind: ConfigMap
  metadata:
    creationTimestamp: 2016-02-18T19:14:38Z
    name: special-config
    namespace: default
    resourceVersion: "651"
    selflink: /api/v1/namespaces/default/configmaps/special-config
    uid: dadce046-d673-11e5-8cd0-68f728db1985

手順

• 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: 1
          - name: SPECIAL_LEVEL_KEY 2
            valueFrom:
              configMapKeyRef:
                name: special-config 3
                key: special.how 4
          - name: SPECIAL_TYPE_KEY
            valueFrom:
              configMapKeyRef:
                name: special-config 5
                key: special.type 6
                optional: true 7
        envFrom: 8
          - configMapRef:
              name: env-config 9
        securityContext:
          allowPrivilegeEscalation: false
          capabilities:
            drop: [ALL]
    restartPolicy: Never

  1

  ConfigMap から指定された環境変数をプルするためのスタンザです。

  2

  キーの値を挿入する Pod 環境変数の名前です。

  3 5

  特定の環境変数のプルに使用する ConfigMap の名前です。

  4 6

  ConfigMap からプルする環境変数です。

  7

  環境変数をオプションにします。オプションとして、Pod は指定された ConfigMap およびキーが存在しない場合でも起動します。

  8

  ConfigMap からすべての環境変数をプルするためのスタンザです。

  9

  すべての環境変数のプルに使用する ConfigMap の名前です。

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

  SPECIAL_LEVEL_KEY=very
  log_level=INFO

手順

• コンテナー内のコマンドに値を挿入するには、環境変数として使用するキーを使用する必要があります。次に、$(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)" ] 1
        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

  1

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

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

  very charm

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

  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 1
    restartPolicy: Never

  1

  キーを含むファイル。

  この 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 1
    restartPolicy: Never

  1

  設定マップキーへのパス。

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

  very