• AWS Systems Manager CloudWatch 대시보드는 2026년 4월 30일 이후에는 더 이상 사용할 수 없습니다. 고객은 Amazon CloudWatch 콘솔을 계속 사용하여 현재와 마찬가지로 Amazon CloudWatch 대시보드를 보고, 생성하고, 관리할 수 있습니다. 자세한 내용은 [Amazon CloudWatch 대시보드 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)를 참조하세요.

# AWS Systems Manager Distributor 문제 해결
Distributor 문제 해결

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

**Topics**
+ [

## 이름이 같은 잘못된 패키지가 설치됨
](#distributor-tshoot-1)
+ [

## 오류: 매니페스트를 조회하지 못함: 패키지의 최신 버전을 찾을 수 없음
](#distributor-tshoot-2)
+ [

## 오류: 매니페스트를 검색하는 데 실패함: 검증 예외
](#distributor-tshoot-3)
+ [

## 패키지가 지원되지 않음(패키지에 설치 작업이 없음)
](#distributor-tshoot-4)
+ [

## 오류: 매니페스트를 다운로드하지 못했습니다. 이름이 있는 문서가 존재하지 않습니다.
](#distributor-tshoot-5)
+ [

## 업로드에 실패했습니다.
](#distributor-tshoot-6)
+ [

## 오류: 플랫폼을 찾지 못함: 플랫폼에 대한 매니페스트를 찾을 수 없음: oracle, 버전 8.9, 아키텍처 x86\$164
](#distributor-tshoot-7)

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


**문제:** 패키지를 설치했으나 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 업데이트](run-command-tutorial-update-software.md#rc-console-agentexample) 또는 [연습: AWS CLI를 사용하여 SSM Agent를 자동으로 업데이트](state-manager-update-ssm-agent-cli.md) 섹션을 참조하세요.

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


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

```
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 업데이트](run-command-tutorial-update-software.md#rc-console-agentexample) 또는 [연습: AWS CLI를 사용하여 SSM Agent를 자동으로 업데이트](state-manager-update-ssm-agent-cli.md) 섹션을 참조하세요.

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


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

```
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 통신](ssm-agent-technical-details.md#ssm-agent-minimum-s3-permissions)에서 설명하는 것과 같이 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` 업로드에 실패할 수 있습니다.

## 오류: 플랫폼을 찾지 못함: 플랫폼에 대한 매니페스트를 찾을 수 없음: oracle, 버전 8.9, 아키텍처 x86\$164


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

```
Failed to find platform: no manifest found for platform: oracle, version 8.9, architecture x86_64
```

**원인:** 오류는 JSON 패키지 매니페스트에 해당 플랫폼,이 경우 Oracle Linux에 대한 정의가 없음을 의미합니다.

**해결책:** [Trend Micro Deep Security Software](https://help.deepsecurity.trendmicro.com/software.html) 사이트에서 배포하려는 패키지를 다운로드합니다. [단순 워크플로를 사용한 패키지 생성](distributor-working-with-packages-create.md#distributor-working-with-packages-create-simple)을 사용하여 `.rpm` 소프트웨어 패키지를 생성합니다. 패키지에 대해 다음 값을 설정하고 Distributor를 사용하여 소프트웨어 패키지 업로드를 완료합니다.

```
Platform version: _any
Target platform: oracle
Architecture: x86_64
```