2.5. 구성 맵 생성 및 사용

사전 요구 사항

• 구성 맵을 채우려는 데이터가 포함된 파일이 있는 디렉터리가 있어야 합니다.

  다음 절차에서는 다음 예제 파일을 사용합니다. 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

사전 요구 사항

• 구성 맵을 채우려는 데이터가 포함된 파일이 있는 디렉터리가 있어야 합니다.

  다음 절차에서는 다음 예제 파일을 사용합니다. 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 명령을 입력합니다.

  $ 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

  환경 변수를 선택적으로 만듭니다. 선택 사항으로 지정된 ConfigMap 및 키가 없는 경우에도 Pod가 시작됩니다.

  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