CLI를 사용하여 configmap 작성

다음 방법 중 하나로 configmap create 명령을 사용하여 configmap을 작성하십시오.

• --from-literal 형식으로 KEY=VALUE 옵션을 사용하여 명령행에서 직접 configmap을 작성하십시오. 예를 들면 다음과 같습니다.

  ibmcloud ce configmap create --name myliteralconfigmap --from-literal TARGET=Sunshine
  

• --from-file 옵션을 사용하여 파일을 가리킴으로써 configmap을 작성하십시오. 이 옵션을 사용하면 파일의 모든 컨텐츠가 키-값 쌍의 값이 됩니다. 이 예제에서는 colors.txt 파일을 사용하며, 여기에는 blue, green, red 텍스트가 포함되어 있습니다.

  • 다음 예제에서는 --from-file KEY=FILE 명령에 configmap create 형식을 사용합니다.

    ibmcloud ce configmap create --name mycolorconfigmap --from-file TARGET=colors.txt
    

  • 다음 예제는 --from-file FILE 명령에 configmap create 형식을 사용합니다. 이 예제에서 TARGET(확장자 없음)은 파일 이름이고, 이는 예제 myjob 작업에 알려진 환경 변수 이름과 동일합니다.

    ibmcloud ce configmap create --name mycolorconfigmap2  --from-file TARGET
    

• --from-env-file 옵션을 사용하여 KEY=VALUE 형식과 일치하는 하나 이상의 행이 포함된 파일을 가리키는 configmap을 작성하십시오. 지정된 파일의 각 행은 키-값 쌍으로 추가됩니다. 지정된 파일에서 비어 있거나 #으로 시작하는 행은 무시됩니다. 이 예제의 경우, 키-값 쌍(colors_multi.txt, color1=yellow, color2=orange)이 포함된 color3=purple 파일을 사용하십시오.

  ibmcloud ce configmap create --name mycolorconfigmapmulti --from-env-file colors_multi.txt
  

CLI를 사용하여 configmap 나열

configmap이 작성되었으므로 configmap list 명령을 사용하여 프로젝트에 있는 모든 configmap을 나열하거나, configmap get 명령을 사용하여 특정 configmap에 대한 세부사항을 표시하십시오. 예를 들면 다음과 같습니다.

ibmcloud ce configmap get --name mycolorconfigmap

출력 예

Getting configmap 'mycolorconfigmap'...
OK

Name:          mycolorconfigmap
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           11s
Created:       2020-10-14 14:10:57 -0400 EDT

Data:
---
TARGET: blue, green, red

CLI를 사용하여 기존 configmap 참조

CLI를 사용하여 앱, 작업 또는 기능 워크로드와 함께 configmap을 사용하려면 다음 명령에 --env-from-configmap 옵션을 지정하십시오.

• app create
• app update
• job create
• job update
• jobrun submit
• jobrun resubmit
• fn create
• fn update

다음 예에서는 CLI를 사용하여 앱에서 기존 configmap을 참조하는 방법에 대해 설명합니다.

1. configmap create 명령을 사용하여 이 시나리오에 대해 다음과 같은 두 개의 configmap을 작성하십시오.

   ibmcloud ce configmap create --name myliteralconfigmap --from-literal TARGET=Sunshine
   

   ibmcloud ce configmap create --name myliteralconfigmap2 --from-literal TARGET=Stranger
   

2. 앱을 배치하고 myliteralconfigmap configmap을 참조하십시오. 이 예에서는 hello 이미지를 사용하는 앱을 작성합니다. 요청이 이 샘플 앱으로 전송되면 앱에서 환경 변수 TARGET을 읽고 Hello ${TARGET}을 출력합니다. 이 환경 변수가 비어 있으면 Hello World가 리턴됩니다. myliteralconfigmap configmap을 참조하십시오. 이 예제에 사용되는 코드에 대한 자세한 정보는 hello의 내용을 참조하십시오.

   ibmcloud ce app create --name myhelloapp --image icr.io/codeengine/hello --env-from-configmap myliteralconfigmap
   

3. 애플리케이션을 호출하십시오. 앱은 Hello Sunshine을 리턴합니다. 이는 TARGET configmap에 지정된 myliteralconfigmap 키의 값입니다.

   curl https://myhelloapp.d484a5d6-d10d.us-south.codeengine.appdomain.cloud
   

   출력 예

   Hello Sunshine
   

4. 앱을 다시 업데이트하여 myliteralconfigmap2 configmap을 사용하십시오.

   다른 configmap (또는 시크릿) 을 완전히 참조하기 위해 configmap (또는 시크릿) 을 완전히 참조하는 환경 변수를 사용하여 앱, 작업 또는 기능을 업데이트하는 경우, 전체 참조는 설정된 순서대로 다른 전체 참조를 대체합니다 (마지막 참조된 세트가 첫 번째 세트를 대체함).

   ibmcloud ce app update --name myhelloapp --env-from-configmap myliteralconfigmap2
   

   출력 예

   Updating application 'myhelloapp' to latest revision.
   [...]
   Run 'ibmcloud ce application get -n myhelloapp' to check the application status.
   OK
   
   https://myhelloapp.d484a5d6-d10d.us-south.codeengine.appdomain.cloud
   

5. 애플리케이션을 다시 호출하십시오. 이번에는 앱이 Hello Stranger를 리턴합니다. 이는 myliteralconfigmap2 configmap에 지정된 값입니다.

   curl https://myhelloapp.d484a5d6-d10d.us-south.codeengine.appdomain.cloud  
   

   출력 예

   Hello Stranger
   

6. myliteralconfigmap2를 업데이트하여 키-값 쌍을 변경하십시오.

   ibmcloud ce configmap update --name myliteralconfigmap2 --from-literal "TARGET=Happy day"
   

   ibmcloud ce configmap get -n myliteralconfigmap2 명령을 실행하여 configmap의 세부사항을 표시하십시오.

   출력 예

   Name:          myliteralconfigmap2
   [...]
   Data:
   ---
   TARGET: Happy day
   

7. 새 데이터를 적용하려면 애플리케이션을 다시 시작하십시오.

   ibmcloud ce app update --name myhelloapp
   

8. 애플리케이션을 다시 호출하십시오. 이번에는 앱이 Hello Happy day를 리턴합니다. 이는 myliteralconfigmap2 configmap에 지정된 값입니다.

   curl https://myhelloapp.d484a5d6-d10d.us-south.codeengine.appdomain.cloud  
   

   출력 예

   Hello Happy day
   

CLI를 사용하여 아직 정의되지 않은 configmap 참조

configmap이 참조되기 전에 존재하지 않으면 앱, 작업 또는 기능 워크로드가 성공적으로 배치되지 않으며 참조된 configmap이 작성될 때까지 작업 또는 기능이 성공적으로 실행되지 않습니다.

앱, 작업 또는 기능 워크로드에 대해 작업 중이고 참조된 configmap이 아직 정의되지 않은 경우 --force 옵션을 사용하여 참조된 configmap의 존재 여부를 확인하지 않을 수 있습니다. --force 옵션은 다음 명령과 함께 사용할 수 있습니다.

• app create
• app update
• job create
• job update
• jobrun submit
• jobrun resubmit
• fn create
• fn update

이러한 명령에 --force 옵션을 사용하면 워크로드를 작성, 업데이트 또는 실행하는 조치가 완료됩니다. 그러나 참조된 configmap이 존재할 때까지 앱, 작업 또는 워크로드가 성공적으로 실행되지 않습니다. 명령에 --force 옵션 외에 --no-wait 옵션을 추가하면 시스템이 조치를 완료하고 워크로드가 성공적으로 실행될 때까지 대기하지 않습니다.

다음 예에서는 CLI를 사용하여 아직 앱에서 정의되지 않은 configmap을 참조하는 방법에 대해 설명합니다.

1. 앱을 작성하고 정의되지 않은 myliteralconfigmap3 configmap을 참조하십시오. 이 예에서는 icr.io/codeengine/hello 이미지를 사용하는 Code Engine 앱을 작성합니다. 요청이 이 샘플 앱으로 전송되면 앱에서 환경 변수 TARGET을 읽고 Hello ${TARGET}을 출력합니다. 이 환경 변수가 비어 있으면 Hello World가 리턴됩니다. myliteralconfigmap3 configmap을 참조하십시오. 이 예제에 사용되는 코드에 대한 자세한 정보는 hello의 내용을 참조하십시오.

   app create 명령에 --no-wait 옵션을 사용하면 앱이 작성되고 앱이 준비될 때까지 기다리지 않습니다.

   ibmcloud ce app create --name myapp --image icr.io/codeengine/hello --env-from-configmap myliteralconfigmap3 --force --no-wait
   

2. app get 명령을 사용하여 환경 변수 정보를 포함한 작업 실행의 세부사항을 표시하십시오. 앱이 작성되었지만 아직 완전히 배치되지는 않았습니다.

   ibmcloud ce app get --name myapp
   

   출력 예

   Name:            myapp
   [...]
   Status Summary:  Application is deploying
   
   Environment Variables:
       Type                      Name                 Value
       ConfigMap full reference  myliteralconfigmap3
   Image:                  icr.io/codeengine/hello
   Resource Allocation:
       CPU:                1
       Ephemeral Storage:  400M
       Memory:             4G
   
   Runtime:
       Concurrency:    100
       Maximum Scale:  10
       Minimum Scale:  0
       Timeout:        300
   
   Conditions:
       Type                 OK     Age  Reason
       ConfigurationsReady  false  10s
       Ready                false  10s  RevisionMissing : Configuration "myapp" is waiting for a Revision to become ready.
       RoutesReady          false  10s  RevisionMissing : Configuration "myapp" is waiting for a Revision to become ready.
   
   Events:
       Type    Reason   Age  Source              Messages
       Normal  Created  12s  service-controller  Created Configuration "myapp"
       Normal  Created  12s  service-controller  Created Route "myapp"
   
   Instances:
       Name                                      Revision      Running  Status   Restarts  Age
       myapp-00001-deployment-566d5c79b9-wttqs  myapp-00001  0/2      Pending  0         11s
   

3. configmap을 작성하십시오.

   ibmcloud ce configmap create --name myliteralconfigmap3 --from-literal TARGET=Everyone
   

4. 새 데이터를 적용하려면 애플리케이션을 다시 시작하십시오.

   ibmcloud ce app update --name myapp
   

5. 애플리케이션을 호출하십시오. 앱은 Hello Everyone을 리턴합니다. 이는 myliteralconfigmap3 configmap에 지정된 값입니다.

   curl https://myapp.d484a5d6-d10d.us-south.codeengine.appdomain.cloud  
   

   출력 예

   Hello Everyone
   

6. 기존 myliteralconfigmap2 configmap을 참조하도록 앱을 업데이트하십시오. myliteralconfigmap2는 TARGET=Stranger 값으로 정의됩니다. 앱을 업데이트하면 새 데이터가 적용되도록 앱이 다시 시작됩니다.

   다른 configmap(또는 시크릿)을 완전히 참조하기 위해 configmap(시크릿)을 참조하는 환경 변수로 애플리케이션 또는 작업을 업데이트하면 전체 참조는 설정된 순서 대로 다른 전체 참조를 대체합니다(마지막으로 참조된 세트가 첫 번째 세트를 대체함).

   ibmcloud ce app update --name myapp --env-from-configmap myliteralconfigmap2
   

7. 애플리케이션을 다시 호출하십시오. 이번에는 앱이 Hello Stranger를 리턴합니다. 이는 myliteralconfigmap2 configmap에 지정된 값입니다.

   curl https://myapp.d484a5d6-d10d.us-south.codeengine.appdomain.cloud  
   

   출력 예

   Hello Stranger
   

전체 시크릿 및 configmap을 환경 변수로 참조하고, 참조를 대체하며, CLI에서 참조를 제거하는 방법에 대한 자세한 시나리오는 시크릿 및 configmap 참조를 참조하십시오.