기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# OpsWorks Stacks CLI 사용
<a name="cli-examples"></a>

**중요**  
이 AWS OpsWorks Stacks 서비스는 2024년 5월 26일에 수명이 종료되었으며 신규 및 기존 고객 모두에서 비활성화되었습니다. 가능한 한 빨리 워크로드를 다른 솔루션으로 마이그레이션하는 것이 좋습니다. 마이그레이션에 대한 질문이 있는 경우 [AWS re:Post](https://repost.aws/) 또는 [AWS Premium Support](https://aws.amazon.com/support)를 통해 AWS Support 팀에 문의하세요.

 OpsWorks Stacks 명령줄 인터페이스(CLI)는 콘솔과 동일한 기능을 제공하며 다양한 작업에 사용할 수 있습니다. Stacks CLI는 OpsWorks 의 일부입니다 AWS CLI. 설치 및 구성 방법을 비롯한 자세한 내용은 [AWS 명령줄 인터페이스란 무엇입니까?를](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) AWS CLI참조하십시오. 각 명령에 대한 전체 설명은 [OpsWorks Stacks reference](https://docs.aws.amazon.com/cli/latest/reference/opsworks/index.html)를 참조하세요.

**참고**  
Windows 기반 워크스테이션을 사용하는 경우 AWS Tools for Windows PowerShell을 실행하여 명령줄에서 OpsWorks Stacks 작업을 수행할 수도 있습니다. 자세한 내용은 [AWS Tools for Windows PowerShell](https://aws.amazon.com/documentation/powershell/)을 참조하세요.

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 객체로 패키징하여 반환합니다. 다음 섹션에는 몇 가지 예제가 포함되어 있습니다. 각 명령에서 반환되는 값에 대한 자세한 설명은 [OpsWorks Stacks reference](https://docs.aws.amazon.com/cli/latest/reference/opsworks/index.html)를 참조하세요.

**참고**  
AWS CLI 명령은 예제와 같이 리전을 지정해야 합니다. 다음 테이블에 --region 파라미터에 유효한 값이 나와 있습니다. OpsWorks Stacks 명령 문자열을 단순화하려면 `--region` 파라미터를 생략할 수 있도록 기본 리전을 지정하도록 CLI를 구성합니다. 일반적으로 여러 리전 엔드포인트에서 작업하는 경우 기본 리전 엔드포인트를 사용하도록 AWS CLI 를 구성하지 마십시오. 캐나다(중부) 리전 엔드포인트는 API에서만 사용할 수 있으며 AWS CLI 에서 생성한 스택에는 사용할 수 없습니다 AWS Management Console. 자세한 내용은 [AWS 리전 구성](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-installing-specifying-region)을 참조하세요.  


| 리전 이름 | 명령 코드 | 
| --- | --- | 
| 미국 동부(오하이오) 리전 | us-east-2 | 
| 미국 동부(버지니아 북부) 리전 | us-east-1 | 
| 미국 서부(캘리포니아 북부) 리전 | us-west-1 | 
| 미국 서부(오리곤) 리전 | us-west-2 | 
| 캐나다(중부) 리전 | ca-central-1 | 
| 유럽(아일랜드) 리전 | 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 명령을 사용하려면 해당 권한이 있어야 합니다. OpsWorks Stacks 권한에 대한 자세한 정보는 [사용자 권한 관리](opsworks-security-users.md) 단원을 참조하세요. 특정 명령에 필요한 권한을 결정하려면 [OpsWorks Stacks reference](https://docs.aws.amazon.com/cli/latest/reference/opsworks/index.html)에서 명령의 참조 페이지를 참조하세요.

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