대상 없이 유지 관리 기간 태스크 등록 - AWS Systems Manager

대상 없이 유지 관리 기간 태스크 등록

생성하는 각 유지 관리 기간에 대해 유지 관리 기간이 실행될 때 수행할 하나 이상의 태스크를 지정할 수 있습니다. 대부분의 경우 태스크를 실행할 리소스 또는 대상을 지정해야 합니다. 그러나 태스크에서 대상을 명시적으로 지정할 필요가 없는 경우도 있습니다.

유지 관리 기간 Systems Manager Run Command 유형 태스크에 대해 하나 이상의 대상을 지정해야 합니다. 태스크 특성에 따라 대상은 다른 유지 관리 기간 태스크 유형(Systems Manager Automation, AWS Lambda 및 AWS Step Functions)에 대해 옵션입니다.

Lambda 및 Step Functions 태스크 유형의 경우 대상이 필요한지 여부는 생성한 기능 또는 상태 시스템의 콘텐츠에 따라 달라집니다.

대부분의 경우 자동화 태스크의 대상을 명시적으로 지정할 필요가 없습니다. 예를 들어 AWS-UpdateLinuxAmi 실행서를 사용하여 Linux용 Amazon Machine Image(AMI)를 업데이트하는 Automation 유형 태스크를 생성한다고 가정해 보겠습니다. 태스크가 실행되면 AMI는 사용 가능한 최신 Linux 배포 패키지와 Amazon 소프트웨어로 업데이트됩니다. AMI에서 생성된 새 인스턴스에는 이러한 업데이트가 이미 설치되어 있습니다. 업데이트할 AMI의 ID가 실행서에 대한 입력 파라미터에 지정되어 유지 관리 기간 태스크에서 대상을 다시 지정할 필요가 없습니다.

마찬가지로 AWS Command Line Interface(AWS CLI)를 사용하여 AWS-RestartEC2Instance 런북을 사용하는 유지 관리 기간 Automation 태스크를 등록한다고 가정합니다. 다시 시작할 노드가 --task-invocation-parameters 인수에 지정되어 있으므로 --targets 옵션도 지정할 필요가 없습니다.

참고

대상이 지정되지 않은 유지 관리 기간 태스크의 경우 --max-errors--max-concurrency 값을 제공할 수 없습니다. 그 대신에 시스템에서 describe-maintenance-window-tasksget-maintenance-window-task와 같은 명령에 대한 응답으로 보고될 수 있는 자리 표시자 값 1을 삽입합니다. 이러한 값은 태스크 실행에 영향을 주지 않으며 무시할 수 있습니다.

다음 예제에서는 대상 없는 유지 관리 기간 태스크에 대해 --targets, --max-errors--max-concurrency 옵션을 생략하는 방법을 보여줍니다.

Linux & macOS
aws ssm register-task-with-maintenance-window \ --window-id "mw-ab12cd34eEXAMPLE" \ --service-role-arn "arn:aws:iam::123456789012:role/MaintenanceWindowAndAutomationRole" \ --task-type "AUTOMATION" \ --name "RestartInstanceWithoutTarget" \ --task-arn "AWS-RestartEC2Instance" \ --task-invocation-parameters "{\"Automation\":{\"Parameters\":{\"InstanceId\":[\"i-02573cafcfEXAMPLE\"]}}}" \ --priority 10
Windows
aws ssm register-task-with-maintenance-window ^ --window-id "mw-ab12cd34eEXAMPLE" ^ --service-role-arn "arn:aws:iam::123456789012:role/MaintenanceWindowAndAutomationRole" ^ --task-type "AUTOMATION" ^ --name "RestartInstanceWithoutTarget" ^ --task-arn "AWS-RestartEC2Instance" ^ --task-invocation-parameters "{\"Automation\":{\"Parameters\":{\"InstanceId\":[\"i-02573cafcfEXAMPLE\"]}}}" ^ --priority 10
참고

2020년 12월 23일 이전에 등록된 유지 관리 기간 작업의 경우: 작업에 대상을 지정했고 하나가 더는 필요 없으면 Systems Manager 콘솔 또는 update-maintenance-window-task AWS CLI 명령으로 해당 작업을 업데이트하여 대상을 제거할 수 있습니다.