기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # EB CLI 명령 참조 Elastic Beanstalk 명령줄 인터페이스(EB CLI)를 사용하여 Elastic Beanstalk 애플리케이션 및 환경을 배포하고 관리하는 여러 작업을 수행할 수 있습니다. Git 소스 제어로 관리되는 애플리케이션 소스 코드를 배포하려는 경우, EB CLI를 Git과 통합합니다. 자세한 내용은 [Elastic Beanstalk를 관리하기 위한 EB 명령줄 인터페이스(EB CLI) 설정](eb-cli3.md) 및 [EB CLI와 Git 사용](eb3-cli-git.md)을(를) 참조하세요. **Topics** + [일반 옵션](eb3-cmd-options.md) + [**eb abort**](eb3-abort.md) + [**eb appversion**](eb3-appversion.md) + [**eb clone**](eb3-clone.md) + [**eb codesource**](eb3-codesource.md) + [**eb config**](eb3-config.md) + [**eb console**](eb3-console.md) + [**eb create**](eb3-create.md) + [**eb deploy**](eb3-deploy.md) + [**eb events**](eb3-events.md) + [**eb health**](eb3-health.md) + [**eb init**](eb3-init.md) + [**eb labs**](eb3-labs.md) + [**eb list**](eb3-list.md) + [**eb local**](eb3-local.md) + [**eb logs**](eb3-logs.md) + [**eb migrate**](eb3-migrate.md) + [**eb open**](eb3-open.md) + [**eb platform**](eb3-platform.md) + [**eb printenv**](eb3-printenv.md) + [**eb restore**](eb3-restore.md) + [**eb scale**](eb3-scale.md) + [**eb setenv**](eb3-setenv.md) + [**eb ssh**](eb3-ssh.md) + [**eb status**](eb3-status.md) + [**eb swap**](eb3-swap.md) + [**eb tags**](eb3-tags.md) + [**eb terminate**](eb3-terminate.md) + [**eb upgrade**](eb3-upgrade.md) + [**eb use**](eb3-use.md) # 일반 옵션 모든 EB CLI 명령으로 다음 옵션을 사용할 수 있습니다. **** | 이름 | 설명 | | --- | --- | | `--debug` | 디버깅 정보 인쇄 | | `-h`, `--help` | 도움말 메시지를 표시합니다. 유형: 문자열 기본값: None | | `--no-verify-ssl` | SSL 인증서 확인을 건너뜁니다. 프록시로 CLI를 사용하는 데 문제가 있으면 이 옵션을 사용합니다. | | `--profile` | AWS 자격 증명 파일의 특정 프로필을 사용합니다. | | `--quiet` | 명령에서 모든 출력을 제한합니다. | | `--region` | 지정된 리전을 사용합니다. | | `-v`, `--verbose` | 상세 표시 정보를 표시합니다. | # **eb abort** ## 설명 인스턴스에 대한 환경 구성 변경이 진행 중인 경우 업그레이드를 취소합니다. **참고** 세 개 이상의 환경에서 업데이트를 진행 중인 경우 변경 사항을 롤백할 환경의 이름을 선택하라는 메시지가 표시됩니다. ## 구문 **eb abort** **eb abort *environment-name*** ## 옵션 **** | 이름 | 설명 | | --- | --- | | [일반 옵션](eb3-cmd-options.md) | | ## 출력 이 명령은 현재 업데이트 중인 환경의 목록을 표시하고 중단할 업데이트를 선택하라는 메시지를 표시합니다. 현재 한 환경에서만 업데이트를 진행 중인 경우 환경 이름을 지정할 필요가 없습니다. 성공하면 이 명령은 환경 구성 변경 사항을 되돌립니다. 환경의 모든 인스턴스가 이전 환경 구성을 갖거나 롤백 프로세스가 실패할 때까지 롤백 프로세스는 계속 진행됩니다. ## 예제 다음 예에서는 플랫폼 업그레이드를 취소합니다. ``` $ eb abort Aborting update to environment "tmp-dev". ``` # **eb appversion** ## 설명 EB CLI `appversion` 명령은 Elastic Beanstalk [애플리케이션 버전](concepts.md#concepts-version)을 관리합니다. 배포하지 않고 애플리케이션의 새 버전을 만들거나, 애플리케이션 버전을 삭제하거나, [애플리케이션 버전 수명 주기 정책](applications-lifecycle.md)을 만들 수 있습니다. 아무 옵션 없이 명령을 호출하면 [대화형 모드](#eb3-appversion-interactive)로 전환됩니다. `--create` 옵션을 사용하여 새 버전의 애플리케이션을 만듭니다. 애플리케이션 버전을 삭제하려면 `--delete` 옵션을 사용합니다. 애플리케이션 버전 수명 주기 정책을 표시하거나 만들려면 `lifecycle` 옵션을 사용합니다. 자세한 내용은 [애플리케이션 버전 수명 주기 설정 구성](applications-lifecycle.md) 단원을 참조하십시오. ## 구문 **eb appversion** **eb appversion [-c \$1 --create]** **eb appversion [-d \$1 --delete] *version-label*** **eb appversion lifecycle [-p \$1 --print]** ## 옵션 **** | 이름 | 설명 유형: 문자열 | | --- | --- | | -a *application-name* 또는 --application\$1name *application-name* | 애플리케이션의 이름입니다. 지정된 이름의 애플리케이션을 찾을 수 없는 경우, EB CLI는 새 애플리케이션에 대한 애플리케이션 버전을 만듭니다. `--create` 옵션에만 적용할 수 있습니다. 유형: 문자열 | | -c 또는 --create | [새 버전](concepts.md#concepts-version)의 애플리케이션을 만듭니다. | | -d *version-label* 또는 --delete *version-label* | version-label이라고 표시된 애플리케이션의 버전을 삭제합니다. | | `-l` *version\$1label* 또는 `--label` *version\$1label* | EB CLI가 생성하는 버전에 사용할 레이블을 지정합니다. 이 옵션을 사용하지 않으면 EB CLI가 새 고유 레이블을 생성합니다. 버전 레이블을 제공하는 경우 버전 레이블은 고유해야 합니다. `--create` 옵션에만 적용할 수 있습니다. 유형: 문자열 | | 수명 주기 | 기본 편집기를 호출하여 새 애플리케이션 버전 수명 주기 정책을 만듭니다. [애플리케이션 버전 할당량](https://docs.aws.amazon.com/general/latest/gr/elasticbeanstalk.html#limits_elastic_beanstalk)에 도달하는 것을 방지하려면 이 정책을 사용합니다. | | lifecycle -p 또는 lifecycle --print | 현재 애플리케이션 수명 주기 정책을 표시합니다. | | `-m` "*version\$1description*" 또는 `--message` "*version\$1description*" | 애플리케이션 버전에 대한 설명입니다. 이는 큰따옴표로 묶여 있습니다. `--create` 옵션에만 적용할 수 있습니다. 유형: 문자열 | | `-p` 또는 `--process` | 소스 번들의 환경 매니페스트 및 구성 파일을 사전 처리 및 확인합니다. 구성 파일의 유효성을 검사하면 문제를 파악할 수 있습니다. 애플리케이션 버전을 환경에 배포하기 전에 이 작업을 수행하는 것이 좋습니다. `--create` 옵션에만 적용할 수 있습니다. | | `--source codecommit/repository-name/branch-name` | CodeCommit 리포지토리 및 브랜치. `--create` 옵션에만 적용할 수 있습니다. | | `--staged` | HEAD 커밋 대신 git 인덱스에 준비된 파일을 사용하여 애플리케이션 버전을 만듭니다. `--create` 옵션에만 적용할 수 있습니다. | | `--timeout` *minutes* | 명령 시간이 초과되기 전 경과되는 시간(분)입니다. `--create` 옵션에만 적용할 수 있습니다. | | [일반 옵션](eb3-cmd-options.md) | | ## 명령을 대화식으로 사용 인수 없이 명령을 사용하면 출력에 애플리케이션의 버전이 표시됩니다. 버전은 역순으로 나열되며, 가장 최신 버전이 먼저 나열됩니다. 화면이 표시되는 예는 **예제** 단원을 참조하세요. 상태 줄이 맨 아래에 표시됩니다. 상태 줄에는 상황에 맞는 정보가 표시됩니다. `d`를 눌러 애플리케이션 버전을 삭제하거나, `l`을 눌러 애플리케이션의 수명 주기 정책을 관리하거나, `q`를 눌러 변경하지 않고 종료합니다. **참고** 환경에 배포한 버전은 삭제할 수 없습니다. ## 출력 `--create` 옵션이 있는 명령은 애플리케이션 버전이 생성되었음을 확인하는 메시지를 표시합니다. `--delete` *version-label* 옵션이 있는 명령은 애플리케이션 버전이 삭제되었음을 확인하는 메시지를 표시합니다. ## 예제 다음 예제에서는 배포가 없는 애플리케이션의 대화형 창을 보여 줍니다. ![\[Application window showing version history with three entries and no current deployment.\]](http://docs.aws.amazon.com/ko_kr/elasticbeanstalk/latest/dg/images/InteractiveModeNoEnvironment.png) 다음 예제에서는 버전 레이블이 **샘플 애플리케이션**인 네 번째 버전이 배포된 애플리케이션의 대화형 창을 보여 줍니다. ![\[Application versions table showing 4 versions, with the latest labeled "Sample Application" deployed 2 minutes ago.\]](http://docs.aws.amazon.com/ko_kr/elasticbeanstalk/latest/dg/images/InteractiveModeWithEnvironment.png) 다음 예제에서는 **eb appversion lifecycle -p** 명령의 출력을 보여 줍니다. 여기에서 *ACCOUNT-ID*는 사용자의 계정 ID입니다. ``` Application details for: lifecycle Region: sa-east-1 Description: Application created from the EB CLI using "eb init" Date Created: 2016/12/20 02:48 UTC Date Updated: 2016/12/20 02:48 UTC Application Versions: ['Sample Application'] Resource Lifecycle Config(s): VersionLifecycleConfig: MaxCountRule: DeleteSourceFromS3: False Enabled: False MaxCount: 200 MaxAgeRule: DeleteSourceFromS3: False Enabled: False MaxAgeInDays: 180 ServiceRole: arn:aws:iam::ACCOUNT-ID:role/aws-elasticbeanstalk-service-role ``` # **eb clone** ## 설명 두 개의 환경 설정이 동일하도록 환경을 새 환경으로 복제합니다. **참고** 기본적으로, **eb clone** 명령은 복제본을 만들 환경의 솔루션 스택 버전과 관계없이 가장 최근의 솔루션 스택을 갖춘 클론 환경을 생성합니다. `--exact` 옵션으로 명령을 실행하여 이를 억제할 수 있습니다. **중요** 복제된 Elastic Beanstalk 환경은 보안 그룹에 수신을 전달하지 않으므로 모든 인터넷 트래픽에 환경이 개방됩니다. 복제된 환경에 대한 수신 보안 그룹을 다시 설정해야 합니다. 환경 구성의 드리프트 상태를 확인하여 복제할 수 없는 리소스를 알아볼 수 있습니다. 자세한 내용은 *AWS CloudFormation 사용 설명서*의 [전체 CloudFormation 스택에서 드리프트 감지](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/detect-drift-stack.html)를 참조하세요. ## 구문 **eb clone** **eb clone *environment-name*** ## 옵션 **** | 이름 | 설명 | | --- | --- | | `-n` *string* 또는 `--clone_name` *string* | 복제된 환경에 사용할 이름입니다. | | `-c` *string* 또는 `--cname` *string* | 복제된 환경에 사용할 CNAME 접두사입니다. | | `--envvars` | *name*=*value* 형식이며 쉼표로 분리된 목록의 환경 속성입니다. 유형: 문자열 제약 조건: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/elasticbeanstalk/latest/dg/eb3-clone.html) | | `--exact` | Elastic Beanstalk가 새 복제 환경에 대한 솔루션 스택 버전을 가장 최근 버전(원본 환경의 플랫폼에 대한)에 업데이트하지 않도록 합니다. | | `--scale` *number* | 시작될 때 복제 환경에서 실행되는 인스턴스 수입니다. | | `--tags` *name*=*value* | *name*=*value* 형식이며 쉼표로 분리된 목록에서 환경의 리소스에 대한 [태그](using-features.tagging.md)입니다. | | `--timeout` | 명령 시간이 초과되기 전 경과되는 시간(분)입니다. | | [일반 옵션](eb3-cmd-options.md) | | ## 출력 성공하면 명령은 원본 환경과 설정이 동일하거나 **eb clone** 옵션에서 지정된 대로 수정한 환경을 생성합니다. ## 예제 다음 예는 지정된 환경을 복제합니다. ``` $ eb clone Enter name for Environment Clone (default is tmp-dev-clone): Enter DNS CNAME prefix (default is tmp-dev-clone): Environment details for: tmp-dev-clone Application name: tmp Region: us-west-2 Deployed Version: app-141029_144740 Environment ID: e-vjvrqnn5pv Platform: 64bit Amazon Linux 2014.09 v1.0.9 running PHP 5.5 Tier: WebServer-Standard-1.0 CNAME: tmp-dev-clone.elasticbeanstalk.com Updated: 2014-10-29 22:00:23.008000+00:00 Printing Status: 2018-07-11 21:04:20 INFO: createEnvironment is starting. 2018-07-11 21:04:21 INFO: Using elasticbeanstalk-us-west-2-888888888888 as Amazon S3 storage bucket for environment data. ... 2018-07-11 21:07:10 INFO: Successfully launched environment: tmp-dev-clone ``` # **eb codesource** ## 설명 CodeCommit 리포지토리에서 배포하도록 EB CLI를 구성하거나, CodeCommit 통합을 비활성화하고 로컬 시스템에서 소스 번들을 업로드합니다. **참고** 일부 AWS 리전에서는 CodeCommit을 제공하지 않습니다. Elastic Beanstalk와 CodeCommit 간의 통합은 이러한 리전에서 작동하지 않습니다. 각 리전에서 제공되는 AWS 서비스에 대한 자세한 내용은 [리전 테이블](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/)을 참조하세요. ## 구문 **eb codesource** **eb codesource codecommit** **eb codesource local** ## 옵션 **** | 이름 | 설명 | | --- | --- | | [일반 옵션](eb3-cmd-options.md) | | ## 출력 **eb codesource**는 CodeCommit 통합과 표준 배포 중에 선택하라는 메시지를 표시합니다. **eb codesource codecommit**은 CodeCommit 통합을 위해 대화형 리포지토리 구성을 시작합니다. **eb codesource local**은 원래 구성을 보여 주고 CodeCommit 통합을 비활성화합니다. ## 예제 **eb codesource codecommit**을 사용하여 현재 브랜치에 대해 CodeCommit 통합을 구성합니다. ``` ~/my-app$ eb codesource codecommit Select a repository 1) my-repo 2) my-app 3) [ Create new Repository ] (default is 1): 1 Select a branch 1) mainline 2) test 3) [ Create new Branch with local HEAD ] (default is 1): 1 ``` **eb codesource local**을 사용하여 현재 브랜치에 대해 CodeCommit 통합을 비활성화합니다. ``` ~/my-app$ eb codesource local Current CodeCommit setup: Repository: my-app Branch: mainline Default set to use local sources ``` # **eb config** ## 설명 활성 [구성](concepts.md#concepts-environmentconfig) 설정 및 사용자 환경의 [저장된 구성](concepts.md#concepts-configuration)을 관리합니다. 이 명령을 사용하여 환경의 저장된 구성을 업로드, 다운로드 또는 나열할 수 있습니다. 이 옵션을 사용하여 활성 구성 설정을 다운로드, 표시 또는 업데이트할 수도 있습니다. 루트 디렉터리에 사용자 지정 플랫폼을 지정하는 `platform.yaml` 파일이 들어 있는 경우, 이 명령은 빌더 구성 설정도 변경합니다. 이 작업은 `platform.yaml`에 설정된 값을 기반으로 수행됩니다. **참고** **eb config**는 환경 속성을 표시하지 않습니다. 애플리케이션 내에서 읽을 수 있도록 환경 속성을 설정하려면 [**eb setenv**](environment-configuration-methods-after.md#configuration-options-after-ebcli-ebsetenv)를 대신 사용합니다. ## 구문 다음은 환경의 활성 [구성 설정](concepts.md#concepts-environmentconfig)을 사용하는 **eb config** 명령에 사용되는 구문의 일부입니다. 구체적인 예는 이 항목의 [예제](#eb3-configexample) 단원을 참조하세요. + **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\$1string*에 지정되거나 *file\$1path*로 식별된 파일 내에 지정된 정보로 현재 환경에 대한 활성 구성 설정을 업데이트합니다. **참고** `--display` 및 `--update` 옵션은 환경의 구성 설정을 프로그래밍 방식으로 읽고 수정할 수 있는 유연성을 제공합니다. 다음은 **eb config** 명령을 사용하여 [저장된 구성](concepts.md#concepts-configuration)을 작업하기 위한 구문을 설명합니다. 예제는 이 주제 후반부의 [예제](#eb3-configexample) 단원을 참조하세요. + **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 ...]` | 저장된 구성에 추가할 태그입니다. 목록에서 태그를 지정할 때 키=값 페어로 지정하고 각 태그를 쉼표로 구분합니다. 자세한 내용은 [저장된 구성 태그 지정](environment-configuration-savedconfig-tagging.md)을(를) 참조하세요. 이 옵션은 **eb config save**에서만 사용할 수 있습니다. | | `--timeout timeout` | 명령 시간이 초과되기 전 경과되는 시간(분)입니다. | | `-u configuration_string \| file_path` 또는 `--update configuration_string \| file_path` | 현재 환경에 대한 활성 구성 설정을 업데이트합니다. 이 옵션은 다른 하위 명령 없이 **eb config** 명령을 사용하는 경우에만 작동합니다. `configuration_string \| file_path` 파라미터는 유형 문자열입니다. 문자열은 환경에 대한 구성 설정에 추가, 업데이트 또는 제거할 네임스페이스 목록과 해당 옵션을 제공합니다. 또는 입력 문자열은 동일한 정보를 포함하는 파일을 나타낼 수 있습니다. 파일 이름을 지정하려면 입력 문자열이 `"file://"` 형식을 따라야 합니다. `path` 없이 파일 이름을 지정하려면 명령을 실행하는 폴더에 파일을 저장합니다. 또는 전체 경로를 제공하여 파일 이름을 지정합니다. 구성 정보는 다음 조건을 충족해야 합니다. 섹션, **OptionSettings**, **OptionsToRemove** 중 하나 이상이 필요합니다. 옵션을 추가하거나 변경하는 데 **OptionSettings**을 사용합니다. 네임스페이스에서 옵션을 제거하는 데 **OptionsToRemove**을 사용합니다. 구체적인 예는 이 항목의 [예제](#eb3-configexample) 단원을 참조하세요. **Example** *YAML 형식* ``` OptionSettings: namespace1: option-name-1: option-value-1 option-name-2: option-value-2 ... OptionsToRemove: namespace1: option-name-1 option-name-2 ... ``` **Example** *JSON 형식* ``` { "OptionSettings": { "namespace1": { "option-name-1": "option-value-1", "option-name-2": "option-value-2", ... } }, "OptionsToRemove": { "namespace1": { "option-name-1", "option-name-2", ... } } } ``` | | [일반 옵션](eb3-cmd-options.md) | | ## 출력 **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\$1\$1로 변경합니다. ``` > 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" ``` **Example - filename: `example.txt` - YAML 형식** ``` OptionSettings: 'aws:elasticbeanstalk:command': BatchSize: '30' BatchSizeType: Percentage 'aws:autoscaling:asg': MinSize: '1' OptionsToRemove: 'AWSEBV2LoadBalancer.aws:elbv2:loadbalancer': IdleTimeout ``` **Example - 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\"' ``` # **eb console** ## 설명 브라우저를 열어 Elastic Beanstalk Management Console의 환경 구성 대시보드를 표시합니다. 루트 디렉터리에 사용자 지정 플랫폼을 가리키는 `platform.yaml` 파일이 있다면, 이 명령은 `platform.yaml`에 지정된 대로 Elastic Beanstalk Management Console의 빌더 환경 구성도 표시합니다. ## 구문 **eb console** **eb console *environment-name*** ## 옵션 **** | 이름 | 설명 | | --- | --- | | [일반 옵션](eb3-cmd-options.md) | | # **eb create** ## 설명 새 환경을 생성하여 애플리케이션 버전을 해당 환경에 배포합니다. **참고** .NET 애플리케이션에 **eb create**를 사용하려면 [.NET 애플리케이션에 대한 소스 번들 생성](applications-sourcebundle.md#using-features.deployment.source.dotnet)에 설명된 대로 배포 패키지를 생성한 후 [프로젝트 폴더 대신 아티팩트 배포](eb-cli3-configuration.md#eb-cli3-artifact)에 설명된 대로 CLI 구성을 설정하여 패키지를 아티팩트로 배포해야 합니다. EB CLI로 환경을 생성하려면 [서비스 역할](concepts-roles-service.md)이 필요합니다. Elastic Beanstalk 콘솔에서 환경을 생성하여 서비스 역할을 생성할 수 있습니다. 서비스 역할이 없는 경우 사용자가 `eb create`를 실행할 때 EB CLI가 역할 생성을 시도합니다. 다음과 같이 몇 가지 소스에서 애플리케이션 버전을 배포할 수 있습니다. + 기본: 로컬 프로젝트 디렉터리의 애플리케이션 소스 코드에서 + `--version` 옵션 사용: 애플리케이션에 이미 있는 애플리케이션 버전에서 + 프로젝트 디렉터리에 애플리케이션 코드가 없는 경우 또는 `--sample` 옵션을 사용하는 경우: 환경의 플랫폼별 샘플 애플리케이션에서 배포 ## 조건 **eb create** **eb create *environment-name*** 환경 이름의 길이는 4\$140자여야 합니다. 문자, 숫자 및 하이픈(-)만 포함될 수 있습니다. 환경 이름은 하이픈으로 시작하거나 끝날 수 없습니다. 명령에 환경 이름을 포함할 경우 EB CLI는 선택하거나 서비스 역할을 생성하라는 메시지를 표시하지 않습니다. 환경 이름 인수 없이 명령을 실행하는 경우 명령은 대화형 흐름으로 실행되며 일부 설정에 대한 값을 입력하거나 선택하라는 메시지를 표시합니다. 이러한 대화형 흐름에서 샘플 애플리케이션을 배포하는 경우 EB CLI에서도 로컬 프로젝트 디렉터리에 이 샘플 애플리케이션을 다운로드할지 묻습니다. 다운로드함으로써 사용자는 이후에 새로운 환경에서 EB CLI를 사용해 애플리케이션의 코드(예: [**eb deploy**](eb3-deploy.md))가 필요한 작업을 실행할 수 있습니다. 일부 대화형 흐름 프롬프트는 특정 조건에서만 표시됩니다. 예를 들어, Application Load Balancer를 사용하도록 선택하고 계정에 하나 이상의 공유 가능 Application Load Balancer가 있는 경우 Elastic Beanstalk에서 공유 로드 밸런서를 사용할 것인지 묻는 메시지가 표시됩니다. 계정에 공유 가능한 Application Load Balancer가 없으면 이 메시지가 표시되지 않습니다. ## 옵션 이러한 옵션이 필요하지 않습니다. 아무 옵션도 지정하지 않고 **eb create**를 실행하면 EB CLI가 각 설정에 대한 값을 입력하거나 선택하라는 메시지를 표시합니다. **** | 이름 | 설명 | | --- | --- | | `-d` 또는 `--branch_default` | 환경을 현재 리포지토리에 대한 기본 환경으로 설정합니다. | | `--cfg` *config-name* | `.elasticbeanstalk/saved_configs/` 또는 Amazon S3 버킷에 [저장된 구성에서 플랫폼 설정을 사용](environment-configuration-methods-during.md#configuration-options-during-ebcli-savedconfig)합니다. `.cfg.yml` 확장명 없이 파일 이름만 지정합니다. | | `-c` *subdomain-name* 또는 `--cname` *subdomain-name* | 웹 사이트로 라우팅되는 CNAME DNS 항목의 접두사로 사용할 하위 도메인 이름입니다. 유형: 문자열 기본값: 환경 이름 | | `-db` 또는 `--database` | 데이터베이스를 환경에 연결합니다. **eb create**를 `--database` 옵션으로 실행하고 `--database.username` 및 `--database.password` 옵션은 사용하지 않을 경우 EB CLI는 데이터베이스 마스터 사용자 이름과 암호를 묻는 메시지를 표시합니다. | | `-db.engine` *engine* 또는 `--database.engine` *engine* | 데이터베이스 엔진 유형입니다. **eb create**를 이 옵션과 함께 실행할 경우 EB CLI는 연결된 데이터베이스가 있는 환경을 시작합니다. 이것은 `--database` 옵션과 함께 명령을 실행하지 않은 경우에도 마찬가지입니다. 유형: 문자열 유효한 값: `mysql`, `oracle-se1`, `postgres`, `sqlserver-ex`, `sqlserver-web`, `sqlserver-se` | | `-db.i` *instance\$1type* 또는 `--database.instance` *instance\$1type* | 데이터베이스에 대해 사용할 Amazon EC2 인스턴스의 유형입니다. **eb create**를 이 옵션과 함께 실행할 경우 EB CLI는 연결된 데이터베이스가 있는 환경을 시작합니다. 이것은 `--database` 옵션과 함께 명령을 실행하지 않은 경우에도 마찬가지입니다. 유형: 문자열 유효 값: Amazon RDS는 DB 인스턴스의 표준 세트를 지원합니다. DB 엔진에 대해 적절한 DB 인스턴스를 선택하기 위해서는 몇 가지 구체적인 사항을 고려해야 합니다. 자세한 내용은 *Amazon RDS 사용 설명서*의 [DB 인스턴스 클래스](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html) 단원을 참조하십시오. | | `-db.pass` *암호* 또는 `--database.password` *password* | 데이터베이스에 대한 암호입니다. **eb create**를 이 옵션과 함께 실행할 경우 EB CLI는 연결된 데이터베이스가 있는 환경을 시작합니다. 이것은 `--database` 옵션과 함께 명령을 실행하지 않은 경우에도 마찬가지입니다. | | `-db.size` *number\$1of\$1gigabytes* 또는 `--database.size` *number\$1of\$1gigabytes* | 데이터베이스 스토리지에 할당할 기가바이트(GB) 수입니다. **eb create**를 이 옵션과 함께 실행할 경우 EB CLI는 연결된 데이터베이스가 있는 환경을 시작합니다. 이것은 `--database` 옵션과 함께 명령을 실행하지 않은 경우에도 마찬가지입니다. 형식: 숫자 유효한 값: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/elasticbeanstalk/latest/dg/eb3-create.html) | | `-db.user` *username* 또는 `--database.username` *username* | 데이터베이스의 사용자 이름입니다. **eb create**를 이 옵션과 함께 실행할 경우 EB CLI는 `--database` 옵션을 사용하지 않았더라도 연결된 데이터베이스가 있는 환경을 시작합니다. **eb create**를 `--database` 옵션과 함께 실행하고 `--database.username` 및 `--database.password` 옵션은 사용하지 않을 경우 EB CLI는 마스터 데이터베이스 사용자 이름과 암호를 묻는 메시지를 표시합니다. | | `-db.version` *version* 또는 `--database.version` *version* | 데이터베이스 엔진 버전을 지정하는 데 사용됩니다. 이 플래그가 있는 경우 `--database` 플래그가 없더라도 지정된 버전 번호를 가진 데이터베이스에서 환경이 시작됩니다. | | `--elb-type` *type* | [로드 밸런서 유형](using-features.managing.elb.md)입니다. 유형: 문자열 유효한 값: `classic`, `application`, `network` 기본값: `application` | | `-es` 또는 `--enable-spot` | 환경에 대한 스팟 인스턴스 요청을 활성화합니다. 자세한 내용은 [auto scaling](using-features.managing.as.md)을(를) 참조하세요. 관련 옵션: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/elasticbeanstalk/latest/dg/eb3-create.html) | | --env-group-suffix groupname | 환경 이름에 추가할 그룹 이름입니다. [환경 작성](ebcli-compose.md)에서만 사용할 수 있습니다. | | `--envvars` | *name*=*value* 형식이며 쉼표로 분리된 목록의 [환경 속성](environments-cfg-softwaresettings.md)입니다. 제한은 [환경 속성 구성(환경 변수)](environments-cfg-softwaresettings.md#environments-cfg-softwaresettings-console) 단원을 참조하세요. | | `-ip` *profile\$1name* 또는 `--instance_profile` *profile\$1name* | 애플리케이션이 AWS 리소스에 액세스하는 데 필요한 임시 보안 자격 증명이 있는 IAM 역할이 있는 인스턴스 프로파일입니다. | | `-it` 또는 `--instance-types type1[,type2 ...]` | 환경에서 사용할 Amazon EC2 인스턴스 유형의 쉼표로 구분된 목록입니다. 이 옵션을 지정하지 않으면 Elastic Beanstalk에서 기본 인스턴스 유형을 제공합니다. 자세한 내용은 [Amazon EC2 인스턴스](using-features.managing.ec2.md) 및 [auto scaling](using-features.managing.as.md) 단원을 참조하세요. EB CLI는 이 옵션을 스팟 인스턴스에만 적용합니다. 이 옵션은 `--enable-spot` 옵션과 함께 사용하지 않는 한 EB CLI에서 이를 무시합니다. 온디맨드 인스턴스의 인스턴스 유형을 지정하려면 `--intance-type`(‘s’ 없음) 옵션을 대신 사용합니다. | | `-i` 또는 `--instance_type` | 환경에서 사용할 Amazon EC2 인스턴스 유형입니다. 이 옵션을 지정하지 않으면 Elastic Beanstalk에서 기본 인스턴스 유형을 제공합니다. 자세한 내용은 [Amazon EC2 인스턴스](using-features.managing.ec2.md)을(를) 참조하세요. EB CLI는 온디맨드 인스턴스에만 이 옵션을 적용합니다. 이 옵션은 `--enable-spot` 옵션과 함께 사용할 경우 EB CLI가 무시하므로 함께 사용하지 마세요. 스팟 인스턴스의 인스턴스 유형을 지정하려면 `--intance-types`(‘s’ 포함) 옵션을 대신 사용합니다. | | `-k` *key\$1name* 또는 `--keyname` *key\$1name* | Elastic Beanstalk 애플리케이션을 실행하는 Amazon EC2 인스턴스에 안전하게 로그인하기 위해 Secure Shell(SSH) 클라이언트에서 사용할 Amazon EC2 키 페어의 이름입니다. **eb create** 명령에 이 옵션을 포함할 경우 **eb init**으로 지정한 키 이름을 제공된 값으로 덮어씁니다. 유효한 값: Amazon EC2에 등록된 기존 키 이름 | | `-im` *number-of-instances* 또는 `--min-instances` *number-of-instances* | 보유한 환경에 필요한 최소 Amazon EC2 인스턴스 수입니다. 유형: 숫자(정수) 기본값: `1` 유효한 값: `1` \$1 `10000` | | `-ix` *number-of-instances* 또는 `--max-instances` *number-of-instances* | 보유한 환경에 허용할 수 있는 최대 Amazon EC2 인스턴스 수입니다. 유형: 숫자(정수) 기본값: `4` 유효한 값: `1` \$1 `10000` | | `--modules` *component-a component-b* | 생성할 구성 요소 환경의 목록입니다. [환경 작성](ebcli-compose.md)에서만 사용할 수 있습니다. | | `-sb` 또는 `--on-demand-base-capacity` | 환경 확장에 따라 스팟 인스턴스를 고려하기 전에 Auto Scaling 그룹이 프로비저닝하는 최소 온디맨드 인스턴스 수입니다. 이 옵션은 `--enable-spot` 옵션을 통해서만 지정할 수 있습니다. 자세한 내용은 [auto scaling](using-features.managing.as.md)을(를) 참조하세요. 유형: 숫자(정수) 기본값: `0` 유효한 값: `0` \$1 `--max-instances`(없는 경우: [`MaxSize`](command-options-general.md#command-options-general-autoscalingasg) 네임스페이스의 `aws:autoscaling:asg` 옵션) | | `-sp` 또는 `--on-demand-above-base-capacity` | Auto Scaling 그룹이 `--on-demand-base-capacity` 옵션에 지정된 인스턴스 수를 초과하여 Auto Scaling 그룹에 프로비저닝하는 추가 용량의 일부인 온디맨드 인스턴스의 비율입니다. 이 옵션은 `--enable-spot` 옵션을 통해서만 지정할 수 있습니다. 자세한 내용은 [auto scaling](using-features.managing.as.md) 단원을 참조하세요. 유형: 숫자(정수) 기본값: 단일 인스턴스 환경의 경우 `0`, 로드 밸런싱 수행 환경의 경우 `70` 유효한 값: `0` \$1 `100` | | `-p` *platform-version* 또는 `--platform` *platform-version* | 사용할 [플랫폼 버전](concepts.platforms.md)입니다. 플랫폼, 플랫폼 및 버전, 플랫폼 브랜치, 솔루션 스택 이름 또는 솔루션 스택 ARN을 지정할 수 있습니다. 예: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/elasticbeanstalk/latest/dg/eb3-create.html) [`eb platform list`](eb3-platform.md)를 사용하여 사용 가능한 구성 목록을 가져옵니다. `--platform` 옵션을 지정할 경우 `eb init` 중에 제공된 값을 재정의합니다. | | `-pr` 또는 `--process` | 소스 번들의 환경 매니페스트 및 구성 파일을 사전 처리 및 확인합니다. 구성 파일을 확인하면 환경에 애플리케이션 버전을 배포하기 전에 문제를 파악할 수 있습니다. | | `-r` *region* 또는 `--region` *region* | 애플리케이션을 배포하려는 AWS 리전입니다. 이 옵션에 지정할 수 있는 값의 목록은 *AWS 일반 참조*의 [AWS Elastic Beanstalk 엔드포인트 및 할당량을](https://docs.aws.amazon.com/general/latest/gr/elasticbeanstalk.html) 참조하세요. | | `--sample` | 새 환경에 리포지토리의 코드 대신하여 샘플 애플리케이션을 배포합니다. | | `--scale` *number-of-instances* | 지정된 수의 인스턴스로 시작 | | --service-role servicerole | 기본값이 아닌 서비스 역할을 환경에 할당합니다. ARN을 입력하지 마세요. 역할 이름만 입력합니다. Elastic Beanstalk에서는 역할 이름의 접두사로 올바른 값을 지정하여 결과 ARN을 내부적으로 생성합니다. | | `-ls` *load-balancer* 또는 `--shared-lb` *load-balancer* | 공유 로드 밸런서를 사용하도록 환경을 구성합니다. 계정의 공유 가능 로드 밸런서(다른 Elastic Beanstalk 환경에서 생성된 것이 아니라 명시적으로 직접 생성한 Application Load Balancer)의 이름 또는 ARN을 입력합니다. 자세한 내용은 [공유 Application Load Balancer](environments-cfg-alb-shared.md)을(를) 참조하세요. 파라미터 예: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/elasticbeanstalk/latest/dg/eb3-create.html) 이 옵션은 `--elb-type application`과 함께만 지정할 수 있습니다. 이 옵션을 지정하고 `--shared-lb`를 지정하지 않으면 Elastic Beanstalk에서는 환경의 전용 로드 밸런서를 생성합니다. | | `-lp` *port* 또는 `--shared-lb-port` *port* | 이 환경에 대한 공유 로드 밸런서의 기본 리스너 포트입니다. Elastic Beanstalk는 이 리스너의 모든 트래픽을 기본 환경 프로세스로 라우팅하는 리스너 규칙을 추가합니다. 자세한 내용은 [공유 Application Load Balancer](environments-cfg-alb-shared.md)을(를) 참조하세요. 유형: 숫자(정수) 기본값: `80` 유효한 값: 공유 로드 밸런서의 리스너 포트를 나타내는 정수입니다. | | `--single` | 로드 밸런서 없이 단일 Amazon EC2 인스턴스를 사용하여 환경을 생성합니다. 단일 인스턴스 환경에서는 프로덕션을 지원하지 않습니다. 배포 중에 인스턴스가 불안정하게 되거나, Elastic Beanstalk가 구성 업데이트 중 인스턴스를 종료했다가 다시 시작하는 경우 일정 시간 동안 애플리케이션을 사용하지 못할 수 있습니다. 개발, 테스트 또는 스테이징에는 단일 인스턴스 환경을 사용합니다. 프로덕션에는 로드 밸런싱된 환경을 사용합니다. | | `-sm` 또는 `--spot-max-price` | 스팟 인스턴스에 대해 지불하려는 단위 시간당 최고 가격(미국 달러)입니다. 이 옵션은 `--enable-spot` 옵션을 통해서만 지정할 수 있습니다. 자세한 내용은 [auto scaling](using-features.managing.as.md) 단원을 참조하세요. 유형: 숫자(부동 소수점) 기본: 각 인스턴스 유형에 대한 온디맨드 가격입니다. 이 경우 옵션의 값은 `null`입니다. 유효한 값: `0.001`\$1`20.0` 스팟 인스턴스에 대한 최고 가격 옵션 권장 사항에 대해서는 *Amazon EC2 사용 설명서*의 [스팟 인스턴스 요금 기록](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-spot-instances-history.html)을 참조하세요. | | `--tags key1=value1[,key2=value2 ...]` | 환경에서 리소스에 태그를 지정합니다. 태그는 쉼표로 구분된 `key=value` 페어 목록으로 지정됩니다. 자세한 내용은 [환경에 태그 지정](using-features.tagging.md)을(를) 참조하세요. | | `-t worker` 또는 `--tier worker` | 작업자 환경을 생성합니다. 웹 서버 환경을 생성하려면 이 옵션을 생략합니다. | | `--timeout` *minutes* | 명령 시간이 초과되기 전 경과되는 시간(분)을 설정합니다. | | `--version` *version\$1label* | 로컬 프로젝트 디렉터리의 애플리케이션 소스 코드 대신 환경에 배포할 애플리케이션 버전을 지정합니다. 유형: 문자열 유효한 값: 기존 애플리케이션 버전 레이블 | | `--vpc` | 환경에 대해 VPC를 구성합니다. 이 옵션을 포함하는 경우 EB CLI는 환경을 시작하기 전에 모든 필요한 설정을 입력하라는 메시지를 표시합니다. | | `--vpc.dbsubnets subnet1,subnet2` | VPC에서 데이터베이스 인스턴스의 서브넷을 지정합니다. `--vpc.id`를 지정한 경우 필수입니다. | | `--vpc.ec2subnets subnet1,subnet2` | VPC에서 Amazon EC2 인스턴스의 서브넷을 지정합니다. `--vpc.id`를 지정한 경우 필수입니다. | | `--vpc.elbpublic` | VPC의 퍼블릭 서브넷에서 Elastic Load Balancing 로드 밸런서를 시작합니다. 이 옵션은 `--tier worker` 옵션이나 `--single` 옵션과 함께 지정할 수 없습니다. | | `--vpc.elbsubnets subnet1,subnet2` | VPC에서 Elastic Load Balancing 로드 밸런서에 대한 서브넷을 지정합니다. 이 옵션은 `--tier worker` 옵션이나 `--single` 옵션과 함께 지정할 수 없습니다. | | `--vpc.id ID` | 지정된 VPC에서 환경을 시작합니다. | | `--vpc.publicip` | VPC의 퍼블릭 서브넷에서 Amazon EC2 인스턴스를 시작합니다. 이 옵션은 `--tier worker` 옵션과 함께 지정할 수 없습니다. | | `--vpc.securitygroups securitygroup1,securitygroup2` | 보안 그룹 ID를 지정합니다. `--vpc.id`를 지정한 경우 필수입니다. | | [일반 옵션](eb3-cmd-options.md) | | ## 출력 명령이 성공적으로 수행되면 질문 여부를 묻는 메시지가 표시되고 이후 생성 작업 상태가 반환됩니다. 시작 중 문제가 생긴 경우 [**eb events**](eb3-events.md) 작업을 통해 자세한 내용을 확인할 수 있습니다. 애플리케이션의 CodeBuild 지원을 활성화한 경우 **eb create**는 코드가 빌드될 때 CodeBuild의 정보를 표시합니다. Elastic Beanstalk의 CodeBuild 지원에 대한 자세한 내용은 [에서 EB CLI 사용 AWS CodeBuild](eb-cli-codebuild.md)을 참조하세요. ## 예제 다음 예는 대화형 모드에서 환경을 생성합니다. ``` $ eb create Enter Environment Name (default is tmp-dev): ENTER Enter DNS CNAME prefix (default is tmp-dev): ENTER Select a load balancer type 1) classic 2) application 3) network (default is 2): ENTER Environment details for: tmp-dev Application name: tmp Region: us-east-2 Deployed Version: app-141029_145448 Environment ID: e-um3yfrzq22 Platform: 64bit Amazon Linux 2014.09 v1.0.9 running PHP 5.5 Tier: WebServer-Standard-1.0 CNAME: tmp-dev.elasticbeanstalk.com Updated: 2014-10-29 21:54:51.063000+00:00 Printing Status: ... ``` 또한 다음 예에서는 대화형 모드에서 환경을 생성합니다. 이 예의 프로젝트 디렉터리에는 애플리케이션 코드가 없습니다. 이 명령은 샘플 애플리케이션을 배포하고 이를 로컬 프로젝트 디렉터리에 다운로드합니다. ``` $ eb create Enter Environment Name (default is tmp-dev): ENTER Enter DNS CNAME prefix (default is tmp-dev): ENTER Select a load balancer type 1) classic 2) application 3) network (default is 2): ENTER NOTE: The current directory does not contain any source code. Elastic Beanstalk is launching the sample application instead. Do you want to download the sample application into the current directory? (Y/n): ENTER INFO: Downloading sample application to the current directory. INFO: Download complete. Environment details for: tmp-dev Application name: tmp Region: us-east-2 Deployed Version: Sample Application Environment ID: e-um3yfrzq22 Platform: 64bit Amazon Linux 2014.09 v1.0.9 running PHP 5.5 Tier: WebServer-Standard-1.0 CNAME: tmp-dev.elasticbeanstalk.com Updated: 2017-11-08 21:54:51.063000+00:00 Printing Status: ... ``` 다음 명령은 프롬프트를 표시하지 않고 환경을 생성합니다. ``` $ eb create dev-env Creating application version archive "app-160312_014028". Uploading test/app-160312_014028.zip to S3. This may take a while. Upload Complete. Application test has been created. Environment details for: dev-env Application name: test Region: us-east-2 Deployed Version: app-160312_014028 Environment ID: e-6fgpkjxyyi Platform: 64bit Amazon Linux 2015.09 v2.0.8 running PHP 5.6 Tier: WebServer-Standard CNAME: UNKNOWN Updated: 2016-03-12 01:40:33.614000+00:00 Printing Status: ... ``` 다음 명령은 사용자 지정 VPC에서 환경을 생성합니다. ``` $ eb create dev-vpc --vpc.id vpc-0ce8dd99 --vpc.elbsubnets subnet-b356d7c6,subnet-02f74b0c --vpc.ec2subnets subnet-0bb7f0cd,subnet-3b6697c1 --vpc.securitygroup sg-70cff265 Creating application version archive "app-160312_014309". Uploading test/app-160312_014309.zip to S3. This may take a while. Upload Complete. Environment details for: dev-vpc Application name: test Region: us-east-2 Deployed Version: app-160312_014309 Environment ID: e-pqkcip3mns Platform: 64bit Amazon Linux 2015.09 v2.0.8 running Java 8 Tier: WebServer-Standard CNAME: UNKNOWN Updated: 2016-03-12 01:43:14.057000+00:00 Printing Status: ... ``` # **eb deploy** ## 설명 초기화된 프로젝트 디렉터리에서 실행 중인 애플리케이션으로 애플리케이션 소스 번들을 배포합니다. git이 설치되어 있는 경우 EB CLI에서는 `git archive` 명령을 사용하여 최신 `git commit` 명령의 내용에서 `.zip` 파일을 생성합니다. 하지만 프로젝트 디렉터리에 `.ebignore`가 있으면 EB CLI가 소스 번들을 생성하기 위해 git 명령과 구문을 사용하지 않습니다. 즉 EB CLI는 `.ebignore`에 지정된 파일을 무시하고 다른 모든 파일을 포함시킵니다. 특히 커밋되지 않은 소스 파일을 포함시킵니다. **참고** 또한 프로젝트 폴더의 ZIP 파일을 만드는 대신 빌드 프로세스의 결과물을 배포하도록 EB CLI를 구성할 수도 있습니다. 세부 정보는 [프로젝트 폴더 대신 아티팩트 배포](eb-cli3-configuration.md#eb-cli3-artifact) 섹션을 참조하세요. ## 구문 **eb deploy** **eb deploy *environment-name*** ## 옵션 **** | 이름 | 설명 | | --- | --- | | `-l` *version\$1label* 또는 `--label` *version\$1label* | EB CLI가 생성하는 버전에 사용할 레이블을 지정합니다. 레이블이 이미 사용된 경우 EB CLI는 해당 레이블을 사용하는 이전 버전을 다시 배포합니다. 유형: 문자열 | | --env-group-suffix groupname | 환경 이름에 추가할 그룹 이름입니다. [환경 작성](ebcli-compose.md)에서만 사용할 수 있습니다. | | `-m` "*version\$1description*" 또는 `--message` "*version\$1description*" | 애플리케이션 버전에 대한 설명으로, 큰 따옴표로 둘러싸여 있습니다. 유형: 문자열 | | `--modules` *component-a component-b* | 업데이트할 구성 요소 목록입니다. [환경 작성](ebcli-compose.md)에서만 사용할 수 있습니다. | | `-p` 또는 `--process` | 소스 번들의 환경 매니페스트 및 구성 파일을 사전 처리 및 확인합니다. 구성 파일을 확인하면 환경에 애플리케이션 버전을 배포하기 전에 문제를 파악할 수 있습니다. | | `--source codecommit/repository-name/branch-name` | CodeCommit 리포지토리 및 브랜치. | | `--staged` | HEAD 커밋 대신 git 인덱스에서 준비된 파일을 배포합니다. | | `--timeout` *minutes* | 명령 시간이 초과되기 전 경과되는 시간(분)입니다. | | `--version` *version\$1label* | 배포할 기존 애플리케이션 버전 유형: 문자열 | | [일반 옵션](eb3-cmd-options.md) | | ## 출력 성공할 경우 명령이 `deploy` 작업의 상태를 반환합니다. 애플리케이션의 CodeBuild 지원을 활성화한 경우 **eb deploy**는 코드가 빌드될 때 CodeBuild의 정보를 표시합니다. Elastic Beanstalk의 CodeBuild 지원에 대한 자세한 내용은 [에서 EB CLI 사용 AWS CodeBuild](eb-cli-codebuild.md)을 참조하세요. ## 예제 다음 예제에서는 현재 애플리케이션을 배포합니다. ``` $ eb deploy 2018-07-11 21:05:22 INFO: Environment update is starting. 2018-07-11 21:05:27 INFO: Deploying new version to instance(s). 2018-07-11 21:05:53 INFO: New application version was deployed to running EC2 instances. 2018-07-11 21:05:53 INFO: Environment update completed successfully. ``` # **eb events** ## 설명 최신 환경 이벤트를 반환합니다. 루트 디렉터리에 사용자 지정 플랫폼을 지정하는 `platform.yaml` 파일이 들어 있는 경우, 이 명령은 빌더 환경의 최신 이벤트도 반환합니다. ## 구문 **eb events** **eb events *environment-name*** ## 옵션 **** | 이름 | 설명 | | --- | --- | | `-f` 또는 `--follow` | 이벤트를 스트리밍합니다. 취소하려면 CTRL\$1C를 누릅니다. | ## 출력 성공하면 명령이 최근 이벤트를 반환합니다. ## 예제 다음은 최근 이벤트를 반환하는 예제입니다. ``` $ eb events 2014-10-29 21:55:39 INFO createEnvironment is starting. 2014-10-29 21:55:40 INFO Using elasticbeanstalk-us-west-2-111122223333 as Amazon S3 storage bucket for environment data. 2014-10-29 21:55:57 INFO Created load balancer named: awseb-e-r-AWSEBLoa-NSKUOK5X6Z9J 2014-10-29 21:56:16 INFO Created security group named: awseb-e-rxgrhjr9bx-stack-AWSEBSecurityGroup-1UUHU5LZ20ZY7 2014-10-29 21:57:18 INFO Waiting for EC2 instances to launch. This may take a few minutes. 2014-10-29 21:57:18 INFO Created Auto Scaling group named: awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingGroup-1TE320ZCJ9RPD 2014-10-29 21:57:22 INFO Created Auto Scaling group policy named: arn:aws:autoscaling:us-east-2:11122223333:scalingPolicy:2cced9e6-859b-421a-be63-8ab34771155a:autoScalingGroupName/awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingGroup-1TE320ZCJ9RPD:policyName/awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingScaleUpPolicy-1I2ZSNVU4APRY 2014-10-29 21:57:22 INFO Created Auto Scaling group policy named: arn:aws:autoscaling:us-east-2:11122223333:scalingPolicy:1f08b863-bf65-415a-b584-b7fa3a69a0d5:autoScalingGroupName/awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingGroup-1TE320ZCJ9RPD:policyName/awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingScaleDownPolicy-1E3G7PZKZPSOG 2014-10-29 21:57:25 INFO Created CloudWatch alarm named: awseb-e-rxgrhjr9bx-stack-AWSEBCloudwatchAlarmLow-VF5EJ549FZBL 2014-10-29 21:57:25 INFO Created CloudWatch alarm named: awseb-e-rxgrhjr9bx-stack-AWSEBCloudwatchAlarmHigh-LA9YEW3O6WJO 2014-10-29 21:58:50 INFO Added EC2 instance 'i-c7ee492d' to Auto ScalingGroup 'awseb-e-rxgrhjr9bx-stack-AWSEBAutoScalingGroup-1TE320ZCJ9RPD'. 2014-10-29 21:58:53 INFO Successfully launched environment: tmp-dev 2014-10-29 21:59:14 INFO Environment health has been set to GREEN 2014-10-29 21:59:43 INFO Adding instance 'i-c7ee492d' to your environment. ``` # **eb health** ## 설명 환경의 최신 상태를 반환합니다. 루트 디렉터리에 사용자 지정 플랫폼을 지정하는 `platform.yaml` 파일이 들어 있는 경우, 이 명령은 빌더 환경의 최신 상태도 반환합니다. ## 구문 **eb health** **eb health *environment-name*** ## 옵션 **** | 이름 | 설명 | | --- | --- | | `-r` 또는 `--refresh` | 상태 정보는 대화식으로 표시되며 새 정보가 보고됨에 따라 10초마다 업데이트됩니다. | | --mono | 출력에 색상을 표시하지 마세요. | ## 출력 성공하면 명령이 최근 상태를 반환합니다. ## 예제 다음은 Linux 환경에 대한 가장 최근의 상태 정보를 반환하는 예제입니다. ``` ~/project $ eb health elasticBeanstalkExa-env Ok 2015-07-08 23:13:20 WebServer Ruby 2.1 (Puma) total ok warning degraded severe info pending unknown 5 5 0 0 0 0 0 0 instance-id status cause health Overall Ok i-d581497d Ok i-d481497c Ok i-136e00c0 Ok i-126e00c1 Ok i-8b2cf575 Ok instance-id r/sec %2xx %3xx %4xx %5xx p99 p90 p75 p50 p10 requests Overall 671.8 100.0 0.0 0.0 0.0 0.003 0.002 0.001 0.001 0.000 i-d581497d 143.0 1430 0 0 0 0.003 0.002 0.001 0.001 0.000 i-d481497c 128.8 1288 0 0 0 0.003 0.002 0.001 0.001 0.000 i-136e00c0 125.4 1254 0 0 0 0.004 0.002 0.001 0.001 0.000 i-126e00c1 133.4 1334 0 0 0 0.003 0.002 0.001 0.001 0.000 i-8b2cf575 141.2 1412 0 0 0 0.003 0.002 0.001 0.001 0.000 instance-id type az running load 1 load 5 user% nice% system% idle% iowait% cpu i-d581497d t2.micro 1a 12 mins 0.0 0.04 6.2 0.0 1.0 92.5 0.1 i-d481497c t2.micro 1a 12 mins 0.01 0.09 5.9 0.0 1.6 92.4 0.1 i-136e00c0 t2.micro 1b 12 mins 0.15 0.07 5.5 0.0 0.9 93.2 0.0 i-126e00c1 t2.micro 1b 12 mins 0.17 0.14 5.7 0.0 1.4 92.7 0.1 i-8b2cf575 t2.micro 1c 1 hour 0.19 0.08 6.5 0.0 1.2 92.1 0.1 instance-id status id version ago deployments i-d581497d Deployed 1 Sample Application 12 mins i-d481497c Deployed 1 Sample Application 12 mins i-136e00c0 Deployed 1 Sample Application 12 mins i-126e00c1 Deployed 1 Sample Application 12 mins i-8b2cf575 Deployed 1 Sample Application 1 hour ``` # **eb init** ## 설명 일련의 질문을 물어 EB CLI를 사용하여 만든 Elastic Beanstalk 애플리케이션의 기본값을 설정합니다. **참고** **eb init**로 설정한 값은 현재 컴퓨터의 현재 디렉터리 및 리포지토리에 적용됩니다. 이 명령은 사용자의 계정에 Elastic Beanstalk 애플리케이션을 생성합니다. Elastic Beanstalk 환경을 생성하려면 **[eb create](eb3-create.md)**를 실행한 후 **eb init**를 실행합니다. ## 구문 **eb init** **eb init** *application-name* ## 옵션 `--platform` 옵션을 지정하지 않고 **eb init**를 실행하면 EB CLI가 각 설정에 값을 입력하라는 메시지를 표시합니다. **참고** **eb init**를 통해 새 키 페어를 생성하려면 로컬 시스템에 `ssh-keygen`이 설치되어 있고 명령줄에 입력할 수 있어야 합니다. **** | 이름 | 설명 | | | --- | --- | --- | | `-i` `--interactive` | EB CLI가 모든 **eb init** 명령 옵션에 값을 제공하라는 메시지를 표시합니다. `init` 명령은 (기본)값이 없는 **eb init** 명령 옵션에 값을 제공하라는 메시지를 표시합니다. 디렉터리에서 **eb init** 명령을 처음 실행한 후에는 EB CLI가 어떤 명령 옵션에 대한 메시지도 표시하지 않을 수 있습니다. 따라서 이전에 설정한 설정을 변경하고자 하는 경우 `--interactive` 옵션을 사용하십시오. | | | `-k` *keyname* `--keyname` *keyname* | Elastic Beanstalk 애플리케이션을 실행하는 Amazon EC2 인스턴스에 안전하게 로그인하기 위해 SSH(Secure Shell) 클라이언트에서 사용할 Amazon EC2 키 페어의 이름입니다. | | | `--modules folder-1 folder-2` | 초기화할 하위 디렉터리 목록입니다. [환경 작성](ebcli-compose.md)에서만 사용할 수 있습니다. | | | `-p` *platform-version* `--platform` *platform-version* | 사용할 [플랫폼 버전](concepts.platforms.md)입니다. 플랫폼, 플랫폼 및 버전, 플랫폼 브랜치, 솔루션 스택 이름 또는 솔루션 스택 ARN을 지정할 수 있습니다. 예: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/elasticbeanstalk/latest/dg/eb3-init.html) [`eb platform list`](eb3-platform.md)를 사용하여 사용 가능한 구성 목록을 가져옵니다. 대화형 구성을 건너뛰도록 `--platform` 옵션을 지정합니다. 이 옵션을 지정하면 EB CLI가 기타 모든 옵션에 값을 제공하라는 메시지를 표시하지 않습니다. 대신에 각 옵션에 대해 기본값을 가정합니다. 기본값을 사용하지 않으려는 항목에 대해 옵션을 지정할 수 있습니다. | | | `--source codecommit/repository-name/branch-name` | CodeCommit 리포지토리 및 브랜치. | | | `--tags key1=value1[,key2=value2 ...]` | 애플리케이션에 태그를 지정합니다. 태그는 쉼표로 구분된 `key=value` 페어 목록으로 지정됩니다. 자세한 내용은 [애플리케이션 태그 지정](applications-tagging.md) 섹션을 참조하세요. | | [일반 옵션](eb3-cmd-options.md) | | | ## CodeBuild 지원 [buildspec.yml](https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html) 파일이 들어 있는 폴더에서 **eb init**을 실행하는 경우 Elastic Beanstalk는 **eb\$1codebuild\$1settings** 항목에 대한 파일을 Elastic Beanstalk에 고유한 옵션으로 구문 분석합니다. Elastic Beanstalk의 CodeBuild 지원에 대한 자세한 내용은 [에서 EB CLI 사용 AWS CodeBuild](eb-cli-codebuild.md)을 참조하세요. ## 출력 성공할 경우 명령이 일련의 프롬프트를 통해 새 Elastic Beanstalk 애플리케이션을 설정하는 과정을 안내합니다. ## 예제 다음 요청 예제에서는 EB CLI를 시작하고 애플리케이션에 대한 정보를 입력하라는 메시지를 표시합니다. *자리 표시자* 텍스트를 해당 값으로 바꾸십시오. ``` $ eb init -i Select a default region 1) us-east-1 : US East (N. Virginia) 2) us-west-1 : US West (N. California) 3) us-west-2 : US West (Oregon) 4) eu-west-1 : Europe (Ireland) 5) eu-central-1 : Europe (Frankfurt) 6) ap-south-1 : Asia Pacific (Mumbai) 7) ap-southeast-1 : Asia Pacific (Singapore) ... (default is 3): 3 Select an application to use 1) HelloWorldApp 2) NewApp 3) [ Create new Application ] (default is 3): 3 Enter Application Name (default is "tmp"): Application tmp has been created. It appears you are using PHP. Is this correct? (y/n): y Select a platform branch. 1) PHP 7.2 running on 64bit Amazon Linux 2) PHP 7.1 running on 64bit Amazon Linux (Deprecated) 3) PHP 7.0 running on 64bit Amazon Linux (Deprecated) 4) PHP 5.6 running on 64bit Amazon Linux (Deprecated) 5) PHP 5.5 running on 64bit Amazon Linux (Deprecated) 6) PHP 5.4 running on 64bit Amazon Linux (Deprecated) (default is 1): 1 Do you want to set up SSH for your instances? (y/n): y Select a keypair. 1) aws-eb 2) [ Create new KeyPair ] (default is 2): 1 ``` # **eb labs** ## 설명 **eb labs**의 하위 명령은 진행 중인 작업 또는 실험적 기능을 지원합니다. 이러한 명령은 향후 EB CLI 버전에서 제거되거나 재작업될 수 있으며, 이후 버전과의 호환성이 보장되지 않습니다. 사용 가능한 하위 명령 목록 및 설명을 보려면 **eb labs --help**를 실행하세요. # **eb list** ## 설명 `--all` 옵션에 지정된 대로 현재 애플리케이션의 모든 환경 또는 모든 애플리케이션의 모든 환경을 나열합니다. 루트 디렉터리에 사용자 지정 플랫폼을 지정하는 `platform.yaml` 파일이 들어 있는 경우, 이 명령은 빌더 환경도 나열합니다. ## 구문 **eb list** ## 옵션 **** | 이름 | 설명 | | --- | --- | | `-a` 또는 `--all` | 모든 애플리케이션의 모든 환경을 나열합니다. | | `-v` 또는 `--verbose` | 인스턴스를 포함하여 모든 환경에 대한 더 세부적인 정보를 제공합니다. | | [일반 옵션](eb3-cmd-options.md) | | ## 출력 성공할 경우 이 명령은 현재 환경이 별표(\$1)로 표시된 환경 이름 목록을 반환합니다. ## 예 1 다음 예에서는 환경을 나열하고 tmp-dev가 기본 환경임을 나타냅니다. ``` $ eb list * tmp-dev ``` ## 예 2 다음 예에서는 환경과 추가 세부 정보를 나열합니다. ``` $ eb list --verbose Region: us-west-2 Application: tmp Environments: 1 * tmp-dev : ['i-c7ee492d'] ``` # **eb local** ## 설명 **eb local run**을 사용하여 Docker에서 애플리케이션의 컨테이너를 로컬로 실행합니다. **eb local status**를 사용하여 애플리케이션의 컨테이너 상태를 확인합니다. **eb local open**을 사용하여 웹 브라우저에서 애플리케이션을 엽니다. **eb local logs**를 사용하여 애플리케이션의 로그 위치를 검색합니다. **eb local setenv** 및 **eb local printenv**를 통해 **eb local run**을 사용하여 로컬로 실행하는 Docker 컨테이너에 제공되는 환경 변수를 설정하고 볼 수 있습니다. **eb local**를 사용하여 EB CLI 리포지토리로 초기화된 Docker 애플리케이션의 프로젝트 디렉터리에서 모든 **eb init** 명령을 실행해야 합니다. **참고** Linux 또는 macOS를 실행하는 로컬 컴퓨터에서 **eb local**을 사용합니다. 이 명령은 Windows를 지원하지 않습니다. macOS에서 이 명령을 사용하기 전에 Mac용 Docker를 설치하고 boot2docker가 설치되어 있지 않거나 실행 경로에 없는지 확인합니다. **eb local** 명령은 boot2docker(있는 경우)를 사용하려고 하지만 macOS에서는 boot2docker와 제대로 작동하지 않습니다. ## 구문 **eb local run** **eb local status** **eb local open** **eb local logs** **eb local setenv** **eb local printenv** ## 옵션 **eb local run** **** | 이름 | 설명 | | --- | --- | | `--envvars key1=value1,key2=value2` | EB CLI가 로컬 Docker 컨테이너에 전달할 환경 변수를 설정합니다. 멀티컨테이너 환경에서 모든 변수는 모든 컨테이너로 전달됩니다. | | `--port hostport` | 호스트의 포트를 컨테이너의 노출된 포트로 매핑합니다. 이 옵션을 지정하지 않으면 EB CLI가 호스트와 컨테이너에서 동일한 포트를 사용합니다. 이 옵션은 Docker 플랫폼 애플리케이션에서만 사용할 수 있습니다. 멀티컨테이너 Docker 플랫폼에는 적용되지 않습니다. | | [일반 옵션](eb3-cmd-options.md) | | **eb local status** **eb local open** **eb local logs** **eb local setenv** **eb local printenv** **** | 이름 | 설명 | | --- | --- | | [일반 옵션](eb3-cmd-options.md) | | ## 출력 **eb local run** Docker의 상태 메시지입니다. 애플리케이션이 실행 중인 한 활성 상태를 유지합니다. 애플리케이션을 중지하려면 **Ctrl\$1C**를 누릅니다. **eb local status** 애플리케이션(실행 여부와 상관없음)에서 사용하는 각 컨테이너의 상태입니다. **eb local open** 웹 브라우저에서 애플리케이션을 열고 종료합니다. **eb local logs** **eb local run**을 통해 로컬로 실행되는 애플리케이션이 프로젝트 디렉터리에 생성하는 로그의 위치입니다. **eb local setenv** 없음 **eb local printenv** **eb local setenv**를 사용하여 설정되는 환경 변수의 이름과 값입니다. ## 예제 **eb local run** ``` ~/project$ eb local run Creating elasticbeanstalk_phpapp_1... Creating elasticbeanstalk_nginxproxy_1... Attaching to elasticbeanstalk_phpapp_1, elasticbeanstalk_nginxproxy_1 phpapp_1 | [23-Apr-2015 23:24:25] NOTICE: fpm is running, pid 1 phpapp_1 | [23-Apr-2015 23:24:25] NOTICE: ready to handle connections ``` **eb local status** 로컬 컨테이너의 상태를 봅니다. ``` ~/project$ eb local status Platform: 64bit Amazon Linux 2014.09 v1.2.1 running Multi-container Docker 1.3.3 (Generic) Container name: elasticbeanstalk_nginxproxy_1 Container ip: 127.0.0.1 Container running: True Exposed host port(s): 80 Full local URL(s): 127.0.0.1:80 Container name: elasticbeanstalk_phpapp_1 Container ip: 127.0.0.1 Container running: True Exposed host port(s): None Full local URL(s): None ``` **eb local logs** 현재 프로젝트의 로그 경로를 봅니다. ``` ~/project$ eb local logs Elastic Beanstalk will write logs locally to /home/user/project/.elasticbeanstalk/logs/local. Logs were most recently created 3 minutes ago and written to /home/user/project/.elasticbeanstalk/logs/local/150420_234011665784. ``` **eb local setenv** **eb local run**과 함께 사용할 환경 변수를 설정합니다. ``` ~/project$ eb local setenv PARAM1=value ``` **eb local setenv**를 사용하여 설정하는 환경 변수를 인쇄합니다. ``` ~/project$ eb local printenv Environment Variables: PARAM1=value ``` # **eb logs** ## 설명 **eb logs** 명령에는 CloudWatch Logs에 대한 로그 스트리밍을 활성화 또는 비활성화하고, 인스턴스 로그 또는 CloudWatch Logs 로그를 검색하고, 환경에 대한 AI 기반 분석을 요청하는 세 가지 목적이 있습니다. 이 명령은 `--cloudwatch-logs`(`-cw`) 옵션을 사용하여 로그 스트리밍을 활성화하거나 비활성화합니다. `--analyze` (`-ai`) 옵션을 사용하면 명령이 환경의 로그, 이벤트 및 인스턴스 상태에 대한 AI 기반 분석을 요청합니다. 이러한 옵션 중 하나가 없으면 로그를 검색합니다. 로그를 검색할 때 `--all`, `--zip`, `--stream` 등의 옵션을 지정하여 전체 로그를 검색할 수 있습니다. 이러한 옵션을 지정하지 않으면 Elastic Beanstalk는 테일 로그를 검색합니다. 이 명령은 지정된 환경 또는 기본 환경의 로그를 처리합니다. 관련 로그는 컨테이너 유형에 따라 다릅니다. 루트 디렉터리에 사용자 지정 플랫폼을 지정하는 `platform.yaml` 파일이 포함된 경우, 해당 명령은 빌더 환경의 로그 또한 처리합니다. 자세한 내용은 [Amazon CloudWatch Logs에서 Elastic Beanstalk 사용](AWSHowTo.cloudwatchlogs.md) 단원을 참조하십시오. AI 기반 분석에 대한 자세한 내용은 섹션을 참조하세요[AI 기반 환경 분석](health-ai-analysis.md). ## 구문 CloudWatch Logs로의 로그 스트리밍을 활성화하거나 비활성화하려면: ``` eb logs --cloudwatch-logs [enable | disable] [--cloudwatch-log-source instance | environment-health | all] [environment-name] ``` 인스턴스 로그를 검색하려면: ``` eb logs [-all | --zip | --stream] [--cloudwatch-log-source instance] [--instance instance-id] [--log-group log-group] [environment-name] ``` 환경 상태 로그를 검색하려면: ``` eb logs [-all | --zip | --stream] --cloudwatch-log-source environment-health [environment-name] ``` AI 기반 분석을 요청하려면: ``` eb logs --analyze [environment-name] ``` ## 옵션 **** | 이름 | 설명 | | --- | --- | | `-cw [enable \| disable]` 또는 `--cloudwatch-logs [enable \| disable]` | CloudWatch Logs로의 로그 스트리밍을 활성화하거나 비활성화합니다. 인수를 입력하지 않으면 로그 스트리밍이 활성화됩니다. `--cloudwatch-log-source`(`-cls`) 옵션을 추가로 지정하지 않으면 인스턴스 로그 스트리밍이 활성화되거나 비활성화됩니다. | | `-cls instance \| environment-health \| all` 또는 `--cloudwatch-log-source instance \| environment-health \| all` | CloudWatch Logs를 사용할 때 로그 소스를 지정합니다. 활성화 또는 비활성화 명령을 사용하여 CloudWatch Logs 스트리밍을 활성화하거나 비활성화할 로그입니다. 검색 명령을 사용하여 CloudWatch Logs에서 검색할 로그입니다. 유효한 값: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/elasticbeanstalk/latest/dg/eb3-logs.html) 값의 의미: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/elasticbeanstalk/latest/dg/eb3-logs.html) | | `-a` 또는 `--all` | 전체 로그를 검색하고 이를 `.elasticbeanstalk/logs` 디렉터리에 저장합니다. | | `-z` 또는 `--zip` | 전체 로그를 검색하고, 이를 `.zip` 파일로 압축한 후, 해당 파일을 `.elasticbeanstalk/logs` 디렉터리에 저장합니다. | | `--stream` | 스트림(연속 출력)에서 로그를 작성합니다. 이 옵션을 사용하면 명령이 중단할 때까지 실행됩니다(**Ctrl\$1C** 누름). | | `-i instance-id` 또는 `--instance instance-id` | 지정된 인스턴스의 로그만 검색합니다. | | `-g log-group` 또는 `--log-group log-group` | 로그를 검색할 CloudWatch Logs 로그 그룹을 지정합니다. 이 옵션은 CloudWatch Logs로의 인스턴스 로그 스트리밍이 활성화된 경우에만 유효합니다. 인스턴스 로그 스트리밍을 활성화하고 `--log-group` 옵션을 지정하지 않으면 다음 중 하나가 기본 로그 그룹으로 설정됩니다: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/elasticbeanstalk/latest/dg/eb3-logs.html) 각 로그 파일에 해당하는 로그 그룹과 관련된 자세한 내용은 [Elastic Beanstalk로 CloudWatch Logs를 설정하는 방법](AWSHowTo.cloudwatchlogs.md#AWSHowTo.cloudwatchlogs.loggroups)을 참조하세요. | | `-ai` 또는 `--analyze` | 환경의 로그, 이벤트 및 인스턴스 상태에 대한 AI 기반 분석을 요청합니다. 이 분석은 Amazon Bedrock을 사용하여 근본 원인을 식별하고 환경 상태 문제에 대한 솔루션을 권장합니다. 명령은 요청을 보내고 분석이 완료될 때까지 기다린 다음 결과를 표시합니다. 이 옵션은 `--instance`, , `--all`, `--log-group`또는 `--zip`와 호환되지 않습니다`--cloudwatch-logs`. 사전 조건 및 필수 권한은 섹션을 참조하세요[AI 기반 환경 분석](health-ai-analysis.md). | | [일반 옵션](eb3-cmd-options.md) | | ## 출력 기본적으로 로그를 터미널에 직접 표시됩니다. 페이징 프로그램을 사용하여 출력을 표시합니다. **Q** 또는 **q**를 눌러 종료합니다. `--stream`을 사용하면, 터미널에 기존 로그를 함께 표시하고 실행을 유지합니다. **Ctrl\$1C**를 눌러 종료합니다. `--all` 및 `--zip`을 사용하면, 로그를 로컬 파일에 저장하고 파일 위치를 표시합니다. 를 사용하면 분석이 완료된 후가 터미널에 AI 생성 분석을 직접 `--analyze`표시합니다. ## 예제 다음 예는 CloudWatch Logs로의 인스턴스 로그 스트리밍을 활성화합니다. ``` $ eb logs -cw enable Enabling instance log streaming to CloudWatch for your environment After the environment is updated you can view your logs by following the link: https://console.aws.amazon.com/cloudwatch/home?region=us-east-1#logs:prefix=/aws/elasticbeanstalk/environment-name/ Printing Status: 2018-07-11 21:05:20 INFO: Environment update is starting. 2018-07-11 21:05:27 INFO: Updating environment environment-name's configuration settings. 2018-07-11 21:06:45 INFO: Successfully deployed new configuration to environment. ``` 다음 예는 `.zip` 파일로 인스턴스 로그를 검색합니다. ``` $ eb logs --zip Retrieving logs... Logs were saved to /home/workspace/environment/.elasticbeanstalk/logs/150622_173444.zip ``` 다음 예시에서는 환경에 대한 AI 기반 분석을 요청합니다. ``` $ eb logs --analyze Analyzing environment... No critical issues detected. Environment appears healthy. --- Note: This analysis was generated by AI. ``` # **eb migrate** ## 설명 인터넷 정보 서비스(IIS) 사이트와 애플리케이션을 Windows 서버에서 Elastic Beanstalk으로 마이그레이션합니다. 이 명령은 애플리케이션을 패키징하고 구성 정보를 보존한 뒤, 새로운 Elastic Beanstalk 환경에 배포합니다. IIS 사이트 및 애플리케이션 마이그레이션에 대한 자세한 내용은 [Elastic Beanstalk로 IIS 애플리케이션 마이그레이션](dotnet-migrating-applications.md) 섹션을 참조하세요. **참고** 이 명령어를 사용하기 전에 시스템이 다음 요구 사항을 충족하는지 확인하세요. IIS(인터넷 정보 서비스) 버전 7.0 이상 Web Deploy 3.6 이상이 설치됨 Windows 서버에 대한 관리 권한 AWS 적절한 권한으로 구성된 자격 증명 소스 서버에는 AWS 서비스에 대한 아웃바운드 인터넷 액세스 권한이 있습니다. 다음 단계는 마이그레이션 절차를 요약한 것입니다. 1. IIS 사이트 및 해당 구성을 검색합니다. 1. 애플리케이션 콘텐츠와 구성을 패키징합니다. 1. Elastic Beanstalk 환경 및 애플리케이션을 생성합니다. 1. 보존된 설정으로 애플리케이션을 배포합니다. 이 명령은 다음과 같이 구조화된 디렉터리에 마이그레이션 아티팩트를 생성합니다. ``` C:\migration_workspace\ └── .\migrations\latest\ ├── upload_target.zip └── upload_target\ ├── [SiteName].zip # One ZIP per default application of IIS site ├── [SiteName-ApplicationName].zip # One ZIP per additional application ├── aws-windows-deployment-manifest.json └── ebmigrateScripts\ ├── site_installer.ps1 # Site installation scripts ├── permission_handler.ps1 # Permission management └── other helper scripts ``` **eb migrate cleanup**을 사용하여 이러한 아티팩트를 관리합니다. ## 구문 **eb migrate *[options]*** **eb migrate explore *[options]*** **eb migrate cleanup *[options]*** 인수를 지정하지 않고 실행하면 **eb migrate**가 비대화형 모드로 동작합니다. 대화형 모드로 실행하려면 **eb migrate --interactive**를 실행하세요. 대화형 모드 명령은 다음 정보를 묻는 프롬프트를 표시합니다. + 마이그레이션하려는 IIS 사이트 선택 + 환경 및 애플리케이션 이름 + 플랫폼 버전 선택 + 인스턴스 유형 및 기타 구성 옵션 ## 하위 명령 ### explore **eb migrate explore** 하위 명령은 IIS 서버를 검사하여 사용 가능한 사이트 목록을 출력합니다. 다음 정보를 표시하려면 이 명령을 사용하세요. + 서버에 있는 모든 IIS 사이트 보기 + `--verbose`를 사용하면 다음을 포함한 상세 설정을 확인할 수 있습니다. + 사이트 바인딩 및 포트 + 애플리케이션 풀 + 가상 디렉터리 및 물리적 경로 + 인증 설정 ``` PS C:\migrations_workspace > eb migrate explore Default Web Site Site2 site3 router ``` ``` PS C:\migrations_workspace > eb migrate explore --verbose 1: Default Web Site: - Bindings: - *:8083: - Application '/': - Application Pool: DefaultAppPool - Enabled Protocols: http - Virtual Directories: - /: - Physical Path: C:\inetpub\wwwroot - Logon Method: ClearText - Application '/dotnet-6-0': - Application Pool: DefaultAppPool - Enabled Protocols: http - Virtual Directories: - /: - Physical Path: C:\inetpub\AspNetCoreWebApps\CoreWebApp-6-0 - Logon Method: ClearText - Application '/dotnet-8-0': - Application Pool: DefaultAppPool - Enabled Protocols: http - Virtual Directories: - /: - Physical Path: C:\inetpub\AspNetCoreWebApps\CoreWebApp-8-0 - Logon Method: ClearText 2: Site2: - Bindings: - *:8081: ... ``` ### 정리 **eb migrate cleanup** 하위 명령은 다음 작업을 통해 마이그레이션 아티팩트를 관리합니다 + `./migrations/latest`에서 가장 최근의 성공적인 마이그레이션 보존 + 이전 마이그레이션 디렉터리 제거 + 중요한 구성 파일 유지 ``` PS C:\migrations_workspace > eb migrate cleanup Are you sure you would like to cleanup older artifacts within `./migrations/`? (y/N): ``` 정리 작업 중 확인 프롬프트를 건너뛰려면 `--force`를 사용하세요. ``` PS C:\migrations_workspace > eb migrate cleanup --force ``` ## 옵션 이러한 옵션이 필요하지 않습니다. 옵션 없이 **eb migrate**를 실행하면 EB CLI는 비대화형 모드로 작동합니다. **eb migrate --interactive**를 사용하면 EB CLI가 필수 설정 값을 입력하거나 선택하라는 프롬프트를 표시합니다. **** | 이름 | 설명 | | --- | --- | | `-a` *application-name* 또는 `--application-name` *application-name* | 새 Elastic Beanstalk 애플리케이션의 이름입니다. 유형: 문자열 기본값: EBMigratedApp | | `--archive` *directory-or-zip* | 이전 단계에서 **eb migrate --archive-only**로 생성된 소스 코드를 포함한 디렉터리 또는 ZIP 파일입니다. 이전에 생성한 마이그레이션 패키지를 배포하려면 이 옵션을 사용하세요. 예: `--archive .\migrations\latest\upload_target` 또는 `--archive .\migrations\latest\upload_target.zip` | | `-ao` 또는 `--archive-only` | 배포 없이 대상 아카이브 디렉터리만 생성합니다. 생성된 디렉터리는 **eb migrate**과 함께 `archive` 옵션을 사용하거나 **eb deploy**를 통해 수동 배포할 수 있습니다. | | `-c` *subdomain-name* 또는 `--cname` *subdomain-name* | 마이그레이션된 애플리케이션의 CNAME DNS 항목 앞에 붙일 하위 도메인 이름입니다. 유형: 문자열 기본값: 환경 이름 | | `-cf` 또는 `--copy-firewall-config` | 모든 활성 바인딩이 설정된 HTTP 포트에 대해 소스 서버의 방화벽 구성을 대상 서버에 복사합니다. 에서 해당 보안 그룹 규칙을 생성합니다 AWS. | | `-es` *snapshot-id* [*snapshot-id* ...] 또는 `--ebs-snapshots` *snapshot-id* [*snapshot-id* ...] | 환경에 연결할 Amazon EBS 스냅샷 ID 목록(쉼표로 구분)입니다. 예시: `--ebs-snapshots snap-1234567890abcdef0, snap-0987654321fedcba1` | | `--encrypt-ebs-volumes` | 모든 신규 Amazon EBS 볼륨에 대해 암호화를 적용합니다. 이 설정은 계정 전체에 적용되며 이후 생성되는 모든 Amazon EBS 볼륨에 영향을 미칩니다. | | `-e` *environment-name* 또는 `--environment-name` *environment-name* | 새로운 Elastic Beanstalk 환경의 이름입니다. 유형: 문자열 기본값: EBMigratedEnv 제약 요건: 길이는 4\$140자여야 합니다. 문자, 숫자 및 하이픈만 포함될 수 있습니다. 하이픈으로 시작되거나 끝날 수 없습니다. | | `--force` | 작업 중에 확인 프롬프트를 건너뜁니다. **cleanup** 하위 명령과 함께 사용하면 확인 없이 마이그레이션 아티팩트를 제거합니다. | | `-ip` *profile-name* 또는 `--instance-profile` *profile-name* | 환경의 Amazon EC2 인스턴스에 연결할 인스턴스 프로파일입니다. 별도로 지정하지 않으면 Elastic Beanstalk 리소스에 액세스할 수 있는 권한이 포함된 기본 인스턴스 프로파일이 생성됩니다. 자세한 내용은 [Elastic Beanstalk 인스턴스 프로파일](concepts-roles-instance.md) 단원을 참조하십시오. | | `-i` *인스턴스 유형* 또는 `--instance-type` *인스턴스 유형* | Elastic Beanstalk 환경에 대한 Amazon EC2 인스턴스 유형 유형: 문자열 기본값: c5.2xlarge 사용 가능한 인스턴스 유형은 *Amazon EC2 사용 설명서*의 [Amazon EC2 인스턴스 유형](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html)을 참조하세요. | | `-in` 또는 `--interactive` | 마이그레이션 프로세스를 대화형 모드로 강제로 실행하세요. 기본값을 사용할 수 있는 경우에도 구성 값을 묻는 프롬프트가 표시됩니다. | | `-k` *key-name* 또는 `--keyname` *key-name* | 환경 인스턴스에 대한 RDP 액세스를 활성화하는 Amazon EC2 키 페어입니다. 로그에서 확인할 수 없는 인스턴스 수준 문제를 조사할 때 유용합니다. 유효한 값: Amazon EC2에 등록된 기존 키 페어 이름 | | `-p` *platform-version* 또는 `--platform` *platform-version* | 환경에 사용할 Elastic Beanstalk 플랫폼 런타임입니다. 별도로 지정하지 않으면 호스트 Windows Server 버전에서 자동으로 감지됩니다. 예시: `"64bit Windows Server 2016 v2.16.2 running IIS 10.0"` 사용 가능한 플랫폼 버전 목록을 보려면 [eb platform list](eb3-platform.md#eb3-platform-list)를 사용하세요. | | `--remote` | 마이그레이션을 원격 모드로 실행하도록 지정합니다. 이 옵션을 사용하면 배스천 호스트에서 실행할 수 있으며, 해당 호스트는 애플리케이션 및 Elastic Beanstalk으로 마이그레이션할 구성 요소가 포함된 대상 서버에 연결됩니다. `eb migrate`는 배스천 서버에서 실행되며, 구성을 탐지하고 마이그레이션 로직을 배스천 호스트에 준비한 후, 애플리케이션을 새로운 Elastic Beanstalk 환경에 배포합니다. 이 옵션을 사용하면 마이그레이션할 Windows 서버에 EB CLI와 Python을 설치할 필요가 없습니다. 대신 배스천 호스트에 Python과 EB CLI를 설치한 후, 이 호스트에서 `--remote` 옵션과 함께 **eb migrate**을 실행하세요. 마이그레이션할 IIS 구성이 포함된 호스트를 지정하려면 `--target-ip` 옵션을 사용하세요. `--target-ip`, `--username` 및 `--password`와 함께 사용해야 합니다. | | `--target-ip` *ip-address* | 마이그레이션 대상인 IIS 서버가 포함된 원격 Windows 시스템의 퍼블릭 IP 주소입니다. `--remote`를 읽을 때 필요합니다. `--remote`을 사용하는 경우에만 지정할 수 있습니다. | | `--username` *username* | 마이그레이션 대상인 IIS 서버가 포함된 원격 Windows 시스템에 액세스하기 위한 사용자 프로파일의 사용자 이름입니다. `--remote`를 읽을 때 필요합니다. `--remote`을 사용하는 경우에만 지정할 수 있습니다. | | `--password` *암호* | 마이그레이션 대상인 IIS 서버가 포함된 원격 Windows 시스템에 액세스하기 위한 사용자 프로파일의 암호입니다. `--remote`를 읽을 때 필요합니다. `--remote`을 사용하는 경우에만 지정할 수 있습니다. | | `-sr` *role-name* 또는 `--service-role` *role-name* | 관련 서비스를 관리하기 위한 Elastic Beanstalk의 IAM AWS 서비스 역할입니다. 지정하지 않으면 필요한 권한이 포함된 기본 서비스 역할을 생성합니다. 자세한 내용은 [Elastic Beanstalk 서비스 역할](concepts-roles-service.md) 단원을 참조하십시오. 전체 ARN이 아닌 역할 이름만 지정하세요. Elastic Beanstalk은 전체 ARN을 자동으로 생성합니다. | | `-s` *site-names* 또는 `--sites` *site-names* | 마이그레이션할 IIS 사이트의 쉼표로 구분된 목록입니다. 지정하지 않으면 서버에 있는 모든 사용 가능한 사이트를 마이그레이션합니다. 예시: `--sites "Default Web Site,Intranet,API"` | | `--ssl-certificates` *certificate-arn*[,*certificate-arn* ...] | Application Load Balancer에 연결할 ACM SSL 인증서 ARNs의 쉼표로 구분된 목록입니다. HTTPS 바인딩으로 사이트를 마이그레이션할 때 필수 항목입니다. 예시: `--ssl-certificates arn:aws:acm:region:account:certificate/certificate-id` | | `-t key1=value1[,key2=value2 ...]` 또는 `--tags key1=value1[,key2=value2 ...]` | 환경의 새 리소스(환경, Elastic Beanstalk 애플리케이션, 애플리케이션 버전)에 태그를 지정하기 위한 `key=value` 페어의 쉼표로 구분된 목록입니다. 자세한 내용은 [환경에 태그 지정](using-features.tagging.md) 단원을 참조하십시오. | | `--verbose` | 마이그레이션 과정에서 상세 정보를 표시합니다. **explore** 하위 명령과 함께 사용할 경우, 사이트 구성에 대한 종합 정보를 표시합니다. | | `-vpc` *config-file-or-string* 또는 `--vpc-config` *config-file-or-string* | 환경의 VPC 구성. JSON 파일 경로나 JSON 문자열로 지정합니다. 구성에는 다음 항목이 포함되어야 합니다. 
{
    "id": "vpc-1234567890abcdef0",
    "publicip": "true|false",
    "elbscheme": "public|private",
    "ec2subnets": ["subnet-a1b2c3d4", "subnet-e5f6g7h8"],
    "securitygroups": "sg-123456,sg-789012",
    "elbsubnets": ["subnet-a1b2c3d4", "subnet-e5f6g7h8"]
}
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/elasticbeanstalk/latest/dg/eb3-migrate.html) **`--vpc-config` * 파라미터를 지정하면, 마이그레이션 시 소스 환경의 기존 VPC 설정은 무시됩니다.* 이 파라미터를 사용하면 마이그레이션은 전달되는 구성 파일에 지정된 VPC 설정만 사용합니다. 이 파라미터를 사용하면 기본 동작(소스 인스턴스의 VPC 구성을 자동으로 탐색하거나 기본 VPC를 사용하는 동작)이 재정의됩니다. | | [일반 옵션](eb3-cmd-options.md) | | ## 출력 이 명령은 마이그레이션 과정 전반에 걸쳐 상태 업데이트를 제공합니다. 1. VPC 구성 감지(EC2 인스턴스에서 실행되는 경우) 1. 각 사이트에 대한 소스 번들 생성 진행 상황 1. 환경 생성 상태 1. 배포 진행 중 성공할 경우, 새 환경의 세부 정보가 표시됩니다. + 환경 이름 및 ID + 애플리케이션 이름 + 리전 + 플랫폼 버전 + 환경 CNAME 마이그레이션 중 문제가 발생하면 [**eb events**](eb3-events.md) 및 [**eb health**](eb3-health.md) 명령을 사용해 상세 정보를 확인하세요. ## 예제 ### 기본 사용법 대화형 모드에서의 기본 마이그레이션: ``` PS C:\migrations_workspace > eb migrate Identifying VPC configuration of this EC2 instance (i-0123456789abcdef0): id: vpc-1234567890abcdef0 publicip: true elbscheme: public ec2subnets: subnet-123,subnet-456,subnet-789 securitygroups: sg-123,sg-456 elbsubnets: subnet-123,subnet-456,subnet-789 Using .\migrations\latest to contain artifacts for this migration run. Generating source bundle for sites, applications, and virtual directories... Default Web Site/ -> .\migrations\latest\upload_target\DefaultWebSite.zip Creating application version Creating environment Environment details for: EBMigratedEnv Application name: EBMigratedApp Region: us-west-2 Deployed Version: app-230320_153045 Environment ID: e-abcdef1234 Platform: 64bit Windows Server 2019 v2.7.0 running IIS 10.0 Tier: WebServer-Standard-1.0 CNAME: ebmigratedenv.us-west-2.elasticbeanstalk.com Updated: 2023-03-20 15:30:45 ``` 사용자 지정 구성을 포함한 특정 사이트 마이그레이션: ``` PS C:\migrations_workspace > eb migrate ` --sites "Default Web Site,InternalAPI" ` --application-name "CorporateApp" ` --environment-name "Production" ` --instance-type "c5.xlarge" ` --tags "Environment=Production,Team=WebOps" ` --copy-firewall-config ``` 배포 없이 마이그레이션 아카이브 생성: ``` PS C:\migrations_workspace > eb migrate --archive-only Using .\migrations\latest to contain artifacts for this migration run. Generating source bundle for sites, applications, and virtual directories... Default Web Site/ -> .\migrations\latest\upload_target\DefaultWebSite.zip Generated destination archive directory at .\migrations\latest\upload_target You can execute `eb init` and `eb create` from this directory to deploy to EB. ``` ### 고급 구성 예제 JSON 파일을 사용한 사용자 지정 VPC 구성으로 마이그레이션: ``` PS C:\migrations_workspace > cat vpc-config.json { "id": "vpc-1234567890abcdef0", "publicip": "false", "elbscheme": "internal", "ec2subnets": [ "subnet-private1", "subnet-private2" ], "securitygroups": [ "sg-app", "sg-database", "sg-monitoring" ], "elbsubnets": [ "subnet-private1", "subnet-private2" ] } PS C:\migrations_workspace eb migrate ` --sites "InternalAPI" ` --vpc-config vpc-config.json ` --instance-type "r5.xlarge" ` --tags "Environment=Internal,Security=High" ``` SSL 인증서 및 호스트 헤더를 사용하는 사이트 마이그레이션: ``` PS C:\migrations_workspace > eb migrate ` --sites "SecurePortal" ` --ssl-certificates "arn:aws:acm:region:account:certificate/cert1,arn:aws:acm:region:account:certificate/cert2" ` --verbose INFO: Detected HTTPS bindings: - www.example.com:443 - api.example.com:443 INFO: Configuring Application Load Balancer with SSL certificates INFO: Creating host-based routing rules: - www.example.com -> target group 1 - api.example.com -> target group 2 ``` EBS 스냅샷 구성을 포함한 마이그레이션:fo ``` PS C:\migrations_workspace > eb migrate ` --sites "Default Web Site" ` --ebs-snapshots "snap-1234567890abcdef0" "snap-0987654321fedcba1" ` --encrypt-ebs-volumes Using .\migrations\latest to contain artifacts for this migration run. INFO: Enabling EBS encryption for all new volumes in us-west-2 INFO: Configuring environment with specified EBS snapshots ``` ### 보안 구성 예제 복잡한 방화벽 규칙이 있는 사이트 처리: ``` PS C:\migrations_workspace > eb migrate ` --sites "Default Web Site,ReportingService" ` --copy-firewall-config ` --verbose INFO: Detected the following Windows Firewall rules: - Allow Web Traffic (TCP 80, 443) - Allow Reporting Traffic (TCP 8081) INFO: Creating corresponding security group rules ``` 사용자 지정 IAM 역할을 사용하는 마이그레이션: ``` PS C:\migrations_workspace > eb migrate ` --sites "SecureApp" ` --instance-profile "CustomInstanceProfile" ` --service-role "CustomServiceRole" ``` ### 원격 실행 예제 원격 Windows 서버에서 IIS 애플리케이션 마이그레이션: ``` PS C:\migrations_workspace > eb migrate ` --remote ` --target-ip "192.0.2.10" ` --username "administrator" ` --password "YourPassword123" ` --application-name "RemoteApp" ` --environment-name "RemoteEnv" INFO: Establishing SSH connection to remote host 192.0.2.10... INFO: Connection established INFO: Discovering IIS sites on remote host... INFO: Found 2 sites: Default Web Site, API INFO: Extracting site configurations... INFO: Generating source bundle for sites, applications, and virtual directories... Default Web Site/ -> .\migrations\latest\upload_target\DefaultWebSite.zip API/ -> .\migrations\latest\upload_target\API.zip Creating application version Creating environment Environment details for: RemoteEnv Application name: RemoteAppstage mi Region: us-west-2 Deployed Version: app-230320_153045 Environment ID: e-abcdef1234 Platform: 64bit Windows Server 2019 v2.7.0 running IIS 10.0 Tier: WebServer-Standard-1.0 CNAME: remoteenv.us-west-2.elasticbeanstalk.com Updated: 2023-03-20 15:30:45 ``` 특정 사이트를 선택한 원격 마이그레이션: ``` PS C:\migrations_workspace > eb migrate ` --remote ` --target-ip "192.0.2.10" ` --username "administrator" ` --password "YourPassword123" ` --sites "API" ` --instance-type "c5.large" ``` # **eb open** ## 설명 기본 브라우저에서 웹 사이트의 퍼블릭 URL을 엽니다. ## 구문 **eb open** **eb open *environment-name*** ## 옵션 **** | 이름 | 설명 | | --- | --- | | [일반 옵션](eb3-cmd-options.md) | | ## 출력 명령 **eb open**에는 출력이 없습니다. 대신에 브라우저 창에서 애플리케이션을 엽니다. # **eb platform** ## 설명 이 명령은 두 가지 작업 영역을 지원합니다. [플랫폼](#eb3-platform-preconfigured) 이 작업 영역을 사용하여 사용자 지정 플랫폼을 관리합니다. [환경](#eb3-platform-environment) 이 작업 영역을 사용하여 기본 플랫폼을 선택하거나 현재 플랫폼에 대한 정보를 표시합니다. Elastic Beanstalk는 **eb platform**에 대한 바로 가기 **ebp**를 제공합니다. **참고** Windows PowerShell은 **ebp**를 명령 별칭으로 사용합니다. Windows PowerShell에서 EB CLI를 실행하는 경우 이 명령의 긴 형식(**eb platform**)을 사용합니다. ## 사용자 지정 플랫폼에 eb 플랫폼 사용 현재 플랫폼 버전을 나열하고 사용자 지정 플랫폼을 관리할 수 있습니다. ### 구문 **eb platform create [*version*] [*options*]** **eb platform delete [*version*] [*options*]** **eb platform events [*version*] [*options*]** **eb platform init [*platform*] [*options*]** **eb platform list [*options*]** **eb platform logs [*version*] [*options*]** **eb platform status [*version*] [*options*]** **eb platform use [*platform*] [*options*]** ### 옵션 **** | 이름 | 설명 | | --- | --- | | `create [version] [options]` | 새 플랫폼 버전을 빌드합니다. [자세히 알아보기](#eb3-platform-create) | | `delete version [options]` | 플랫폼 버전을 삭제합니다. [자세히 알아보기](#eb3-platform-delete) | | `events [version] [options]` | 플랫폼 버전에서 이벤트를 표시합니다. [자세히 알아보기](#eb3-platform-events) | | `init [platform] [options]` | 플랫폼 리포지토리를 초기화합니다. [자세히 알아보기](#eb3-platform-init) | | `list [options]` | 현재 플랫폼 버전을 나열합니다. [자세히 알아보기](#eb3-platform-list) | | `logs [version] [options]` | 플랫폼 버전에 대한 빌더 환경의 로그를 표시합니다. [자세히 알아보기](#eb3-platform-logs) | | `status [version] [options]` | 플랫폼 버전의 상태를 표시합니다. [자세히 알아보기](#eb3-platform-status) | | `use [platform] [options]` | 새 버전을 구축할 다른 플랫폼을 선택합니다. [자세히 알아보기](#eb3-platform-use) | | [일반 옵션](eb3-cmd-options.md) | | ### 일반 옵션 모든 **eb platform** 명령에는 다음의 일반 옵션이 포함되어 있습니다. **** | 이름 | 설명 | | --- | --- | | `-h` 또는 `--help` | 도움말 메시지를 표시한 후 종료합니다. | | `--debug` | 추가 디버깅 출력을 표시합니다. | | `--quiet` | 모든 출력을 억제합니다. | | `-v` 또는 `--verbose` | 추가 출력을 표시합니다. | | `--profile PROFILE` | 자격 증명에서 지정된 *PROFILE*을 사용합니다. | | `-r REGION` 또는 `--region REGION` | 리전 *REGION*을 사용합니다. | | `--no-verify-ssl` | AWS SSL 인증서를 확인하지 마십시오. | ### Eb 플랫폼 생성 새 플랫폼 버전을 빌드한 후 새 버전에 대한 ARN을 반환합니다. 현재 리전에서 실행 중인 빌더 환경이 없는 경우, 이 명령으로 환경 하나를 시작합니다. *version*과 증분 옵션(`-M`, `-m` 및 `-p`)은 함께 사용할 수 없습니다. #### 옵션 **** | 이름 | 설명 | | --- | --- | | *version* | *version*이 지정되지 않은 경우, 패치 버전(n.n.N에서 N)이 더 높은 최신 플랫폼을 기반으로 새 버전을 만듭니다. | | `-M` 또는 `--major-increment` | 메이저 버전 번호(N.n.n에서 N)를 높게 합니다. | | `-m` 또는 `--minor-increment` | 마이너 버전 번호(n.N.n에서 N)를 높게 합니다. | | `-p` 또는 `--patch-increment` | 패치 버전 번호(n.n.N에서 N)를 높게 합니다. | | `-i INSTANCE_TYPE` 또는 --instance-type *INSTANCE\$1TYPE* | *INSTANCE\$1TYPE*을 인스턴스 유형으로 사용합니다(예: **t1.micro**). | | `-ip INSTANCE_PROFILE` 또는 `--instance-profile INSTANCE_PROFILE` | 사용자 지정 플랫폼에 대해 AMI를 만들 때 *INSTANCE\$1PROFILE*을 인스턴스 프로파일로 사용합니다. `-ip` 옵션이 지정되지 않은 경우 인스턴스 프로파일 `aws-elasticbeanstalk-custom-platforme-ec2-role`을 생성하여 사용자 지정 플랫폼에 사용합니다. | | `--tags key1=value1[,key2=value2 ...]` | 태그는 쉼표로 구분된 `key=value` 페어 목록으로 지정됩니다. | | `--timeout` *minutes* | 명령 시간이 초과되기 전 경과되는 시간(분)을 설정합니다. | | `--vpc.id VPC_ID` | Packer가 빌드되는 VPC의 ID입니다. | | `--vpc.subnets VPC_SUBNETS` | Packer가 빌드되는 VPC 서브넷입니다. | | `--vpc.publicip` | 시작된 EC2 인스턴스에 퍼블릭 IP를 연결합니다. | ### Eb 플랫폼 삭제 플랫폼 버전을 삭제합니다. 환경에서 해당 버전을 사용하는 경우, 버전을 삭제하지 않습니다. #### 옵션 **** | 이름 | 설명 | | --- | --- | | `version` | 삭제할 버전입니다. 이 값은 필수입니다. | | `--cleanup` | `Failed` 상태인 모든 플랫폼 버전을 삭제합니다. | | `--all-platforms` | `--cleanup`이 지정된 경우 모든 플랫폼에서 `Failed` 상태인 모든 플랫폼 버전을 삭제합니다. | | `--force` | 버전을 삭제할 때 확인하지 않아도 됩니다. | ### Eb 플랫폼 이벤트 플랫폼 버전에서 이벤트를 표시합니다. *version*이 지정된 경우, 해당 버전의 이벤트를 표시하거나 현재 버전의 이벤트를 표시합니다. #### 옵션 **** | 이름 | 설명 | | --- | --- | | *version* | 이벤트를 표시할 버전입니다. 이 값은 필수입니다. | | `-f` 또는 `--follow` | 이벤트가 발생할 때 계속 표시합니다. | ### Eb 플랫폼 초기화 플랫폼 리포지토리를 초기화합니다. #### 옵션 **** | 이름 | 설명 | | --- | --- | | `platform` | 초기화할 플랫폼의 이름입니다. `-i`(대화형 모드)를 활성화하지 않는 한 이 값은 필수입니다. | | `-i` 또는 `--interactive` | 대화형 모드를 사용합니다. | | `-k KEYNAME` 또는 `--keyname KEYNAME` | 기본 EC2 키 이름입니다. | 이전에 초기화한 디렉터리에서 실행할 경우 작업 영역을 바꿀 수 없더라도, 이전에 초기화한 디렉터리에서 이 명령을 실행할 수 있습니다. 다른 옵션으로 재초기화하려면 `-i` 옵션을 사용합니다. ### Eb 플랫폼 목록 작업 영역(디렉터리) 또는 리전에 연결된 플랫폼 버전을 나열합니다. 명령은 다음과 같이 실행하는 작업 영역의 유형에 따라 다른 결과를 반환합니다. + 플랫폼 작업 영역(`eb platform init`를 통해 초기화된 디렉터리)에서 명령은 작업 영역에 정의된 사용자 지정 플랫폼의 모든 플랫폼 버전 목록을 반환합니다. `--all-platforms` 또는 `--verbose` 옵션을 추가하여 작업 영역과 연결된 리전에서 계정에 있는 모든 사용자 지정 플랫폼의 모든 플랫폼 버전 목록을 가져옵니다. + 애플리케이션 작업 영역(`eb init`를 통해 초기화된 디렉터리)에서 명령은 Elastic Beanstalk에서 관리하는 플랫폼과 계정의 사용자 지정 플랫폼에 대해 모든 플랫폼 버전 목록을 반환합니다. 목록은 짧은 플랫폼 버전 이름을 사용하며 일부 플랫폼 버전 변형이 결합될 수도 있습니다. `--verbose` 옵션을 추가하여 별도로 나열된 전체 이름과 모든 변형이 포함된 세부 목록을 가져옵니다. + 초기화되지 않은 디렉터리에서 명령은 `--region` 옵션에서만 작동합니다. 명령은 리전에서 지원되는 모든 Elastic Beanstalk 관리형 플랫폼 목록을 반환합니다. 목록은 짧은 플랫폼 버전 이름을 사용하며 일부 플랫폼 버전 변형이 결합될 수도 있습니다. `--verbose` 옵션을 추가하여 별도로 나열된 전체 이름과 모든 변형이 포함된 세부 목록을 가져옵니다. #### 옵션 **** | 이름 | 설명 | | --- | --- | | `-a` 또는 `--all-platforms` | 초기화된 작업 영역(`eb platform init` 또는 `eb init`를 통해 초기화된 디렉터리)에서만 유효합니다. 계정에 연결된 모든 사용자 지정 플랫폼 버전을 나열합니다. | | `-s STATUS` 또는 `--status STATUS` | *STATUS*에 해당되는 플랫폼만 나열합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/elasticbeanstalk/latest/dg/eb3-platform.html) | ### Eb 플랫폼 로그 플랫폼 버전에 대한 빌더 환경의 로그를 표시합니다. #### 옵션 **** | 이름 | 설명 | | --- | --- | | `version` | 로그를 표시할 플랫폼 버전입니다. 생략할 경우 현재 버전의 로그를 표시합니다. | | `--stream` | CloudWatch로 설정되지 않은 배포 로그를 스트리밍합니다. | ### Eb 플랫폼 상태 플랫폼 버전의 상태를 표시합니다. #### 옵션 **** | 이름 | 설명 | | --- | --- | | `version` | 상태를 검색할 플랫폼 버전입니다. 생략할 경우 현재 버전의 상태를 표시합니다. | ### Eb 플랫폼 사용 새 버전을 구축할 다른 플랫폼을 선택합니다. #### 옵션 **** | 이름 | 설명 | | --- | --- | | `platform` | *platform*을 이 작업 영역에 대한 활성 버전으로 지정합니다. 이 값은 필수입니다. | ## 환경에 eb 플랫폼 사용 지원되는 플랫폼을 나열하고 환경을 시작할 때 사용할 기본 플랫폼과 플랫폼 버전을 설정할 수 있습니다. 지원되는 모든 플랫폼의 목록을 보려면 **eb platform list**를 사용합니다. 프로젝트에 대한 플랫폼을 변경하려면 **eb platform select**를 사용합니다. 선택한 프로젝트의 플랫폼을 보려면 **eb platform show**를 사용합니다. ### 구문 **eb platform list** **eb platform select** **eb platform show** ### 옵션 **** | 이름 | 설명 | | --- | --- | | `list` | 현재 플랫폼 버전을 나열합니다. | | `select` | 기본 플랫폼을 선택합니다. | | `show` | 현재 플랫폼에 대한 정보 표시 | ### 예 1 다음 예제에는 Elastic Beanstalk에서 지원하는 모든 플랫폼에 대한 모든 구성의 이름이 전부 나열되어 있습니다. ``` $ eb platform list docker-1.5.0 glassfish-4.0-java-7-(preconfigured-docker) glassfish-4.1-java-8-(preconfigured-docker) go-1.3-(preconfigured-docker) go-1.4-(preconfigured-docker) iis-7.5 iis-8 iis-8.5 multi-container-docker-1.3.3-(generic) node.js php-5.3 php-5.4 php-5.5 python python-2.7 python-3.4 python-3.4-(preconfigured-docker) ruby-1.9.3 ruby-2.0-(passenger-standalone) ruby-2.0-(puma) ruby-2.1-(passenger-standalone) ruby-2.1-(puma) ruby-2.2-(passenger-standalone) ruby-2.2-(puma) tomcat-6 tomcat-7 tomcat-7-java-6 tomcat-7-java-7 tomcat-8-java-8 ``` ### 예 2 다음 예제는 지정된 플랫폼에서 배포하려는 버전과 플랫폼을 목록에서 선택하라는 메시지를 표시합니다. ``` $ eb platform select Select a platform. 1) PHP 2) Node.js 3) IIS 4) Tomcat 5) Python 6) Ruby 7) Docker 8) Multi-container Docker 9) GlassFish 10) Go (default is 1): 5 Select a platform version. 1) Python 2.7 2) Python 3) Python 3.4 (Preconfigured - Docker) ``` ### 예 3 다음은 현재 기본 플랫폼에 대한 정보를 표시하는 예제입니다. ``` $ eb platform show Current default platform: Python 2.7 New environments will be running: 64bit Amazon Linux 2014.09 v1.2.0 running Python 2.7 Platform info for environment "tmp-dev": Current: 64bit Amazon Linux 2014.09 v1.2.0 running Python Latest: 64bit Amazon Linux 2014.09 v1.2.0 running Python ``` # **eb printenv** ## 설명 명령 창에서 모든 환경 속성을 인쇄합니다. ## 구문 **eb printenv** **eb printenv *environment-name*** ## 옵션 **** | 이름 | 설명 | | --- | --- | | [일반 옵션](eb3-cmd-options.md) | | ## 출력 성공할 경우 명령이 `printenv` 작업의 상태를 반환합니다. ## 예제 다음 예제에서는 지정된 환경의 환경 속성을 인쇄합니다. ``` $ eb printenv Environment Variables: PARAM1 = Value1 ``` # **eb restore** ## 설명 종료된 환경을 다시 빌드하여 동일한 이름, ID, 구성의 새 환경을 생성합니다. 다시 빌드하려면 환경 이름, 도메인 이름, 애플리케이션 버전을 사용할 수 있어야 합니다. ## 구문 **eb restore** **eb restore *environment\$1id*** ## 옵션 **** | 이름 | 설명 | | --- | --- | | [일반 옵션](eb3-cmd-options.md) | | ## 출력 EB CLI는 복원할 수 있는 종료된 환경 목록을 표시합니다. ## 예제 ``` $ eb restore Select a terminated environment to restore # Name ID Application Version Date Terminated Ago 3 gamma e-s7mimej8e9 app-77e3-161213_211138 2016/12/14 20:32 PST 13 mins 2 beta e-sj28uu2wia app-77e3-161213_211125 2016/12/14 20:32 PST 13 mins 1 alpha e-gia8mphu6q app-77e3-161213_211109 2016/12/14 16:21 PST 4 hours (Commands: Quit, Restore, ▼ ▲) Selected environment alpha Application: scorekeep Description: Environment created from the EB CLI using "eb create" CNAME: alpha.h23tbtbm92.us-east-2.elasticbeanstalk.com Version: app-77e3-161213_211109 Platform: 64bit Amazon Linux 2016.03 v2.1.6 running Java 8 Terminated: 2016/12/14 16:21 PST Restore this environment? [y/n]: y 2018-07-11 21:04:20 INFO: restoreEnvironment is starting. 2018-07-11 21:04:39 INFO: Created security group named: sg-e2443f72 ... ``` # **eb scale** ## 설명 항상 지정된 인스턴스 수에서 실행되도록 환경을 확장하고, 최대 및 최소 인스턴스 수를 지정된 수로 설정합니다. ## 구문 **eb scale *number-of-instances*** **eb scale *number-of-instances* *environment-name*** ## 옵션 **** | 이름 | 설명 | | --- | --- | | --timeout | 명령 시간이 초과되기 전 경과되는 시간(분)입니다. | | [일반 옵션](eb3-cmd-options.md) | | ## 출력 성공하면 명령은 실행될 최대 및 최소 인스턴스 수를 지정된 수로 업데이트합니다. ## 예제 다음은 인스턴스 수를 2로 설정한 예제입니다. ``` $ eb scale 2 2018-07-11 21:05:22 INFO: Environment update is starting. 2018-07-11 21:05:27 INFO: Updating environment tmp-dev's configuration settings. 2018-07-11 21:08:53 INFO: Added EC2 instance 'i-5fce3d53' to Auto Scaling Group 'awseb-e-2cpfjbra9a-stack-AWSEBAutoScalingGroup-7AXY7U13ZQ6E'. 2018-07-11 21:08:58 INFO: Successfully deployed new configuration to environment. 2018-07-11 21:08:59 INFO: Environment update completed successfully. ``` # **eb setenv** ## 설명 기본 환경에 대한 [환경 속성](environments-cfg-softwaresettings.md)을 설정합니다. ## 구문 **eb setenv *key*=*value*** 속성은 원하는 만큼 포함할 수 있지만 모든 속성의 총 크기가 4096바이트를 초과할 수는 없습니다. 값을 비워 변수를 삭제할 수 있습니다. 제한은 [환경 속성 구성(환경 변수)](environments-cfg-softwaresettings.md#environments-cfg-softwaresettings-console) 단원을 참조하세요. **참고** `value`에 [특수 문자](http://tldp.org/LDP/abs/html/special-chars.html)가 포함되어 있으면 특수 문자 앞에 `\` 문자를 붙여 해당 특수 문자를 이스케이프해야 합니다. ## 옵션 **** | 이름 | 설명 | | --- | --- | | --timeout | 명령 시간이 초과되기 전 경과되는 시간(분)입니다. | | [일반 옵션](eb3-cmd-options.md) | | ## 출력 성공하면 명령이 환경 업데이트에 성공했음을 표시합니다. ## 예제 다음은 환경 변수 ExampleVar을 설정하는 예제입니다. ``` $ eb setenv ExampleVar=ExampleValue 2018-07-11 21:05:25 INFO: Environment update is starting. 2018-07-11 21:05:29 INFO: Updating environment tmp-dev's configuration settings. 2018-07-11 21:06:50 INFO: Successfully deployed new configuration to environment. 2018-07-11 21:06:51 INFO: Environment update completed successfully. ``` 다음 명령은 여러 환경 속성을 설정합니다. 환경 변수 `foo`를 추가해 값을 `bar`로 설정하고, `JDBC_CONNECTION_STRING` 속성의 값을 변경하고, `PARAM4` 및 `PARAM5` 속성을 삭제합니다. ``` $ eb setenv foo=bar JDBC_CONNECTION_STRING=hello PARAM4= PARAM5= ``` # **eb ssh** ## 설명 **참고** 이 명령은 Windows Server 인스턴스를 실행하는 환경에서는 작동하지 않습니다. SSH(Secure Shell)를 사용하여 환경 내 Linux Amazon EC2 인스턴스에 연결합니다. 환경에 실행 중인 인스턴스가 여러 개 있는 경우 EB CLI에서는 연결하려는 인스턴스를 지정하라는 메시지가 표시됩니다. 이 명령을 사용하려면 로컬 시스템에 SSH가 설치되어 있고 명령줄에서 사용할 수 있어야 합니다. 프라이빗 키가 사용자 디렉터리의 `.ssh` 폴더에 있어야 하고 환경 내 EC2 인스턴스에는 퍼블릭 IP 주소가 있어야 합니다. 루트 디렉터리에 사용자 지정 플랫폼을 지정하는 `platform.yaml` 파일이 들어 있는 경우, 이 명령도 사용자 지정 환경 내 인스턴스에 연결합니다. **SSH 키** 이전에 SSH를 구성하지 않은 경우 **eb init** 실행 시 EB CLI를 사용하여 키를 생성할 수 있습니다. **eb init**를 이미 실행한 경우에는 `--interactive` 옵션을 사용하여 다시 실행하고 SSH를 설정하라는 메시지가 표시되면 **Yes(예)** 및 **Create New Keypair(새 키 페어 생성)**를 차례로 선택합니다. 이 과정 중에 생성된 키는 EB CLI에서 적절한 폴더에 저장합니다. 포트 22에 대한 마련된 규칙이 없는 경우 이 명령은 0.0.0.0/0(모든 IP 주소)의 수신 트래픽을 위해 환경의 보안 그룹에서 포트 22를 일시적으로 엽니다. 보안 강화를 위해 제한된 CIDR 범위에 대해 포트 22를 열도록 환경의 보안 그룹을 구성한 경우에는 EB CLI가 해당 설정을 따르고 보안 그룹에 대한 모든 변경 사항을 적용하지 않습니다. 이러한 동작을 재정의하여 EB CLI가 모든 수신 트래픽에 대해 포트 22를 열도록 하려면 `--force` 옵션을 사용합니다. 환경의 보안 그룹 구성에 대한 자세한 내용은 [EC2 보안 그룹](using-features.managing.ec2.console.md#using-features.managing.ec2.securitygroups) 단원을 참조하세요. ## 구문 **eb ssh** **eb ssh *environment-name*** ## 옵션 **** | 이름 | 설명 | | --- | --- | | `-i` 또는 `--instance` | 연결할 인스턴스의 ID를 지정합니다. 이 옵션을 사용하는 것이 좋습니다. | | `-n` 또는 `--number` | 연결할 인스턴스를 숫자로 지정합니다. | | `-o` 또는 `--keep_open` | SSH 세션이 종료된 후 보안 그룹에서 포트 22를 열어 둡니다. | | `--command` | SSH 세션을 시작하는 대신 지정된 인스턴스에서 셸 명령을 실행합니다. | | `--custom` | 'ssh -i keyfile' 대신 사용할 SSH 명령을 지정합니다. 원격 사용자 및 호스트 이름은 포함하지 마세요. | | `--setup` | 환경의 인스턴스에 할당된 키 페어를 변경합니다(인스턴스를 교체해야 함). | | `--force` | 보안 그룹이 이미 SSH에 대해 구성되어 있더라도 환경의 보안 그룹에서 0.0.0.0/0의 수신 트래픽에 대해 포트 22를 엽니다. 환경의 보안 그룹이 제한된 CIDR 범위에 대해 포트 22를 열도록 구성되어 있는데 이 범위에 연결하려는 IP 주소가 제외되어 있는 경우 이 옵션을 사용합니다. | | `--timeout` *minutes* | 명령 시간이 초과되기 전 경과되는 시간(분)을 설정합니다. `--setup` 인수만 사용할 수 있습니다. | | [일반 옵션](eb3-cmd-options.md) | | ## 출력 성공하면 명령이 인스턴스에 대한 SSH 연결을 엽니다. ## 예제 다음 예제는 지정된 환경에 연결합니다. ``` $ eb ssh Select an instance to ssh into 1) i-96133799 2) i-5931e053 (default is 1): 1 INFO: Attempting to open port 22. INFO: SSH port 22 open. The authenticity of host '54.191.45.125 (54.191.45.125)' can't be established. RSA key fingerprint is ee:69:62:df:90:f7:63:af:52:7c:80:60:1b:3b:51:a9. Are you sure you want to continue connecting (yes/no)? yes Warning: Permanently added '54.191.45.125' (RSA) to the list of known hosts. __| __|_ ) _| ( / Amazon Linux AMI ___|\___|___| https://aws.amazon.com/amazon-linux-ami/2014.09-release-notes/ No packages needed for security; 1 packages available Run "sudo yum update" to apply all updates. [ec2-user@ip-172-31-8-185 ~]$ ls [ec2-user@ip-172-31-8-185 ~]$ exit logout Connection to 54.191.45.125 closed. INFO: Closed port 22 on ec2 instance security group ``` # **eb status** ## 설명 환경 상태에 대한 정보를 제공합니다. 루트 디렉터리에 사용자 지정 플랫폼을 지정하는 `platform.yaml` 파일이 들어 있는 경우, 이 명령도 빌더 환경에 대한 정보를 제공합니다. ## 구문 **eb status** **eb status *environment-name*** ## 옵션 **** | 이름 | 설명 | | --- | --- | | `-v` 또는 `--verbose` | Elastic Load Balancing 로드 밸런서의 상태 등과 같은 개별 인스턴스에 대한 자세한 정보를 제공합니다. | | [일반 옵션](eb3-cmd-options.md) | | ## 출력 성공할 경우 명령이 환경에 대한 다음 정보를 반환합니다. + Environment name + 애플리케이션 이름 + 배포된 애플리케이션 버전 + 환경 ID + 플랫폼 + 환경 티어 + CNAME + 환경이 마지막으로 업데이트된 시간 + 상태 + 상태 상세 정보 표시 모드를 사용할 경우 EB CLI에서도 실행 중인 Amazon EC2 인스턴스 수를 제공합니다. ## 예제 다음 예제에서는 환경 tmp-dev에 대한 상태를 보여줍니다. ``` $ eb status Environment details for: tmp-dev Application name: tmp Region: us-west-2 Deployed Version: None Environment ID: e-2cpfjbra9a Platform: 64bit Amazon Linux 2014.09 v1.0.9 running PHP 5.5 Tier: WebServer-Standard-1.0 CNAME: tmp-dev.elasticbeanstalk.com Updated: 2014-10-29 21:37:19.050000+00:00 Status: Launching Health: Grey ``` # **eb swap** ## 설명 다른 환경의 CNAME과 현재 환경의 CNAME을 스왑합니다(예: 애플리케이션 버전을 업데이트할 때 가동 중지를 방지하기 위해). **참고** 3개 이상의 환경이 있는 경우 현재 환경 목록에서 원하는 CNAME을 사용하는 환경 이름을 선택하라는 메시지가 표시됩니다. 이 메시지를 표시하지 않으려면 명령을 실행할 때 `-n` 옵션을 포함하여 사용할 환경 이름을 지정합니다. ## 구문 **eb swap** **eb swap *environment-name*** **참고** *environment-name*은 다른 CNAME이 필요한 환경입니다. *environment-name*을 명령줄 파라미터로 지정하지 않은 경우 **eb swap**을 실행할 때 EB CLI에서는 기본 환경의 CNAME을 업데이트합니다. ## 옵션 **** | 이름 | 설명 | | --- | --- | | `-n` 또는 `--destination_name` | CNAME을 스왑하려는 환경 이름을 지정합니다. 이 옵션을 사용하지 않고 **eb swap**를 실행하는 경우 EB CLI에는 환경 목록에서 선택하라는 메시지가 표시됩니다. | | [일반 옵션](eb3-cmd-options.md) | | ## 출력 성공할 경우 명령이 `swap` 작업의 상태를 반환합니다. ## 예제 다음은 live-env와 환경 tmp-dev를 스왑하는 예제입니다. ``` $ eb swap Select an environment to swap with. 1) staging-dev 2) live-env (default is 1): 2 2018-07-11 21:05:25 INFO: swapEnvironmentCNAMEs is starting. 2018-07-11 21:05:26 INFO: Swapping CNAMEs for environments 'tmp-dev' and 'live-env'. 2018-07-11 21:05:30 INFO: 'tmp-dev.elasticbeanstalk.com' now points to 'awseb-e-j-AWSEBLoa-M7U21VXNLWHN-487871449.us-west-2.elb.amazonaws.com'. 2018-07-11 21:05:30 INFO: Completed swapping CNAMEs for environments 'tmp-dev' and 'live-env'. ``` 다음 예제에서는 환경 live-env와 환경 tmp-dev를 스왑하지만 설정을 입력하거나 선택하라는 메시지는 표시되지 않습니다. ``` $ eb swap tmp-dev --destination_name live-env 2018-07-11 21:18:12 INFO: swapEnvironmentCNAMEs is starting. 2018-07-11 21:18:13 INFO: Swapping CNAMEs for environments 'tmp-dev' and 'live-env'. 2018-07-11 21:18:17 INFO: 'tmp-dev.elasticbeanstalk.com' now points to 'awseb-e-j-AWSEBLoa-M7U21VXNLWHN-487871449.us-west-2.elb.amazonaws.com'. 2018-07-11 21:18:17 INFO: Completed swapping CNAMEs for environments 'tmp-dev' and 'live-env'. ``` # **eb tags** ## 설명 Elastic Beanstalk 리소스의 태그를 추가, 삭제, 업데이트 및 나열합니다. Elastic Beanstalk 리소스의 태그 지정에 대한 자세한 내용은 [Elastic Beanstalk 애플리케이션 리소스 태그 지정](applications-tagging-resources.md)을 참조하세요. ## 조건 **eb tags [*environment-name*] [--resource *ARN*] -l \$1 --list** **eb tags [*environment-name*] [--resource *ARN*] -a \$1 --add *key1*=*value1*[,*key2*=*value2* ...]** **eb tags [*environment-name*] [--resource *ARN*] -u \$1 --update *key1*=*value1*[,*key2*=*value2* ...]** **eb tags [*environment-name*] [--resource *ARN*] -d \$1 --delete *key1*[,*key2* ...]** `--add`, `--update` 및 `--delete` 하위 명령 옵션을 단일 명령으로 결합할 수 있습니다. 최소 1개 이상의 옵션이 필요합니다. 해당하는 세 가지 하위 명령 옵션 중 어떤 옵션도 `--list`와 결합할 수 없습니다. 추가 인수 없이 이러한 모든 명령은 현재 디렉터리의 애플리케이션에 있는 기본 환경의 태그를 나열하거나 수정합니다. *environment-name* 인수를 사용하여 명령이 해당 환경의 태그를 나열하거나 수정합니다. 명령은 `--resource` 옵션을 사용하여 Elastic Beanstalk 리소스(애플리케이션, 환경, 애플리케이션 버전, 저장된 구성 또는 사용자 지정 플랫폼 버전)의 태그를 나열하거나 수정합니다. Amazon 리소스 이름(ARN)을 사용하여 리소스를 지정합니다. ## 옵션 이러한 옵션이 필요하지 않습니다. 어떠한 옵션도 지정하지 않고 **eb create**를 실행힐 걍으, 각 설정 값을 입력하거나 선택하라는 메시지가 표시됩니다. **** | 이름 | 설명 | | --- | --- | | `-l` 또는 `--list` | 현재 리소스에 적용된 태그를 모두 나열합니다. | | `-a key1=value1[,key2=value2 ...]` 또는 `--add key1=value1[,key2=value2 ...]` | 리소스에 새 태그를 적용합니다. 쉼표로 구분된 `key=value` 페어 목록으로 태그를 지정합니다. 기존 태그의 키는 지정할 수 없습니다. 유효 값: [리소스에 태그 지정](applications-tagging-resources.md) 참조 | | `-u key1=value1[,key2=value2 ...]` 또는 `--update key1=value1[,key2=value2 ...]` | 기존 리소스 태그의 값을 업데이트합니다. 쉼표로 구분된 `key=value` 페어 목록으로 태그를 지정합니다. 기존 태그의 키를 지정해야 합니다. 유효 값: [리소스에 태그 지정](applications-tagging-resources.md) 참조 | | `-d key1[,key2 ...]` 또는 `--delete key1[,key2 ...]` | 기존 리소스 태그를 삭제합니다. 쉼표로 구분된 키 목록으로 태그를 지정합니다. 기존 태그의 키를 지정해야 합니다. 유효 값: [리소스에 태그 지정](applications-tagging-resources.md) 참조 | | `-r` *region* 또는 `--region` *region* | 리소스가 있는 AWS 리전 입니다. 기본값: 구성된 기본 리전입니다. 이 옵션에 지정할 수 있는 값의 목록은 *AWS 일반 참조*의 [AWS Elastic Beanstalk 엔드포인트 및 할당량을](https://docs.aws.amazon.com/general/latest/gr/elasticbeanstalk.html) 참조하세요. | | `--resource ARN` | 명령이 태그 대상을 수정하거나 나열하는 리소스의 ARN입니다. 지정되지 않으면 명령이 현재 디렉터리의 애플리케이션에 있는 기본 또는 지정된 환경을 참조합니다. 유효 값: 관심 있는 리소스에 해당하는 [리소스에 태그 지정](applications-tagging-resources.md)의 하위 주제 중 하나를 참조하세요. 이러한 주제는 리소스 ARN 작성법을 보여 주며 애플리케이션 또는 계정에 존재하는 리소스의 ARN 목록을 가져오는 법을 설명합니다. | ## 출력 `--list` 하위 명령 옵션은 리소스 태그 목록을 표시합니다. 해당 출력은 Elastic Beanstalk에서 기본적으로 적용하는 태그와 사용자 지정 태그를 모두 보여 줍니다. ``` $ eb tags --list Showing tags for environment 'MyApp-env': Key Value Name MyApp-env elasticbeanstalk:environment-id e-63cmxwjaut elasticbeanstalk:environment-name MyApp-env mytag tagvalue tag2 2nd value ``` 성공한 경우 `--add`, `--update` 및 `--delete` 하위 명령 옵션은 어떠한 결과도 출력하지 않습니다. `--verbose` 옵션을 추가하여 명령 활동의 상세 출력을 확인할 수 있습니다. ``` $ eb tags --verbose --update "mytag=tag value" Updated Tags: Key Value mytag tag value ``` ## 예시 다음 명령은 애플리케이션의 기본 환경에 키 `tag1` 및 값 `value1`의 태그를 추가하며 동시에 `tag2` 태그를 삭제합니다. ``` $ eb tags --add tag1=value1 --delete tag2 ``` 다음 명령은 애플리케이션 내 저장된 구성에 태그를 추가합니다. ``` $ eb tags --add tag1=value1 \ --resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:configurationtemplate/my-app/my-template" ``` 다음 명령은 없는 태그를 업데이트하려고 하기 때문에 실패합니다. ``` $ eb tags --update tag3=newval ERROR: Tags with the following keys can't be updated because they don't exist: tag3 ``` 다음 명령은 동일한 키를 업데이트하는 동시에 삭제하려고 시도하기 때문에 실패합니다. ``` $ eb tags --update mytag=newval --delete mytag ERROR: A tag with the key 'mytag' is specified for both '--delete' and '--update'. Each tag can be either deleted or updated in a single operation. ``` # **eb terminate** ## 설명 미사용 AWS 리소스에 대한 요금이 발생하지 않도록 실행 환경을 종료합니다. `--all` 옵션을 사용하면, [**eb init**](eb3-init.md)를 사용하여 현재 디렉터리가 초기화된 애플리케이션을 삭제합니다. 이 명령은 애플리케이션의 모든 환경을 종료합니다. 애플리케이션의 모든 환경과 애플리케이션의 [애플리케이션 버전](applications-versions.md) 및 [저장된 구성](environment-configuration-savedconfig.md)을 종료한 후 애플리케이션을 삭제합니다. 루트 디렉터리에 사용자 지정 플랫폼을 지정하는 `platform.yaml` 파일이 들어 있는 경우, 이 명령은 실행 중인 사용자 지정 환경을 종료합니다. **참고** 이후에 동일한 버전을 사용하여 언제든 새 환경을 시작할 수 있습니다. 환경에서 데이터를 보존하려는 경우 환경을 종료하기 전에 데이터베이스 삭제 정책을 `Retain`(으)로 설정하세요. 이렇게 하면 Elastic Beanstalk 외부에서 데이터베이스가 계속 작동합니다. 그런 다음 Elastic Beanstalk 환경을 외부 데이터베이스로 연결해야 합니다. 데이터베이스를 작동시키지 않고 데이터를 백업하려면 환경을 종료하기 전에 데이터베이스의 스냅샷을 생성하도록 삭제 정책을 설정합니다. 자세한 내용은 이 가이드의 *환경 구성* 챕터의 [데이터베이스 수명 주기](using-features.managing.db.md#environments-cfg-rds-lifecycle)을(를) 참조하세요. **중요** 환경을 종료하는 경우 생성한 CNAME 매핑도 모두 삭제해야 합니다. 그래야 다른 고객이 사용 가능한 호스트 이름을 재사용할 수 있습니다. *매달린 DNS*를 방지하려면 종료된 환경을 나타내는 DNS 레코드를 삭제해야 합니다. 매달린 DNS 항목이 있는 경우 도메인으로 향하는 인터넷 트래픽이 보안 취약성에 노출될 수 있습니다. 다른 위험도 초래할 수 있습니다. 자세한 내용은 *Amazon Route 53 개발자 안내서*의 [Route 53에서 누락된 위임 레코드 보호](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/protection-from-dangling-dns.html)를 참조하세요. *AWS 보안 블로그*의 [Amazon CloudFront 요청을 위한 강화된 도메인 보호](https://aws.amazon.com/blogs/security/enhanced-domain-protections-for-amazon-cloudfront-requests/)에서 매달린 DNS 항목에 대해 자세히 알아볼 수 있습니다. ## 구문 **eb terminate** **eb terminate *environment-name*** ## 옵션 **** | 이름 | 설명 | | --- | --- | | `--all` | 애플리케이션의 모든 환경과 애플리케이션의 [애플리케이션 버전](applications-versions.md) 및 [저장된 구성](environment-configuration-savedconfig.md)을 종료한 후 애플리케이션을 삭제합니다. | | `--force` | 확인 메시지를 표시하지 않고 환경을 종료합니다. | | `--ignore-links` | 환경 링크가 있는 종속 환경이 있더라도 환경을 종료합니다. [환경 작성](ebcli-compose.md)을 참조하십시오. | | `--timeout` | 명령 시간이 초과되기 전 경과되는 시간(분)입니다. | ## 출력 성공할 경우 명령이 `terminate` 작업의 상태를 반환합니다. ## 예제 다음은 환경 tmp-dev를 종료하는 요청 예제입니다. ``` $ eb terminate The environment "tmp-dev" and all associated instances will be terminated. To confirm, type the environment name: tmp-dev 2018-07-11 21:05:25 INFO: terminateEnvironment is starting. 2018-07-11 21:05:40 INFO: Deleted CloudWatch alarm named: awseb-e-2cpfjbra9a-stack-AWSEBCloudwatchAlarmHigh-16V08YOF2KQ7U 2018-07-11 21:05:41 INFO: Deleted CloudWatch alarm named: awseb-e-2cpfjbra9a-stack-AWSEBCloudwatchAlarmLow-6ZAWH9F20P7C 2018-07-11 21:06:42 INFO: Deleted Auto Scaling group policy named: arn:aws:autoscaling:us-east-2:11122223333:scalingPolicy:5d7d3e6b-d59b-47c5-b102-3e11fe3047be:autoScalingGroupName/awseb-e-2cpfjbra9a-stack-AWSEBAutoScalingGroup-7AXY7U13ZQ6E:policyName/awseb-e-2cpfjbra9a-stack-AWSEBAutoSca lingScaleUpPolicy-1876U27JEC34J 2018-07-11 21:06:43 INFO: Deleted Auto Scaling group policy named: arn:aws:autoscaling:us-east-2:11122223333:scalingPolicy:29c6e7c7-7ac8-46fc-91f5-cfabb65b985b:autoScalingGroupName/awseb-e-2cpfjbra9a-stack-AWSEBAutoScalingGroup-7AXY7U13ZQ6E:policyName/awseb-e-2cpfjbra9a-stack-AWSEBAutoSca lingScaleDownPolicy-SL4LHODMOMU 2018-07-11 21:06:48 INFO: Waiting for EC2 instances to terminate. This may take a few minutes. 2018-07-11 21:08:55 INFO: Deleted Auto Scaling group named: awseb-e-2cpfjbra9a-stack-AWSEBAutoScalingGroup-7AXY7U13ZQ6E 2018-07-11 21:09:10 INFO: Deleted security group named: awseb-e-2cpfjbra9a-stack-AWSEBSecurityGroup-XT4YYGFL7I99 2018-07-11 21:09:40 INFO: Deleted load balancer named: awseb-e-2-AWSEBLoa-AK6RRYFQVV3S 2018-07-11 21:09:42 INFO: Deleting SNS topic for environment tmp-dev. 2018-07-11 21:09:52 INFO: terminateEnvironment completed successfully. ``` # **eb upgrade** ## 설명 환경의 플랫폼을 현재 실행 중인 최신 플랫폼 버전으로 업그레이드합니다. 루트 디렉터리에 사용자 지정 플랫폼을 지정하는 `platform.yaml` 파일이 들어 있는 경우, 이 명령은 환경을 현재 실행 중인 최신 사용자 지정 플랫폼으로 업그레이드합니다. ## 구문 **eb upgrade** **eb upgrade *environment-name*** ## 옵션 **** | 이름 | 설명 | | --- | --- | | `--force` | 업그레이드 프로세스를 시작하기 전에 환경 이름을 확인하지 않고 업그레이드합니다. | | `--noroll` | 롤링 업데이트를 사용하지 않고 모든 인스턴스를 업데이트하여 업그레이드 중에 일부 인스턴스를 서비스 상태로 유지합니다. | | [일반 옵션](eb3-cmd-options.md) | | ## 출력 이 명령은 변경 개요를 보여 주고, 환경 이름을 입력하여 업그레이드를 확인하라는 메시지를 표시합니다. 성공할 경우 환경이 업데이트된 다음 최신 플랫폼 버전으로 시작됩니다. ## 예제 다음 예에서는 지정된 환경의 현재 플랫폼 버전을 사용 가능한 최신 플랫폼 버전으로 업그레이드합니다. ``` $ eb upgrade Current platform: 64bit Amazon Linux 2014.09 v1.0.9 running Python 2.7 Latest platform: 64bit Amazon Linux 2014.09 v1.2.0 running Python 2.7 WARNING: This operation replaces your instances with minimal or zero downtime. You may cancel the upgrade after it has started by typing "eb abort". You can also change your platform version by typing "eb clone" and then "eb swap". To continue, type the environment name: ``` # **eb use** ## 설명 지정된 환경을 기본 환경으로 설정합니다. Git을 사용할 경우 **eb use**는 현재 브랜치에 대한 기본 환경을 설정합니다. Elastic Beanstalk에 배포하려는 각 브랜치에서 이 명령을 한 번씩 실행합니다. ## 구문 **eb use *environment-name*** ## 옵션 **** | 이름 | 설명 | | --- | --- | | `--source codecommit/repository-name/branch-name` | CodeCommit 리포지토리 및 브랜치. | | `-r region` `--region region` | 환경을 생성할 리전을 변경합니다. | | [일반 옵션](eb3-cmd-options.md) | |