eb config

설명

활성 구성 설정 및 사용자 환경의 저장된 구성을 관리합니다. 이 명령을 사용하여 환경의 저장된 구성을 업로드, 다운로드 또는 나열할 수 있습니다. 이 옵션을 사용하여 활성 구성 설정을 다운로드, 표시 또는 업데이트할 수도 있습니다.

루트 디렉터리에 사용자 지정 플랫폼을 지정하는 platform.yaml 파일이 들어 있는 경우, 이 명령은 빌더 구성 설정도 변경합니다. 이 작업은 platform.yaml에 설정된 값을 기반으로 수행됩니다.

참고

eb config는 환경 속성을 표시하지 않습니다. 애플리케이션 내에서 읽을 수 있도록 환경 속성을 설정하려면 eb setenv를 대신 사용합니다.

구문

다음은 환경의 활성 구성 설정을 사용하는 eb config 명령에 사용되는 구문의 일부입니다. 구체적인 예는 이 항목의 예제 단원을 참조하세요.

eb config – EDITOR 환경 변수로 구성한 텍스트 편집기에 사용자 환경의 활성 구성 설정을 표시합니다. 파일 변경 사항을 저장하고 편집기를 닫으면 파일에 저장한 옵션 설정으로 환경이 업데이트됩니다.

참고
EDITOR 환경 변수를 구성하지 않은 경우, EB CLI는 YAML 파일에 대한 기본 편집기에 옵션 설정을 표시합니다.
eb config environment-name – 명명된 환경에 대한 구성을 표시하고 업데이트합니다. 구성은 구성한 텍스트 편집기나 기본 편집기 YAML 파일에 표시됩니다.
eb config save – 현재 환경에 대한 활성 구성 설정을 파일 이름이 .elasticbeanstalk/saved_configs/인 [configuration-name].cfg.yml으로 저장합니다. 기본적으로 EB CLI는 환경 이름에 따라 구성 설정을 configuration-name으로 저장합니다. 명령을 실행할 때 --cfg 옵션과 함께 원하는 구성 이름을 포함하여 다른 구성 이름을 지정할 수 있습니다.

--tags 옵션을 사용하여 저장된 구성에 태그를 지정할 수 있습니다.
eb config --display – 환경의 활성 구성 설정을 파일 대신 stdout에 씁니다. 기본적으로 터미널에 대한 구성 설정이 표시됩니다.
eb config --update configuration_string | file_path – configuration_string에 지정되거나 file_path로 식별된 파일 내에 지정된 정보로 현재 환경에 대한 활성 구성 설정을 업데이트합니다.

참고

--display 및 --update 옵션은 환경의 구성 설정을 프로그래밍 방식으로 읽고 수정할 수 있는 유연성을 제공합니다.

다음은 eb config 명령을 사용하여 저장된 구성을 작업하기 위한 구문을 설명합니다. 예제는 이 주제 후반부의 예제 단원을 참조하세요.

eb config get config-name – Amazon S3에서 명명된 저장된 구성을 다운로드합니다.
eb config delete config-name – Amazon S3에서 명명된 저장된 구성을 삭제합니다. 또한 이미 다운로드한 경우 로컬에서 삭제합니다.
eb config list – Amazon S3에 있는 저장된 구성을 나열합니다.
eb config put filename – 명명된 저장된 구성을 Amazon S3 버킷에 업로드합니다. filename의 파일 확장명은 .cfg.yml이어야 합니다. 경로 없이 파일 이름을 지정하려면 명령을 실행하기 전에 파일을 .elasticbeanstalk 폴더 또는 .elasticbeanstalk/saved_configs/ 폴더에 저장하면 됩니다. 또는 전체 경로를 제공하여 filename을 지정할 수도 있습니다.

옵션

이름	설명
`--cfg config-name`	저장된 구성에 사용할 이름입니다. 이 옵션은 eb config save에서만 사용할 수 있습니다.
`-d` 또는 `--display`	현재 환경에 대한 구성 설정을 표시합니다(stdout에 쓰기). `--format` 옵션과 함께 사용하여 JSON 또는 YAML로 출력을 지정합니다. 지정하지 않으면 출력은 YAML 형식입니다. 이 옵션은 다른 하위 명령 없이 eb config 명령을 사용하는 경우에만 작동합니다.
`-f format_type` 또는 `--format format_type`	표시 형식을 지정합니다. 유효한 값은 JSON 또는 YAML입니다. 기본값은 YAML입니다. 이 옵션은 `--display` 옵션에서만 작동합니다.
`--tags key1=value1[,key2=value2 ...]`	저장된 구성에 추가할 태그입니다. 목록에서 태그를 지정할 때 키=값 페어로 지정하고 각 태그를 쉼표로 구분합니다. 자세한 내용은 저장된 구성 태그 지정을(를) 참조하세요. 이 옵션은 eb config save에서만 사용할 수 있습니다.
`--timeout timeout`	명령 시간이 초과되기 전 경과되는 시간(분)입니다.
`-u configuration_string \| file_path` 또는 `--update configuration_string \| file_path`	현재 환경에 대한 활성 구성 설정을 업데이트합니다. 이 옵션은 다른 하위 명령 없이 eb config 명령을 사용하는 경우에만 작동합니다. `configuration_string \| file_path` 파라미터는 유형 문자열입니다. 문자열은 환경에 대한 구성 설정에 추가, 업데이트 또는 제거할 네임스페이스 목록과 해당 옵션을 제공합니다. 또는 입력 문자열은 동일한 정보를 포함하는 파일을 나타낼 수 있습니다. 파일 이름을 지정하려면 입력 문자열이 `"file://<path><filename>"` 형식을 따라야 합니다. `path` 없이 파일 이름을 지정하려면 명령을 실행하는 폴더에 파일을 저장합니다. 또는 전체 경로를 제공하여 파일 이름을 지정합니다. 구성 정보는 다음 조건을 충족해야 합니다. 섹션, OptionSettings, OptionsToRemove 중 하나 이상이 필요합니다. 옵션을 추가하거나 변경하는 데 OptionSettings을 사용합니다. 네임스페이스에서 옵션을 제거하는 데 OptionsToRemove을 사용합니다. 구체적인 예는 이 항목의 예제 단원을 참조하세요. YAML 형식 `OptionSettings: namespace1: option-name-1: option-value-1 option-name-2: option-value-2 ... OptionsToRemove: namespace1: option-name-1 option-name-2 ...` JSON 형식 `{ "OptionSettings": { "namespace1": { "option-name-1": "option-value-1", "option-name-2": "option-value-2", ... } }, "OptionsToRemove": { "namespace1": { "option-name-1", "option-name-2", ... } } }`
일반 옵션

결과

eb config 또는 eb config environment-name 명령이 하위 명령 또는 옵션이 추가되지 않은 상태에서 성공적으로 실행되면, 명령은 EDITOR 환경 변수로 구성한 텍스트 편집기에 현재 옵션 설정을 표시합니다. EDITOR 환경 변수를 구성하지 않은 경우, EB CLI는 YAML 파일에 대한 기본 편집기에 옵션 설정을 표시합니다.

파일 변경 사항을 저장하고 편집기를 닫으면 파일에 저장한 옵션 설정으로 환경이 업데이트됩니다. 구성 업데이트를 확인하기 위해 다음과 같은 출력이 표시됩니다.


$ eb config myApp-dev
    Printing Status:
    2021-05-19 18:09:45    INFO    Environment update is starting.
    2021-05-19 18:09:55    INFO    Updating environment myApp-dev's configuration settings.
    2021-05-19 18:11:20    INFO    Successfully deployed new configuration to environment.

명령이 --display 옵션과 함께 성공적으로 실행되면 현재 환경에 대한 구성 설정(stdout에 쓰기)이 표시됩니다.

명령이 get 파라미터와 함께 성공적으로 실행되면, 명령이 사용자가 다운로드한 로컬 사본의 위치를 표시합니다.

명령이 save 파라미터와 함께 성공적으로 실행되면, 명령이 저장된 파일의 위치를 표시합니다.

예제

이 단원에서는 옵션 설정 파일을 보고 편집할 때 사용하는 텍스트 편집기를 변경하는 방법을 설명합니다.

Linux 및 UNIX의 경우 다음 예제에서는 편집기를 vim으로 변경합니다.


$ export EDITOR=vim

Linux 및 UNIX의 경우 다음 예제에서는 편집기를 /usr/bin/kate에 설치된 편집기로 변경합니다.


$ export EDITOR=/usr/bin/kate

Windows의 경우 다음 예제에서는 편집기를 Notepad++로 변경합니다.


> set EDITOR="C:\Program Files\Notepad++\Notepad++.exe

이 단원에서는 하위 명령과 함께 실행할 경우의 eb config 명령에 대한 예제를 제공합니다.

다음 예제에서는 app-tmp라는 저장된 구성을 삭제합니다.


$ eb config delete app-tmp

다음 예제에서는 Amazon S3 버킷에서 이름이 app-tmp인 저장된 구성을 다운로드합니다.


$ eb config get app-tmp

다음 예제에서는 Amazon S3 버킷에 있는 저장된 구성의 이름을 나열합니다.


$ eb config list

다음 예제에서는 app-tmp라는 저장된 구성의 로컬 사본을 Amazon S3 버킷에 업로드합니다.


$ eb config put app-tmp

다음 예제에서는 현재 실행 중인 환경의 구성 설정을 저장합니다. 저장된 구성에 사용할 이름을 제공하지 않으면 Elastic Beanstalk가 환경 이름에 따라 구성 파일의 이름을 지정합니다. 예를 들어 tmp-dev라는 환경은 tmp-dev.cfg.yml이 됩니다. Elastic Beanstalk는 파일을 /.elasticbeanstalk/saved_configs/ 폴더에 저장합니다.


$ eb config save

다음 예제에서, --cfg 옵션을 사용하여 환경 tmp-dev의 구성 설정을 v1-app-tmp.cfg.yml이라는 파일에 저장합니다. Elastic Beanstalk는 파일을 /.elasticbeanstalk/saved_configs/ 폴더에 저장합니다. 환경 이름을 지정하지 않은 경우 Elastic Beanstalk는 현재 실행 중인 환경의 구성 설정을 저장합니다.


$ eb config save tmp-dev --cfg v1-app-tmp

이 섹션에서는 하위 명령 없이 실행될 때 eb config 명령에 대한 예제를 제공합니다.

다음 명령은 현재 환경의 옵션 설정을 텍스트 편집기에 표시합니다.


$ eb config

다음 명령은 텍스트 편집기에서 my-env 환경에 대한 옵션 설정을 표시합니다.


$ eb config my-env

다음 예제에서는 현재 환경에 대한 옵션 설정을 표시합니다. --format 옵션으로 특정 형식이 지정되지 않았기 때문에 YAML 형식으로 출력됩니다.


$ eb config --display

다음 예제에서는 이름이 example.txt인 파일의 세부 항목을 사용하여 현재 환경에 대한 옵션 설정을 업데이트합니다. 이 파일은 YAML 또는 JSON 형식으로 되어 있습니다. EB CLI는 파일 형식을 자동으로 감지합니다.

네임스페이스 aws:autoscaling:asg에 대해 Minsize 옵션이 1로 설정됩니다.
네임스페이스 aws:elasticbeanstalk:command에 대한 배치 크기는 30%로 설정됩니다.
네임스페이스 AWSEBV2LoadBalancer.aws:elbv2:loadbalancer에서 IdleTimeout: None의 옵션 설정을 제거합니다.


$ eb config --update "file://example.txt"

예 - filename: `example.txt` - YAML 형식


OptionSettings:
  'aws:elasticbeanstalk:command':
    BatchSize: '30'
    BatchSizeType: Percentage
  'aws:autoscaling:asg':
    MinSize: '1'
OptionsToRemove:
  'AWSEBV2LoadBalancer.aws:elbv2:loadbalancer':
    IdleTimeout

예 - filename: `example.txt` - JSON 형식


{
    "OptionSettings": {
        "aws:elasticbeanstalk:command": {
            "BatchSize": "30",
            "BatchSizeType": "Percentage"
        },
        "aws:autoscaling:asg": {
            "MinSize": "1"
        }
    },
    "OptionsToRemove": {
        "AWSEBV2LoadBalancer.aws:elbv2:loadbalancer": {
            "IdleTimeout"
        }
    }
}

다음 예제에서는 현재 환경에 대한 옵션 설정을 업데이트합니다. 이 명령은 aws:autoscaling:asg 네임스페이스에 대해 Minsize 옵션을 1로 설정합니다.

참고

이 예제는 Windows PowerShell에만 해당됩니다. 슬래시(") 문자를 앞에 사용하여 큰 따옴표(\) 문자의 리터럴 발생을 이스케이프합니다. 운영 체제와 명령줄 환경에 따라 이스케이프 시퀀스가 다를 수 있습니다. 따라서 앞의 예제에 나와 있는 파일 옵션을 사용하는 것이 좋습니다. 파일에서 구성 옵션을 지정하면 이스케이프 문자가 필요하지 않으며 여러 운영 체제에서 일관성이 유지됩니다.

다음 예제는 JSON 형식으로 되어 있습니다. EB CLI는 형식이 JSON인지 YAML인지를 감지합니다.


PS C:\Users\myUser\EB_apps\myApp-env>eb config --update '{\"OptionSettings\":{\"aws:autoscaling:asg\":{\"MaxSize\":\"1\"}}}'

다음 예제는 YAML 형식으로 되어 있습니다. YAML 문자열을 올바른 형식으로 입력하려면 YAML 파일에 필요한 간격 및 줄 끝 반환이 명령에 포함됩니다.

각 줄을 “enter” 또는 “return” 키로 끝냅니다.
두 번째 줄을 두 개의 공백으로 시작하고 세 번째 줄을 네 개의 공백으로 시작합니다.


PS C:\Users\myUser\EB_apps\myApp-env>eb config --update 'OptionSettings:
>>  aws:autoscaling:asg:
>>    MinSize: \"1\"'

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

eb codesource

eb console

eb config

설명

참고

구문

참고

참고

옵션

결과

예제

예 - filename: example.txt - YAML 형식

예 - filename: example.txt - JSON 형식

참고

예 - filename: `example.txt` - YAML 형식

예 - filename: `example.txt` - JSON 형식