ecs-cli compose - Amazon Elastic Container Service

ecs-cli compose

ECS 클러스터에서 docker-compose-style 명령을 사용하여 Amazon ECS 태스크를 관리합니다. Amazon ECS CLI에서 Docker Compose 파일 구문이 작동하는 방식에 관한 자세한 내용은 Docker compose 파일 구문 사용 섹션을 참조하세요.

참고

Amazon ECS CLI로 Amazon ECS 서비스를 생성하려면 ecs-cli compose service를 참조하세요.

ecs-cli compose 명령은 생성되는 태스크 정의 및 서비스에 프로젝트 이름을 사용합니다. CLI가 Compose 파일로부터 태스크 정의를 생성하면 해당 태스크 정의는 project-name으로 불립니다. CLI가 Compose 파일로부터 서비스를 생성하면 해당 서비스는 service-project-name으로 불립니다. 프로젝트 이름은 기본적으로 Docker Compose 파일이 있는 디렉터리의 이름입니다. 하지만 --project-name 옵션을 사용하여 자체 프로젝트 이름을 지정할 수도 있습니다.

참고

Amazon ECS CLI는 Amazon ECS CLI를 통해 만든 태스크, 서비스 및 컨테이너 인스턴스만 관리할 수 있습니다. Amazon ECS CLI를 사용해 만들지 않은 태스크, 서비스 및 컨테이너 인스턴스를 관리하려면 AWS Command Line Interface 또는 AWS Management Console을 사용합니다.

중요

설명된 일부 기능은 최신 Amazon ECS CLI 버전에만 제공될 수도 있습니다. 최신 버전을 가져오는 방법에 대한 자세한 내용은 Amazon ECS CLI 설치 섹션을 참조하세요.

구문

ecs-cli compose [--verbose] [--file compose_file] [--project-name project_name] [--task-role-arn task_role_arn] [--ecs-params ecs_params_file] [--registry-creds value] [--region region] [--cluster-config cluster_config_name] [--ecs-profile ecs_profile] [--aws-profile aws_profile] [--cluster cluster_name] [--help] [subcommand] [arguments] [--help]

옵션

이름

설명

--verbose, --debug

진단을 돕기 위해 출력된 명령의 세부 수준을 높입니다.

필수 항목 여부: 아니요

--file, -f compose_file

사용할 Docker Compose 파일을 지정합니다. 현재, 최신 버전의 Amazon ECS CLI는 Docker Compose 파일 구문 버전 1, 2, 3의 주요 버전만 지원합니다. Compose 파일에 지정된 버전은 문자열 "1", "1.0", "2", "2.0", "3" 또는 "3.0"이어야 합니다. Docker Compose 하위 버전은 지원하지 않습니다. ecs-cli compose가 실행될 때 COMPOSE_FILE 환경 변수가 설정되어 있는 경우 Docker Compose 파일이 해당 환경 변수의 값으로 설정됩니다.

유형: String

기본값: ./docker-compose.yml

필수 항목 여부: 아니요

--project-name, -p project_name

사용할 프로젝트 이름을 지정합니다. ecs-cli compose가 실행될 때 COMPOSE_PROJECT_NAME 환경 변수가 설정되어 있는 경우 프로젝트 이름이 해당 환경 변수의 값으로 설정됩니다.

유형: String

기본값: 현재 디렉터리 이름.

필수 항목 여부: 아니요

--task-role-arn role_value

이 태스크의 컨테이너가 가질 수 있는 IAM 역할의 전체 Amazon 리소스 이름(ARN) 또는 짧은 이름을 지정합니다. 이 태스크의 모든 컨테이너에게는 이 역할에 지정된 권한이 부여됩니다.

유형: 문자열

필수 항목 여부: 아니요

--ecs-params ecs_params_file

Docker Compose 파일에 고유하지 않은 ECS 파라미터를 지정합니다. 자세한 내용은 Amazon ECS 파라미터 사용 섹션을 참조하세요.

기본값: ./ecs-params.yml

필수 항목 여부: 아니요

--registry-creds value

사용할 Amazon ECS 레지스트리 자격 증명을 지정합니다. 기본값은 ecs-cli registry-creds up 명령의 최신 출력 파일(존재하는 경우)입니다. 자세한 내용은 ecs-cli registry-creds 섹션을 참조하세요.

기본값: ./ecs-registry-creds_[TIMESTAMP].yml

필수 항목 여부: 아니요

--region, -r region

사용할 AWS 리전을 지정합니다. 기본값은 configure 명령을 이용해 구성된 클러스터입니다.

유형: 문자열

필수 항목 여부: 아니요

--cluster-config cluster_config_name

사용할 Amazon ECS 클러스터 구성의 이름을 지정합니다. 기본값은 기본값으로 설정된 클러스터 구성입니다.

유형: 문자열

필수 항목 여부: 아니요

--ecs-profile ecs_profile

사용할 Amazon ECS 프로필 구성의 이름을 지정합니다. 기본값은 configure profile 명령을 사용하여 구성된 프로필입니다.

유형: 문자열

필수 항목 여부: 아니요

--aws-profile aws_profile

사용할 AWS 프로필을 지정합니다. ~/.aws/credentials의 기존 명명된 프로필로부터 AWS 자격 증명을 사용할 수 있습니다.

유형: 문자열

필수 항목 여부: 아니요

--cluster, -c cluster_name

사용할 Amazon ECS 클러스터 이름을 지정합니다. 기본값은 configure 명령을 이용해 구성된 클러스터입니다.

유형: 문자열

필수 항목 여부: 아니요

--help, -h

지정한 명령에 대한 도움말을 표시합니다.

필수 항목 여부: 아니요

사용 가능한 하위 명령

ecs-cli compose 명령은 다음 하위 명령을 지원합니다. 이러한 하위 명령에는 각각 자체적인 플래그가 연결되어 있으며 --help 플래그로 표시할 수 있습니다.

create

Compose 파일에서 Amazon ECS 태스크 정의를 생성합니다. 자세한 내용은 ecs-cli compose create 섹션을 참조하세요.

ps, list

클러스터에서 Compose 프로젝트가 시작한 모든 컨테이너를 나열합니다.

run [containerName] ["command ..."] ...

컨테이너에 대해 제공된 일회용 명령을 사용하여 명령을 무시하며 모든 컨테이너를 시작합니다.

scale n

실행 태스크 수를 지정한 개수로 조정합니다.

start

Compose 파일로부터 생성된 태스크 정의에서 단일 태스크를 시작합니다. 자세한 내용은 ecs-cli compose start 섹션을 참조하세요.

stop, down

Compose 프로젝트가 시작한 실행 태스크를 모두 중지합니다.

up

ECS 태스크 정의가 없는 경우 Compose 파일로부터 ECS 태스크 정의를 생성하고, 클러스터에서 그 태스크의 인스턴스 하나를 실행합니다(createstart의 조합). 자세한 내용은 ecs-cli compose up 섹션을 참조하세요.

service [subcommand]

Compose 파일로부터 ECS 서비스를 생성합니다. 자세한 내용은 ecs-cli compose service 섹션을 참조하세요.

help

지정한 명령에 대한 도움말을 표시합니다.