Systems Manager 유지 관리 기간에 자동화 작업을 등록할 때 파라미터를 추가하려면 어떻게 해야 합니까?

2분 분량
0

여러 Amazon Elastic Compute Cloud(Amazon EC2) 인스턴스를 대상으로 하는 AWS Systems Manager 유지 관리 기간에 자동화 문서 작업을 등록하려고 합니다. 어떻게 해야 하나요?

간략한 설명

유지 관리 기간 자동화 작업을 등록할 때에는 작업이 실행될 때 작업에 전달되는 입력 파라미터 값을 제공해야 합니다. 필요한 입력 파라미터는 자동화 문서 콘텐츠에 정의된 파라미터와 동일합니다. 필수 입력 파라미터 필드에 의사 파라미터 값을 사용하여 유지 관리 기간이 대상으로 하는 리소스 ID를 동적으로 참조할 수 있습니다. {{RESOURCE_ID}}와 같은 의사 파라미터를 사용하면 각 리소스 ID를 개별적으로 입력하지 않고도 여러 리소스를 대상으로 지정할 수 있습니다.

예를 들어, Amazon에서 제공한 AWS StopEC2Instance 문서를 사용하려면 인스턴스 ID를 파라미터로 입력해야 합니다. 유지 관리 기간에 여러 인스턴스를 대상으로 지정하려는 경우 또는 인스턴스 ID를 모르는 경우 의사 파라미터를 사용할 수 있습니다.

참고: 대상 유형 인스턴스의 경우 {{TARGET_ID}} 및 {{RESOURCE_ID}} 의사 파라미터는 모두 인스턴스 ID만 생성합니다. 그러나 대상 유형 리소스 그룹의 경우 {{TARGET_ID}} 및 {{RESOURCE_ID}}는 다른 형식으로 ID를 반환합니다. 자세한 내용 및 사용 가능한 의사 파라미터 목록은 의사 파라미터 정보를 참조하세요.

시스템 관리자 콘솔 또는 AWS 명령줄 인터페이스(AWS CLI)를 사용하여 유지 관리 기간 자동화 작업을 의사 파라미터로 등록할 수 있습니다.

해결 방법

콘솔 사용

동적 의사 파라미터를 사용하여 유지 관리 기간 자동화 작업을 등록하려면 다음 단계를 따르세요.

  1. Systems Manager 콘솔을 열고 탐색 창에서 **유지 관리 기간(Maintenance Windows)**을 선택합니다.
  2. 유지 관리 기간을 선택한 다음 **세부 정보 보기(View details)**를 선택합니다.
  3. 작업(Tasks) 탭에서 등록 작업(Register tasks), **자동화 등록 작업(Register Automation task)**을 선택합니다.
  4. 자동화 문서의 경우, 작업을 실행할 문서를 선택합니다.
  5. 대상, 속도 제어IAM 서비스 역할을 지정합니다.
  6. 입력 파라미터의 경우 리소스 ID가 필요한 파라미터에 대해 의사 파라미터 값(예: {{TARGET_ID}} 또는 {{RESOURCE_ID}})을 입력합니다.
  7. **자동화 등록 작업(Register Automation task)**을 선택합니다.

AWS CLI 사용

참고: AWS CLI 명령을 실행할 때 오류가 발생하는 경우 최신 버전의 AWS CLI를 사용하고 있는지 확인합니다.

다음 예시에서는 AWS CLI를 사용하여 {{RESOURCE_ID}} 파라미터를 포함한 자동화 작업을 등록합니다.

aws ssm register-task-with-maintenance-window --window-id mw-1234567890EXAMPLE --targets Key=WindowTargetIds,Values=6c226ea3-463a-4533-8a2d-EXAMPLE --task-arn AWS-StopEC2Instance --task-type AUTOMATION --name MyMaintenanceWindowTask --max-concurrency 10 --max-errors 5 --task-invocation-parameters={\"Automation\":{\"Parameters\":{\"InstanceId\":[\"{{RESOURCE_ID}}\"]}}} --service-role-arn YOUR_SERVICE_ROLE_ARN

유지 관리 기간 작업이 실행되면 각 대상에 대한 해당 리소스 ID가 시스템으로 전달됩니다. 앞의 예시에서 InstanceID 파라미터는 대상 그룹의 각 대상에 대한 해당 인스턴스 ID를 수신합니다.


관련 정보

지원되는 의사 파라미터

유지 관리 기간의 작업 등록 옵션 정보

AWS 공식
AWS 공식업데이트됨 3년 전