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 애플리케이션 마이그레이션 섹션을 참조하세요.

참고

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

AWS OpsWorks Stacks가 모든 인스턴스에 설치하는 에이전트는 명령줄 인터페이스(CLI)를 표시합니다. 인스턴스에 SSH를 사용하여 로그인하는 경우 CLI를 사용하여 다음 작업을 수행할 수 있습니다.

• Chef 실행 로그 파일에 액세스

• AWS OpsWorks Stacks 명령에 액세스

• 수동으로 Chef 레시피 실행

• 인스턴스 보고서 보기

• 에이전트 보고서 보기

• 일부 스택 구성 및 배포 속성 보기

중요

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

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

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

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

help

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

명령

(선택 사항) 다음 중 하나로 설정되어야 하는 CLI 명령입니다.

• agent_report

• get_json

• instance_report

• list_commands

• run_command

• show_log

• stack_state

activity

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

날짜

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

참고

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

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

주제

• agent_report
• get_json
• instance_report
• list_commands
• run_command
• show_log
• stack_state