

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

# OpsWorks Stacks 에이전트 CLI
<a name="agent"></a>

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

**참고**  
이 기능은 Linux 인스턴스에서만 사용할 수 있습니다.

 OpsWorks Stacks가 모든 인스턴스에 설치하는 에이전트는 명령줄 인터페이스(CLI)를 노출합니다. 인스턴스에 [SSH를 사용하여 로그인](workinginstances-ssh.md)하는 경우 CLI를 사용하여 다음 작업을 수행할 수 있습니다.
+ Chef 실행 로그 파일에 액세스 
+ Stacks 명령 OpsWorks 에 액세스합니다.
+ 수동으로 Chef 레시피 실행
+ 인스턴스 보고서 보기
+ 에이전트 보고서 보기
+ 일부 스택 구성 및 배포 속성 보기 

**중요**  
에이전트 CLI 명령은 루트 사용자이거나 `sudo`를 사용해야만 실행할 수 있습니다.

기본 명령 구문은 다음과 같습니다.

```
sudo opsworks-agent-cli [--help] [command [activity] [date]]
```

4개 인수는 다음과 같습니다.

**help**  
(선택 사항) 단독으로 사용될 경우 사용 가능한 명령에 대해 간략한 개요를 표시합니다. 명령과 함께 사용될 경우 `help`는 명령에 대한 설명을 표시합니다.

**명령**  
(선택 사항) 다음 중 하나로 설정되어야 하는 CLI 명령입니다.  
+ [agent\$1report](agent-report.md)
+ [get\$1json](agent-json.md)
+ [instance\$1report](agent-instance.md)
+ [list\$1commands](agent-list.md)
+ [run\$1command](agent-run.md)
+ [show\$1log](agent-show.md)
+ [stack\$1state](agent-stack.md)

**activity**  
(선택 사항) 일부 명령과 함께 인수로 사용되어 특정 OpsWorks Stacks 활동을 지정합니다. `setup`, `configure`, `deploy`, `undeploy`, `start`, `stop` 또는 `restart` 

**date**  
(선택 사항) 일부 명령과 함께 인수로 사용되어 특정 OpsWorks Stacks 명령 실행을 지정합니다. **date**를 명령이 실행된 타임스탬프(*yyyy-mm-ddThh:mm:ss* 형식, 작은 따옴표로 묶음)로 지정하여 명령 실행을 지정합니다. 예를 들어 2013년 2월 5일(화요일) 10:31:55는 `'2013-02-05T10:31:55'`를 사용합니다. 특정 OpsWorks Stacks 명령이 실행된 시기를 확인하려면를 실행합니다[list\$1commands](agent-list.md).

**참고**  
에이전트가 동일한 OpsWorks Stacks 활동을 여러 번 실행한 경우 활동 및 실행 시간을 모두 지정하여 특정 실행을 선택할 수 있습니다. 활동을 지정하고 시간을 생략하면 에이전트 CLI 명령이 해당 활동의 가장 최근 실행에 적용됩니다. 두 인수를 모두 생략하면 에이전트 CLI 명령은 가장 최근 활동에 적용됩니다.

다음 섹션에서는 명령 및 관련 인수를 설명합니다. 간결한 설명을 위해 구문 섹션에서는 모든 명령에서 사용할 수 있는 `--help` 옵션(선택 사항)을 생략했습니다.

**Topics**
+ [agent\$1report](agent-report.md)
+ [get\$1json](agent-json.md)
+ [instance\$1report](agent-instance.md)
+ [list\$1commands](agent-list.md)
+ [run\$1command](agent-run.md)
+ [show\$1log](agent-show.md)
+ [stack\$1state](agent-stack.md)