Systems Manager Automation 문제 해결 - AWS Systems Manager

Systems Manager Automation 문제 해결

다음 정보를 사용하면 자동화 서비스 문제를 해결하는 데 도움이 됩니다. 이 주제에는 자동화 오류 메시지를 기반으로 문제를 해결하기 위한 특정 작업이 포함됩니다.

일반적인 Automation 오류

이 섹션에는 일반적인 자동화 오류에 대한 정보가 나와 있습니다.

VPC not defined 400

기본적으로 자동화가 AWS-UpdateLinuxAmi 문서 또는 AWS-UpdateWindowsAmi 문서를 실행하면 시스템이 기본 VPC에 임시 인스턴스를 생성합니다(172.30.0.0/16). 기본 VPC를 삭제했다면 다음 오류 메시지를 받게 됩니다.

VPC not defined 400

이 문제를 해결하려면 SubnetId 입력 파라미터의 값을 지정해야 합니다.

Automation 실행 시작이 실패함

자동화에 대한 IAM 사용자, 역할 및 정책을 제대로 구성하지 않은 경우 자동화 실행은 액세스 거부 오류 또는 유효하지 않은 assume role 오류와 함께 실패할 수 있습니다.

액세스가 거부되었습니다

다음 예제는 자동화 실행 시작이 액세스 거부 오류와 함께 실패한 경우에 대해 설명합니다.

Systems Manager API에 대한 액세스 거부됨

오류 메시지: User: user arn is not authorized to perform: ssm:StartAutomationExecution on resource: document arn (Service: AWSSimpleSystemsManagement; Status Code: 400; Error Code: AccessDeniedException; Request ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)

  • 가능한 원인 1: 자동화 실행을 시작하려고 시도하는 IAM 사용자에게 StartAutomationExecution API를 호출할 수 있는 권한이 없습니다. 이 문제를 해결하려면 실행을 시작하는 데 사용된 사용자 계정에 필요한 IAM 정책을 연결하십시오. 자세한 정보는 작업 4: Automation에 대한 사용자 액세스 구성하기 단원을 참조하십시오.

  • 가능한 원인 2: 자동화 실행을 시작하려고 시도하는 IAM 사용자에게 StartAutomationExecution API를 호출할 수 있는 권한이 있지만, 특정 자동화 문서를 사용하여 API를 호출할 수 있는 권한은 없습니다. 이 문제를 해결하려면 실행을 시작하는 데 사용된 사용자 계정에 필요한 IAM 정책을 연결하십시오. 자세한 정보는 작업 4: Automation에 대한 사용자 액세스 구성하기 단원을 참조하십시오.

PassRole 권한이 없기 때문에 액세스 거부됨

오류 메시지: User: user arn is not authorized to perform: iam:PassRole on resource: automation assume role arn (Service: AWSSimpleSystemsManagement; Status Code: 400; Error Code: AccessDeniedException; Request ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)

자동화 실행을 시작하려고 시도하는 IAM 사용자에게 assume role에 대한 PassRole 권한이 없습니다. 이 문제를 해결하려면 자동화 실행을 시작하려고 시도하는 IAM 사용자의 역할에 iam:PassRole 정책을 연결하십시오. 자세한 정보는 작업 3: Automation 역할에 iam:PassRole 정책 연결하기 단원을 참조하십시오.

유효하지 않은 수임 역할

자동화를 실행할 때 assume 역할은 문서에 제공되거나 해당 문서에 대한 파라미터 값으로 전달됩니다. assume role이 지정되지 않거나 제대로 구성되지 않으면 다양한 유형의 오류가 발생할 수 있습니다.

형식이 잘못된 Assume Role

오류 메시지: The format of the supplied assume role ARN is invalid. assume role의 형식이 잘못 지정되었습니다. 이 문제를 해결하려면 유효한 수임 역할이 자동화 문서에 지정되어 있는지 또는 자동화 실행 시 런타임 파라미터로 지정되어 있는지 확인하십시오.

Assume Role이 수행될 수 없음

오류 메시지: The defined assume role is unable to be assumed. (Service: AWSSimpleSystemsManagement; Status Code: 400; Error Code: InvalidAutomationExecutionParametersException; Request ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)

실행이 시작되었지만 상태가 실패인 경우

작업별 오류

자동화 문서에는 단계가 포함되어 있으며 단계는 순서대로 실행됩니다. 각 단계는 하나 이상의 AWS 서비스 API를 호출합니다. API는 해당 단계의 입력, 동작 및 출력을 결정합니다. 단계 실패를 유발할 수 있는 오류는 여러 위치에서 발생합니다. 오류 메시지는 오류가 언제 어디에서 발생했는지 나타냅니다.

EC2 콘솔에서 오류 메시지를 보려면 실패한 단계의 출력 보기 링크를 선택합니다. AWS CLI에서 오류 메시지를 보려면 get-automation-execution을 호출하고 실패한 StepExecution에서 FailureMessage 속성을 찾습니다.

다음 예제에서는 aws:runInstance 작업과 연결된 단계가 실패했습니다. 각 예제에서는 다른 유형의 오류를 살펴봅니다.

이미지 누락

오류 메시지: Automation Step Execution fails when it is launching the instance(s). Get Exception from RunInstances API of ec2 Service. Exception Message from RunInstances API: [The image id '[ami id]' does not exist (Service: AmazonEC2; Status Code: 400; Error Code: InvalidAMIID.NotFound; Request ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)]. Please refer to Automation Service Troubleshooting Guide for more diagnosis details.

aws:runInstances 작업이 존재하지 않는 ImageId에 대한 입력을 받았습니다. 이 문제를 해결하려면 자동화 문서 또는 파라미터 값을 정확한 AMI ID로 업데이트하십시오.

Assume Role 정책에 충분한 권한이 없음

오류 메시지: Automation Step Execution fails when it is launching the instance(s). Get Exception from RunInstances API of ec2 Service. Exception Message from RunInstances API: [You are not authorized to perform this operation. Encoded authorization failure message: xxxxxxx (Service: AmazonEC2; Status Code: 403; Error Code: UnauthorizedOperation; Request ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)]. Please refer to Automation Service Troubleshooting Guide for more diagnosis details.

assume role에 EC2 인스턴스에서 RunInstances API를 호출할 수 있는 충분한 권한이 없습니다. 이 문제를 해결하려면 RunInstances API를 호출할 수 있는 권한이 있는 수임 역할에 IAM 정책을 연결하십시오. 자세한 정보는 방법 2: IAM을 사용하여 Automation을 위한 역할 구성 단원을 참조하십시오.

예기치 않은 상태

오류 메시지: Step fails when it is verifying launched instance(s) are ready to be used. Instance i-xxxxxxxxx entered unexpected state: shutting-down. Please refer to Automation Service Troubleshooting Guide for more diagnosis details.

  • 가능한 원인 1: 인스턴스 또는 Amazon EC2 서비스에 문제가 있습니다. 이 문제를 해결하려면 인스턴스에 로그인하거나 인스턴스 시스템 로그를 검토하여 인스턴스가 종료되기 시작한 이유를 이해하십시오.

  • 가능한 원인 2: aws:runInstances 작업에 지정된 사용자 데이터 스크립트에 문제가 있거나 구문이 부정확합니다. 사용자 데이터 스크립트의 구문을 확인하십시오. 또한 사용자 데이터 스크립트가 인스턴스를 종료시키지 않는지, 아니면 인스턴스를 종료시키는 다른 스크립트를 호출하지 않는지 확인하십시오.

작업 특정 오류 참조

단계가 실패하면 해당 오류 메시지가 오류 발생 시 호출 중이었던 서비스를 나타낼 수 있습니다. 다음 표에는 각 작업에 의해 호출된 서비스가 나와 있습니다. 또한 각 서비스에 대한 정보로 연결되는 링크도 제공합니다.

Action AWS 이 작업에 의해 호출된 서비스(들) 이 서비스에 대한 정보 콘텐츠 문제 해결

aws:runInstances

Amazon EC2

Amazon EC2 User Guide for Linux Instances

EC2 인스턴스 문제 해결

aws:changeInstanceState

Amazon EC2

Amazon EC2 User Guide for Linux Instances

EC2 인스턴스 문제 해결

aws:runCommand

Systems Manager

AWS Systems Manager Run Command

Systems Manager Run Command 문제 해결

aws:createImage

Amazon EC2

Amazon 머신 이미지

aws:createStack

AWS CloudFormation

AWS CloudFormation User Guide

AWS CloudFormation 문제 해결

aws:deleteStack

AWS CloudFormation

AWS CloudFormation User Guide

AWS CloudFormation 문제 해결

aws:deleteImage

Amazon EC2

Amazon 머신 이미지

aws:copyImage

Amazon EC2

Amazon 머신 이미지

aws:createTag

Amazon EC2, Systems Manager

EC2 리소스 및 태그

aws:invokeLambdaFunction

AWS Lambda

AWS Lambda Developer Guide

Lambda 문제 해결

Automation 서비스 내부 오류

오류 메시지: Internal Server Error. Please refer to Automation Service Troubleshooting Guide for more diagnosis details.

자동화 서비스 문제는 지정된 자동화 문서가 올바로 실행되지 못하게 합니다. 이 문제를 해결하려면 AWS Support에 연락하십시오. 가능할 경우 실행 ID와 고객 ID를 제공하십시오.

실행이 시작되었지만 시간 초과됨

오류 메시지: Step timed out while step is verifying launched instance(s) are ready to be used. Please refer to Automation Service Troubleshooting Guide for more diagnosis details.

aws:runInstances 작업의 단계가 시간 초과되었습니다. 이 오류는 단계 작업이 실행되는 시간이 해당 단계의 timeoutSeconds에 지정된 값보다 오래 걸리는 경우에 발생할 수 있습니다. 이 문제를 해결하려면 timeoutSeconds에 더 큰 값을 지정하십시오. 이렇게 해도 문제가 해결되지 않으면 단계가 실행되는 시간이 예상보다 오래 걸리는 이유를 조사하십시오.