AWS Systems ManagerDistributor 문제 해결

다음 정보는 AWS Systems Manager의 도구인 Distributor 사용 시 발생할 수 있는 문제를 해결하는 데 유용합니다.

이름이 같은 잘못된 패키지가 설치됨

문제: 패키지를 설치했으나 Distributor가 대신 다른 패키지를 설치했습니다.

원인: 설치 중 Systems Manager에서 사용자 정의 외부 패키지보다 앞서 AWS 게시 패키지를 결과로 찾았습니다. 사용자 정의 패키지 이름이 AWS 게시 패키지 이름과 동일한 경우 사용자 패키지 대신 AWS 패키지가 설치됩니다.

해결 방법: 이 문제를 피하려면 패키지의 이름을 AWS 게시 패키지의 이름과 다르게 지정해야 합니다.

오류: 매니페스트를 조회하지 못함: 패키지의 최신 버전을 찾을 수 없음

문제: 다음과 같은 오류가 표시됩니다.

Failed to retrieve manifest: ResourceNotFoundException: Could not find the latest version of package 
arn:aws:ssm:::package/package-name status code: 400, request id: guid

원인: Distributor에서 2.3.274.0 버전 이전의 SSM Agent를 사용합니다.

솔루션: SSM Agent 버전을 2.3.274.0 버전 이상으로 업데이트하십시오. 자세한 내용은 Run Command를 사용하여 SSM Agent 업데이트 또는 연습: AWS CLI를 사용하여 SSM Agent를 자동으로 업데이트 섹션을 참조하세요.

오류: 매니페스트를 검색하는 데 실패함: 검증 예외

문제: 다음과 같은 오류가 표시됩니다.

Failed to retrieve manifest: ValidationException: 1 validation error detected: Value 'documentArn'
at 'packageName' failed to satisfy constraint: Member must satisfy regular expression pattern:
arn:aws:ssm:region-id:account-id:package/package-name

원인: Distributor에서 2.3.274.0 버전 이전의 SSM Agent를 사용합니다.

솔루션: SSM Agent 버전을 2.3.274.0 버전 이상으로 업데이트하십시오. 자세한 내용은 Run Command를 사용하여 SSM Agent 업데이트 또는 연습: AWS CLI를 사용하여 SSM Agent를 자동으로 업데이트 섹션을 참조하세요.

패키지가 지원되지 않음(패키지에 설치 작업이 없음)

문제: 다음과 같은 오류가 표시됩니다.

Package is not supported (package is missing install action)

원인: 패키지 디렉터리 구조가 올바르지 않습니다.

해결 방법: 소프트웨어 및 필수 스크립트가 포함된 상위 디렉터리를 압축하지 않습니다. 대신 절대 경로에 직접 필요한 모든 콘텐츠의 .zip 파일을 생성합니다. .zip 파일이 제대로 생성되었는지 확인하려면 대상 플랫폼 디렉터리의 압축을 풀고 디렉터리 구조를 검토합니다. 예를 들어 설치 스크립트 절대 경로는 /ExamplePackage_targetPlatform/install.sh여야 합니다.

오류: 매니페스트를 다운로드하지 못했습니다. 이름이 있는 문서가 존재하지 않습니다.

문제: 다음과 같은 오류가 표시됩니다.

Failed to download manifest - failed to retrieve package document description: InvalidDocument: Document with name filename does not exist.

원인 1: 다른 계정에서 Distributor 패키지를 공유할 때 Distributor가 패키지 이름으로 패키지를 찾을 수 없습니다.

솔루션 1: 다른 계정에서 패키지를 공유할 때 패키지 이름뿐만 아니라 패키지의 전체 Amazon 리소스 이름(ARN)도 사용합니다.

원인 2: VPC를 사용할 때 대상인 AWS 리전에 대한 AWS-ConfigureAWSPackage 문서가 포함된 AWS 관리형 S3 버킷 액세스 권한을 IAM 인스턴스 프로파일에 제공하지 않았습니다.

솔루션 2: AWS 관리형 S3 버킷과 SSM Agent 통신에서 설명하는 것과 같이 IAM 인스턴스 프로파일이 SSM Agent에 대상인 AWS 리전에 대한 AWS-ConfigureAWSPackage 문서가 포함된 AWS 관리형 S3 버킷 액세스 권한을 제공하는지 확인합니다.

업로드에 실패했습니다.

문제: 다음과 같은 오류가 표시됩니다.

Upload failed. At least one of your files was not successfully uploaded to your S3 bucket.

원인: 소프트웨어 패키지 이름에 공백이 있습니다. 예를 들어, Hello World.msi 업로드에 실패할 수 있습니다.