실행서를 유지 관리 기간의 등록된 태스크로 구성하여 자동화를 시작할 수 있습니다. 실행서를 등록된 태스크로 등록하면 유지 관리 기간은 예약된 유지 관리 기간 중에 자동화를 실행합니다.
예를 들어 유지 관리 기간에 대상으로 등록된 인스턴스의 Amazon Machine Image(AMI)를 만드는 CreateAMI라는 실행서를 생성한다고 가정해 보겠습니다. CreateAMI 실행서와 해당 자동화를 유지 관리 기간의 등록된 태스크로 지정하려면 먼저 유지 관리 기간을 생성하고 대상을 등록합니다. 그런 다음, 다음 절차에 따라 유지 관리 기간에서 CreateAMI 문서를 등록된 태스크로 지정합니다. 예약된 기간 중에 유지 관리 기간이 시작되면 시스템은 자동화를 실행하여 등록된 대상의 AMI를 생성합니다.
Automation 실행서 생성에 대한 자세한 내용은 사용자 런북 생성 섹션을 참조하세요. Automation은 AWS Systems Manager의 도구입니다.
AWS Systems Manager 콘솔, AWS Command Line Interface(AWS CLI) 또는 AWS Tools for Windows PowerShell에서 다음 절차에 따라 자동화를 유지 관리 기간의 등록된 태스크로 구성합니다.
자동화 태스크를 유지 관리 기간으로 등록(콘솔)
다음 절차에서는 Systems Manager 콘솔을 사용하여 자동화를 유지 관리 기간의 등록된 태스크로 구성하는 방법을 설명합니다.
시작하기 전 준비 사항
다음 절차를 완료하기 전에 유지 관리 기간을 생성하고 하나 이상의 대상을 등록해야 합니다. 자세한 내용은 다음 절차를 참조하세요.
자동화를 유지 관리 기간의 등록된 태스크로 구성하려면
AWS Systems Manager 콘솔(https://console.aws.amazon.com/systems-manager/
)을 엽니다. -
왼쪽 탐색 창에서 Maintenance Windows를 선택하고 자동화 작업을 등록하려는 유지 관리 기간을 선택합니다.
-
작업을 선택합니다. 그런 다음 [자동화 태스크 등록(Register Automation task)]을 선택하여 실행서를 사용해 대상에서 원하는 자동화를 실행합니다.
-
이름에 작업 이름을 입력합니다.
-
설명에 설명을 입력합니다.
-
[문서(Document)]에서 실행할 태스크를 정의하는 실행서를 선택합니다.
-
[문서 버전(Document version)]에서 사용할 실행서 버전을 선택합니다.
-
[태스크 우선순위(Task priority)]에서 이 태스크의 우선순위를 지정합니다.
1이 가장 높은 우선순위입니다. 유지 관리 기간의 작업은 우선순위에 따라 예약되며, 우선순위가 같은 작업은 동시에 예약됩니다. -
[대상(Targets)] 섹션에서 선택한 실행서가 리소스에 대한 태스크를 실행하는 경우 태그를 지정하거나 수동으로 인스턴스를 선택하여 이 자동화를 실행할 대상을 식별합니다.
참고
대상 대신 입력 파라미터를 통해 리소스를 전달하려는 경우 유지 관리 기간 대상을 지정할 필요가 없습니다.
대부분의 경우 자동화 태스크의 대상을 명시적으로 지정할 필요가 없습니다. 예를 들어
AWS-UpdateLinuxAmi실행서를 사용하여 Linux용 Amazon Machine Image(AMI)를 업데이트하는 Automation 유형 태스크를 생성한다고 가정해 보겠습니다. 태스크가 실행되면 AMI는 사용 가능한 최신 Linux 배포 패키지와 Amazon 소프트웨어로 업데이트됩니다. AMI에서 생성된 새 인스턴스에는 이러한 업데이트가 이미 설치되어 있습니다. 업데이트할 AMI의 ID가 실행서에 대한 입력 파라미터에 지정되어 유지 관리 기간 태스크에서 대상을 다시 지정할 필요가 없습니다.대상이 필요하지 않은 유지 관리 기간 태스크에 대한 자세한 내용은 대상 없이 유지 관리 기간 태스크 등록 섹션을 참조하세요.
-
(선택 사항) 속도 제어:
참고
실 행중인 태스크가 대상을 지정하지 않으면 속도 제어를 지정할 필요가 없습니다.
-
동시성(Concurrency)에 자동화를 동시에 실행할 대상의 수 또는 백분율을 지정합니다.
태크 키-값 페어를 선택하여 대상을 선택했지만 몇 개의 대상이 선택된 태그를 사용할지 확실치 않다면 백분율을 지정하여 동시에 실행할 수 있는 자동화 수를 제한합니다.
유지 관리 기간이 실행되면 대상별로 새로운 자동화가 시작됩니다. AWS 계정당 동시 자동화는 100개로 제한됩니다. 100보다 높은 동시성을 지정할 경우 100개를 초과하는 동시 자동화는 자동화 대기열에 자동으로 추가됩니다. 자세한 내용은 Amazon Web Services 일반 참조의 Systems Manager 서비스 할당량을 참조하세요.
-
[오류 임계값(Error threshold)]에서 대상 수 또는 백분율 때문에 실패한 후 언제 다른 대상에서 자동화 실행을 중지할지 지정합니다. 예를 들어 세 번의 오류를 지정할 경우 Systems Manager는 네 번째 오류가 수신하면 자동화 실행을 중지합니다. 여전히 자동화를 처리하는 대상도 오류를 보낼 수 있습니다.
-
-
[입력 파라미터(Input Parameters)] 섹션에서 실행서의 파라미터를 지정합니다. 실행서의 경우 시스템에서 일부 값을 자동으로 채웁니다. 이러한 값을 유지하거나 바꿀 수 있습니다.
중요
실행서의 경우 선택적으로 Automation 수임 역할을 지정할 수 있습니다. 이 파라미터에 역할을 지정하지 않으면 자동화가 11단계에서 선택한 유지 관리 기간 서비스 역할을 수임합니다. 그러므로 선택한 유지 관리 기간 서비스 역할이 실행서 내에 정의된 작업을 수행할 수 있는 적절한 AWS Identity and Access Management(IAM) 권한을 가지고 있는지 확인해야 합니다.
예를 들어 Systems Manager용 서비스 연결 역할은 실행서
AWS-CopySnapshot을 실행하는 데 필요한 IAM 권한ec2:CreateSnapshot이 없습니다. 이 시나리오에서는 사용자 지정 유지 관리 기간 서비스 역할을 사용하거나ec2:CreateSnapshot권한이 있는 자동화 수임 역할을 지정해야 합니다. 자세한 내용은 Automation 설정을 참조하세요. -
IAM 서비스 역할(IAM service role) 영역에서 역할을 선택하여 Systems Manager에 자동화를 시작할 수 있는 권한을 부여합니다.
유지 관리 기간 작업을 위한 사용자 지정 서비스 역할을 생성하려면 Maintenance Windows 설정의 내용을 참조하세요.
-
자동화 작업 등록을 선택합니다
Automation 태스크를 유지 관리 기간으로 등록(명령줄)
다음 절차에서는 AWS CLI(Linux 또는 Windows) 또는 AWS Tools for PowerShell을 사용하여 자동화를 유지 관리 기간의 등록된 태스크로 구성하는 방법을 설명합니다.
시작하기 전 준비 사항
다음 절차를 완료하기 전에 유지 관리 기간을 생성하고 하나 이상의 대상을 등록해야 합니다. 자세한 내용은 다음 절차를 참조하세요.
자동화를 유지 관리 기간의 등록된 태스크로 구성하려면
아직 하지 않은 경우 AWS CLI 또는 AWS Tools for PowerShell을 설치하고 구성합니다.
자세한 내용은 최신 버전의 AWS CLI 설치 또는 업데이트 및 AWS Tools for PowerShell 설치를 참조하세요.
-
자동화를 유지 관리 기간의 등록된 태스크로 구성하기 위한 명령을 생성합니다. 각
example resource placeholder를 사용자의 정보로 바꿉니다.aws ssm register-task-with-maintenance-window \ --window-idwindow ID\ --nametask name\ --task-arnrunbook name\ --targets Key=targets,Values=value\ --service-role-arnIAM role arn\ --task-type AUTOMATION \ --task-invocation-parameterstask parameters\ --prioritytask priority\ --max-concurrency10%\ --max-errors5참고
AWS CLI를 사용하여 등록된 태스크로 자동화를 구성하려면
--Task-Invocation-Parameters파라미터를 사용하여 태스크 실행 시 태스크에 전달할 파라미터를 지정합니다.--Task-Parameters파라미터를 사용하지 마십시오.--Task-Parameters파라미터는 레거시 파라미터입니다.대상이 지정되지 않은 유지 관리 기간 태스크의 경우
--max-errors및--max-concurrency값을 제공할 수 없습니다. 그 대신에 시스템에서 describe-maintenance-window-tasks 및 get-maintenance-window-task와 같은 명령에 대한 응답으로 보고될 수 있는 자리 표시자 값1을 삽입합니다. 이러한 값은 태스크 실행에 영향을 주지 않으며 무시할 수 있습니다.대상이 필요하지 않은 유지 관리 기간 태스크에 대한 자세한 내용은 대상 없이 유지 관리 기간 태스크 등록 섹션을 참조하세요.
다음 예에서는 자동화를 우선순위 1의 유지 관리 기간의 등록된 태스크로 구성합니다. 또한 대상 없는 유지 관리 기간 태스크에 대해
--targets,--max-errors및--max-concurrency옵션을 생략하는 방법도 보여줍니다. 자동화는AWS-StartEC2Instance실행서 및 지정된 Automation 수임 역할을 사용하여 유지 관리 기간의 대상으로 등록된 EC2 인스턴스를 시작합니다. 유지 관리 기간은 지정된 시간에 최대 5번의 인스턴스에서 동시에 자동화를 실행합니다. 또한 등록된 태스크는 오류 수가 1을 초과하는 경우 특정 간격에 대해 더 많은 인스턴스에서 실행을 중지합니다.aws ssm register-task-with-maintenance-window \ --window-id mw-0c50858d01EXAMPLE \ --name StartEC2Instances \ --task-arn AWS-StartEC2Instance \ --service-role-arn arn:aws:iam::123456789012:role/MaintenanceWindowRole \ --task-type AUTOMATION \ --task-invocation-parameters "{\"Automation\":{\"Parameters\":{\"InstanceId\":[\"{{TARGET_ID}}\"],\"AutomationAssumeRole\":[\"arn:aws:iam::123456789012:role/AutomationAssumeRole\"]}}}" \ --priority 1이 명령은 다음과 비슷한 새로운 등록된 작업의 세부 정보를 반환합니다.
{ "WindowTaskId": "4f7ca192-7e9a-40fe-9192-5cb15EXAMPLE" } -
등록된 작업을 보려면 다음 명령을 실행합니다.
유지 관리 기간 ID를 자신의 정보로 바꿉니다.aws ssm describe-maintenance-window-tasks \ --window-idmaintenance window ID시스템은 다음과 같은 정보를 반환합니다.
{ "Tasks": [ { "ServiceRoleArn": "arn:aws:iam::123456789012:role/MaintenanceWindowRole", "MaxErrors": "1", "TaskArn": "AWS-StartEC2Instance", "MaxConcurrency": "1", "WindowTaskId": "4f7ca192-7e9a-40fe-9192-5cb15EXAMPLE", "TaskParameters": {}, "Priority": 1, "WindowId": "mw-0c50858d01EXAMPLE", "Type": "AUTOMATION", "Targets": [ ], "Name": "StartEC2" } ] }
