AWS OpsWorks Stacks CLI 사용

중요

AWS OpsWorks Stacks은 더 이상 신규 고객을 받지 않습니다. 기존 고객은 2024년 5월 26일까지 OpsWorks 콘솔, API, CLI, CloudFormation 리소스를 정상적으로 사용할 수 있으며, 이때 중단될 예정입니다. 이러한 전환에 대비하려면 가능한 한 빨리 스택을 AWS Systems Manager으로 전환하는 것이 좋습니다. 자세한 정보는 AWS OpsWorks Stacks 수명 종료 관련 자주 묻는 질문 및 AWS Systems Manager 애플리케이션 관리자로 AWS OpsWorks Stacks 애플리케이션 마이그레이션 섹션을 참조하세요.

AWS OpsWorks Stacks 명령줄 인터페이스(CLI)는 콘솔과 동일한 기능을 제공하며 다양한 작업에 사용됩니다. AWS OpsWorks Stacks CLI는 AWS CLI의 일부입니다. AWS CLI 설치 및 구성 방법을 포함한 자세한 내용은 AWS 명령줄 인터페이스란 무엇입니까?를 참조하십시오. 각 명령에 대한 전체 설명은 AWS OpsWorks Stacks reference를 참조하십시오.

참고

Windows 기반 워크스테이션을 사용하는 경우 AWS Tools for Windows PowerShell을 실행하여 명령줄에서 AWS OpsWorks Stacks 작업을 수행할 수도 있습니다. 자세한 내용은 AWS Tools for Windows PowerShell을 참조하십시오.

AWS OpsWorks Stacks 명령은 다음의 일반 형식을 따릅니다.

aws opsworks --region us-west-1 opsworks command-name [--argument1 value] [...]

인수 값이 JSON 객체일 경우 " 문자를 이스케이프해야 하며, 그렇지 않을 경우 명령이 잘못된 JSON이라는 오류를 반환할 수 있습니다. 예를 들어 JSON 객체가 "{"somekey":"somevalue"}"일 경우 "{\"somekey\":\"somevalue\"}" 형식을 사용해야 합니다. 대안적 방법은 JSON 객체를 파일에 배치하고 file://을 사용하여 명령줄에 포함시키는 것입니다. 다음 예제는 appsource.json에 저장된 애플리케이션 소스 객체를 사용하여 앱을 생성합니다.

aws opsworks --region us-west-1 create-app --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8 --name SimpleJSP --type java --app-source file://appsource.json 

대부분의 명령은 하나 이상의 값을 하나의 JSON 객체로 패키징하여 반환합니다. 다음 섹션에는 몇 가지 예제가 포함되어 있습니다. 각 명령에서 반환되는 값에 대한 자세한 설명은 AWS OpsWorks Stacks reference를 참조하십시오.

참고

AWS CLI 명령은 예제에 나와 있듯이 리전을 지정해야 합니다. 다음 테이블에 --region 파라미터에 유효한 값이 나와 있습니다. AWS OpsWorks Stacks 명령 문자열을 간소화하려면 --region 파라미터를 생략할 수 있도록 CLI를 구성하여 기본 리전을 지정하십시오. 일반적으로 여러 리전 엔드포인트에서 작업하는 경우 기본 리전 엔드포인트를 사용하도록 AWS CLI를 구성하지 마십시오. 캐나다(중부) 리전 엔드포인트는 API 및 AWS CLI에서만 사용할 수 있습니다. AWS Management Console에서 생성하는 스택에는 사용할 수 없습니다. 자세한 내용은 AWS 리전 구성을 참조하십시오.

리전 이름	명령 코드
미국 동부(오하이오) 리전	us-east-2
리전 - 미국 동부(버지니아 북부)	us-east-1
미국 서부(캘리포니아 북부) 리전	us-west-1
미국 서부(오레곤) 리전	us-west-2
캐나다(중부) 리전	ca-central-1
Europe (Ireland) Region	eu-west-1
유럽(런던) 리전	eu-west-2
유럽(파리) 리전	eu-west-3
유럽(프랑크푸르트) 리전	eu-central-1
아시아 태평양(도쿄) 리전	ap-northeast-1
아시아 태평양(서울) 리전	ap-northeast-2
아시아 태평양(뭄바이) 리전	ap-south-1
아시아 태평양(싱가포르) 리전	ap-southeast-1
아시아 태평양(시드니) 리전	ap-southeast-2
남아메리카(상파울루) 리전	sa-east-1

CLI 명령을 사용하려면 해당 권한이 있어야 합니다. AWS OpsWorks Stacks 권한에 대한 자세한 정보는 사용자 권한 관리 단원을 참조하십시오. 특정 명령에 필요한 권한을 결정하려면 AWS OpsWorks Stacks reference에서 명령의 참조 페이지를 참조하십시오.

다음 섹션에서는 AWS OpsWorks Stacks CLI를 사용하여 다양한 일반 작업을 수행하는 방법을 설명합니다.