기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 세부 배포 오류 코드
이 섹션의 오류 코드와 해결 방법을 사용하여 Greengrass nucleus 버전 2.8.0 이상을 사용하는 경우 구성 요소 배포 관련 문제를 해결합니다.
Greengrass nucleus는 가장 구체적이지 않은 코드부터 가장 구체적인 코드까지 계층 구조로 배포 오류를 보고합니다. 이 계층 구조를 사용하면 배포 오류의 원인을 정확히 파악할 수 있습니다. 예를 들어 다음 오류 계층 구조가 있을 수 있습니다.
+ DEPLOYMENT\$1FAILURE
+ ARTIFACT\$1DOWNLOAD\$1ERROR
+ IO\$1ERROR
+ DISK\$1SPACE\$1CRITICAL
오류 코드는 유형별로 정리되어 있습니다. 각 유형은 발생할 수 있는 오류 클래스를 나타냅니다.는 콘솔, API 및에서 이러한 오류 유형을 AWS IoT Greengrass 보고합니다 AWS CLI. 오류 계층 구조에 보고된 오류에 따라 두 가지 이상의 오류 유형이 있을 수 있습니다. 이전 예제에서 반환된 오류 유형은 `DEVICE_ERROR`입니다.
다음과 같은 유형이 있습니다.
+ **PERMISSION\$1ERROR** – 권한이 필요한 작업에 대한 액세스가 거부되었습니다.
+ **REQUEST\$1ERROR** – 배포 문서의 문제로 인해 오류가 발생했습니다.
+ **COMPONENT\$1RECIPE\$1ERROR** – 구성 요소 레시피의 문제로 인해 오류가 발생했습니다.
+ **AWS\$1COMPONENT\$1ERROR** - AWS 제공된 구성 요소를 시작하거나 제거할 때 오류가 발생했습니다.
+ **USER\$1COMPONENT\$1ERROR** – 사용자 구성 요소를 시작하거나 제거할 때 오류가 발생했습니다.
+ **COMPONENT\$1ERROR** - 구성 요소를 시작하거나 제거할 때 오류가 발생했지만 Greengrass nucleus에서 해당 구성 요소가 AWS 에서 제공한 구성 요소인지 사용자 구성 요소인지 확인할 수 없습니다.
+ **DEVICE\$1ERROR** – 로컬 I/O에 오류가 발생했거나 다른 디바이스 오류가 발생했습니다.
+ **DEPENDENCY\$1ERROR** – 배포가 Amazon S3에서 아티팩트를 다운로드하지 못했거나 ECR 레지스트리에서 이미지를 가져오지 못했습니다.
+ **HTTP\$1ERROR** – HTTP 요청에서 오류가 발생했습니다.
+ **NETWORK\$1ERROR** – 디바이스 네트워크에 오류가 발생했습니다.
+ **NUCLEUS\$1ERROR** – Greengrass nucleus가 구성 요소 또는 활성 nucleus 버전을 찾을 수 없습니다.
+ **SERVER\$1ERROR** – 서버가 요청에 대한 응답으로 500 오류를 반환했습니다.
+ **CLOUD\$1SERVICE\$1ERROR** – AWS IoT Greengrass 클라우드 서비스에서 오류가 발생했습니다.
+ **UNKNOWN\$1ERROR** - 구성 요소에 의해 확인되지 않은 예외가 발생했습니다.
이 섹션의 많은 오류는 AWS IoT Greengrass 코어 로그에 추가 정보를 보고합니다. 이러한 로그는 코어 디바이스의 로컬 파일 시스템에 저장됩니다. AWS IoT Greengrass 코어 코어 소프트웨어 및 각 개별 구성 요소에 대한 로그가 있습니다. 로그 액세스에 대한 자세한 내용은 [파일 시스템 로그 액세스](monitor-logs.md#access-local-logs) 섹션을 참조하세요.
## 권한 오류
ACCESS\$1DENIED
권한이 올바르게 설정되지 않았기 때문에 AWS 서비스 작업에서 403 오류를 반환할 때이 오류가 발생할 수 있습니다. 자세한 내용은 더 구체적인 오류 코드에서 확인하세요.
GET\$1DEPLOYMENT\$1CONFIGURATION\$1ACCESS\$1DENIED
AWS IoT 정책에서 `GetDeploymentConfiguration` 작업 호출 권한을 허용하지 않는 경우이 오류가 발생할 수 있습니다. 코어 디바이스의 정책에 `greengrass::GetDeploymentConfiguration` 권한을 추가합니다.
GET\$1COMPONENT\$1VERSION\$1ARTIFACT\$1ACCESS\$1DENIED
코어 디바이스 AWS IoT 정책에서 `greengrass:GetComponentVersionArtifact` 권한을 허용하지 않는 경우이 오류가 발생할 수 있습니다. 코어 디바이스의 정책에 권한을 추가합니다.
RESOLVE\$1COMPONENT\$1CANDIDATES\$1ACCESS\$1DENIED
코어 디바이스 AWS IoT 정책에서 `greengrass:ResolveComponentCandidates` 권한을 허용하지 않는 경우이 오류가 발생할 수 있습니다. 코어 디바이스의 정책에 권한을 추가합니다.
GET\$1ECR\$1CREDENTIAL\$1ERROR
배포가 ECR의 프라이빗 레지스트리로 인증할 수 없는 경우 이 오류가 발생할 수 있습니다. 로그에 특정 오류가 있는지 확인한 다음 배포를 다시 시도하세요.
USER\$1NOT\$1AUTHORIZED\$1FOR\$1DOCKER
Greengrass 사용자에게 Docker를 사용할 권한이 없는 경우 이 오류가 발생할 수 있습니다. Greengrass를 루트로 실행 중이거나 사용자가 `docker` 그룹에 추가되어 있는지 확인합니다. 그런 다음 배포를 다시 시도하세요.
S3\$1ACCESS\$1DENIED
Amazon S3 작업에서 403 오류를 반환하는 경우 이 오류가 발생할 수 있습니다. 자세한 내용은 추가 오류 코드 또는 로그를 확인하세요.
S3\$1HEAD\$1OBJECT\$1ACCESS\$1DENIED
디바이스의 토큰 교환 역할에서 구성 요소의 레시피에 지정한 S3 객체 URL에서 AWS IoT Greengrass 코어 소프트웨어가 구성 요소 아티팩트를 다운로드하도록 허용하지 않거나 구성 요소 아티팩트를 사용할 수 없는 경우 이 오류가 발생할 수 있습니다. 토큰 교환 역할이 아티팩트를 사용할 수 있는 S3 객체 URL에 대해 `s3:GetObject`를 허용하고 아티팩트가 있는지 확인하세요.
S3\$1GET\$1BUCKET\$1LOCATION\$1ACCESS\$1DENIED
디바이스의 토큰 교환 역할이 아티팩트를 사용할 수 있는 Amazon S3 버킷에 대한 `s3:GetBucketLocation` 권한을 허용하지 않는 경우 이 오류가 발생할 수 있습니다. 디바이스에서 권한을 허용하는지 확인한 다음 배포를 다시 시도하세요.
S3\$1GET\$1OBJECT\$1ACCESS\$1DENIED
디바이스의 토큰 교환 역할에서 구성 요소의 레시피에 지정한 S3 객체 URL에서 AWS IoT Greengrass 코어 소프트웨어가 구성 요소 아티팩트를 다운로드하도록 허용하지 않거나 구성 요소 아티팩트를 사용할 수 없는 경우 이 오류가 발생할 수 있습니다. 토큰 교환 역할이 아티팩트를 사용할 수 있는 S3 객체 URL에 대해 `s3:GetObject`를 허용하고 아티팩트가 있는지 확인하세요.
## 요청 오류
NUCLEUS\$1MISSING\$1REQUIRED\$1CAPABILITIES
배포의 nucleus 버전이 대규모 구성을 다운로드하거나 Linux 리소스 제한을 설정하는 등 요청된 작업을 수행할 수 없는 경우 이 오류가 발생할 수 있습니다. 작업을 지원하는 nucleus 버전으로 배포를 다시 시도하세요.
MULTIPLE\$1NUCLEUS\$1RESOLVED\$1ERROR
배포에서 여러 nucleus 구성 요소를 배포하려고 하는 경우 이 오류가 발생할 수 있습니다. 로그를 확인하여 오류의 원인을 확인한 다음 nucleus 소프트웨어 업데이트 페이지에서 이후 버전의 nucleus에서 문제가 해결되었는지 확인하거나 지원에 문의하세요.
COMPONENT\$1CIRCULAR\$1DEPENDENCY\$1ERROR
배포의 두 구성 요소가 서로 종속되어 있는 경우 이 오류가 발생할 수 있습니다. 배포의 구성 요소가 서로 의존하지 않도록 구성 요소 설정을 수정하세요.
UNAUTHORIZED\$1NUCLEUS\$1MINOR\$1VERSION\$1UPDATE
배포의 구성 요소에 nucleus 마이너 버전 업데이트가 필요하지만 해당 버전이 배포에서 지정되지 않은 경우 이 오류가 발생할 수 있습니다. 이는 다른 버전에 의존하는 구성 요소에 대한 마이너 버전을 실수로 업데이트하는 것을 줄이는 데 도움이 됩니다. 배포에 새 마이너 nucleus 버전을 포함하세요.
MISSING\$1DOCKER\$1APPLICATION\$1MANAGER
Docker 애플리케이션 관리자를 배포하지 않고 Docker 구성 요소를 배포하는 경우 이 오류가 발생할 수 있습니다. 배포에 Docker 애플리케이션 관리자가 포함되어 있는지 확인하세요.
MISSING\$1TOKEN\$1EXCHANGE\$1SERVICE
배포에서 토큰 교환 서비스를 배포하지 않고 프라이빗 ECR 레지스트리에서 Docker 이미지 아티팩트를 다운로드하려고 하는 경우 이 오류가 발생할 수 있습니다. 배포에 토큰 교환 서비스가 포함되어 있는지 확인하세요.
COMPONENT\$1VERSION\$1REQUIREMENTS\$1NOT\$1MET
버전 제약 조건이 충돌하거나 구성 요소 버전이 없는 경우 이 오류가 발생할 수 있습니다. 자세한 내용은 [Error: com.aws.greengrass.componentmanager.exceptions.NoAvailableComponentVersionException: Failed to negotiate component version with cloud and no local applicable version satisfying requirement ](troubleshooting.md#core-error-no-available-component-version) 단원을 참조하십시오.
THROTTLING\$1ERROR
AWS 서비스 작업이 속도 할당량을 초과하면이 오류가 발생할 수 있습니다. 배포를 다시 시도하십시오.
CONFLICTED\$1REQUEST
배포가 한 번에 두 개 이상의 작업을 수행하려고 하기 때문에 AWS 서비스 작업에서 409 오류를 반환할 때이 오류가 발생할 수 있습니다. 배포를 다시 시도하십시오.
RESOURCE\$1NOT\$1FOUND
리소스를 찾을 수 없어 AWS 서비스 작업에서 404 오류를 반환할 때이 오류가 발생할 수 있습니다. 로그에서 누락된 리소스가 있는지 확인하세요.
RUN\$1WITH\$1CONFIG\$1NOT\$1VALID
구성 요소를 실행하기 위해 지정한 `posixUser`, `posixGroup` 또는 `windowsUser` 정보가 유효하지 않은 경우 이 오류가 발생할 수 있습니다. 사용자가 유효한지 확인한 다음 배포를 다시 시도하세요.
UNSUPPORTED\$1REGION
배포를 위해 지정된 리전을 AWS IoT Greengrass에서 지원하지 않는 경우 이 오류가 발생할 수 있습니다. 리전을 확인하고 배포를 다시 시도하세요.
IOT\$1CRED\$1ENDPOINT\$1NOT\$1VALID
구성에 지정된 AWS IoT 자격 증명 엔드포인트가 유효하지 않은 경우이 오류가 발생할 수 있습니다. 엔드포인트를 확인하고 요청을 다시 시도하세요.
IOT\$1DATA\$1ENDPOINT\$1NOT\$1VALID
구성에 지정된 AWS IoT 데이터 엔드포인트가 유효하지 않은 경우이 오류가 발생할 수 있습니다. 엔드포인트를 확인하고 요청을 다시 시도하세요.
S3\$1HEAD\$1OBJECT\$1RESOURCE\$1NOT\$1FOUND
구성 요소의 레시피에 지정한 S3 객체 URL에서 구성 요소 아티팩트를 사용할 수 없는 경우 이 오류가 발생할 수 있습니다. 아티팩트를 S3 버킷에 업로드했고 아티팩트 URI가 버킷에 있는 아티팩트의 S3 객체 URL과 일치하는지 확인하세요.
S3\$1GET\$1BUCKET\$1LOCATION\$1RESOURCE\$1NOT\$1FOUND
Amazon S3 버킷을 찾을 수 없는 경우 이 오류가 발생할 수 있습니다. 버킷이 있는지 확인하고 배포를 다시 시도하세요.
S3\$1GET\$1OBJECT\$1RESOURCE\$1NOT\$1FOUND
구성 요소의 레시피에 지정한 S3 객체 URL에서 구성 요소 아티팩트를 사용할 수 없는 경우 이 오류가 발생할 수 있습니다. 아티팩트를 S3 버킷에 업로드했고 아티팩트 URI가 버킷에 있는 아티팩트의 S3 객체 URL과 일치하는지 확인하세요.
IO\$1MAPPING\$1ERROR
배포 문서 또는 레시피의 구문을 분석할 때 I/O 오류가 발생하는 경우 이 오류가 발생할 수 있습니다. 자세한 내용은 추가 오류 코드 또는 로그를 확인하세요.
## 구성 요소 레시피 오류
RECIPE\$1PARSE\$1ERROR
레시피 구조에 오류가 있어 배포 레시피의 구문을 분석할 수 없는 경우 이 오류가 발생할 수 있습니다. 레시피의 형식이 올바른지 확인하고 배포를 다시 시도하세요.
RECIPE\$1METADATA\$1PARSE\$1ERROR
클라우드에서 다운로드한 배포 레시피 메타데이터의 구문을 분석할 수 없는 경우 이 오류가 발생할 수 있습니다. 에 문의하세요 지원.
ARTIFACT\$1URI\$1NOT\$1VALID
레시피의 아티팩트 URI 형식이 올바르지 않으면 이 오류가 발생할 수 있습니다. 로그에서 유효하지 않은 URI를 확인하고 레시피에서 URI를 업데이트한 다음 배포를 다시 시도하세요.
S3\$1ARTIFACT\$1URI\$1NOT\$1VALID
레시피에 있는 아티팩트의 Amazon S3 URI가 유효하지 않은 경우 이 오류가 발생할 수 있습니다. 로그에서 유효하지 않은 URI를 확인하고 레시피에서 URI를 업데이트한 다음 배포를 다시 시도하세요.
DOCKER\$1ARTIFACT\$1URI\$1NOT\$1VALID
레시피에 있는 아티팩트의 Docker URI가 유효하지 않은 경우 이 오류가 발생할 수 있습니다. 로그에서 유효하지 않은 URI를 확인하고 레시피에서 URI를 업데이트한 다음 배포를 다시 시도하세요.
EMPTY\$1ARTIFACT\$1URI
아티팩트의 URI가 레시피에서 지정되지 않은 경우 이 오류가 발생할 수 있습니다. 로그에서 URI가 누락된 아티팩트를 확인하고 레시피에서 URI를 업데이트한 다음 배포를 다시 시도하세요.
EMPTY\$1ARTIFACT\$1SCHEME
아티팩트에 대한 URI 체계가 정의되지 않은 경우 이 오류가 발생할 수 있습니다. 로그에서 유효하지 않은 URI를 확인하고 레시피에서 URI를 업데이트한 다음 배포를 다시 시도하세요.
UNSUPPORTED\$1ARTIFACT\$1SCHEME
실행 중인 nucleus 버전에서 URI 체계를 지원하지 않는 경우 이 오류가 발생할 수 있습니다. URI가 유효하지 않거나 nucleus 버전을 업데이트해야 합니다. URI가 유효하지 않은 경우 로그에서 유효하지 않은 URI를 확인하고 레시피에서 URI를 업데이트한 다음 배포를 다시 시도하세요.
RECIPE\$1MISSING\$1MANIFEST
매니페스트 섹션이 레시피에 포함되어 있지 않은 경우 이 오류가 발생할 수 있습니다. 레시피에 매니페스트를 추가하고 배포를 다시 시도하세요.
RECIPE\$1MISSING\$1ARTIFACT\$1HASH\$1ALGORITHM
해시 알고리즘이 없는 레시피 내부에 로컬이 아닌 아티팩트가 지정되어 있는 경우 이 오류가 발생할 수 있습니다. 아티팩트에 알고리즘을 추가한 다음 요청을 다시 시도하세요.
ARTIFACT\$1CHECKSUM\$1MISMATCH
다운로드한 아티팩트의 다이제스트가 레시피에 지정되어 있는 것과 다른 경우 이 오류가 발생할 수 있습니다. 레시피에 올바른 다이제스트가 포함되어 있는지 확인한 다음 배포를 다시 시도하세요. 자세한 내용은 [Error: com.aws.greengrass.componentmanager.exceptions.ArtifactChecksumMismatchException: Integrity check for downloaded artifact failed. Probably due to file corruption.](troubleshooting.md#core-error-failed-to-download-artifact-checksum-mismatch-exception)을 참조하세요.
COMPONENT\$1DEPENDENCY\$1NOT\$1VALID
배포 레시피에 지정되어 있는 종속성 유형이 유효하지 않은 경우 이 오류가 발생할 수 있습니다. 레시피를 확인한 다음 요청을 다시 시도하세요.
CONFIG\$1INTERPOLATE\$1ERROR
레시피 변수를 보간하는 경우 이 오류가 발생할 수 있습니다. 자세한 내용은 로그를 확인하세요.
IO\$1MAPPING\$1ERROR
배포 문서 또는 레시피의 구문을 분석할 때 I/O 오류가 발생하는 경우 이 오류가 발생할 수 있습니다. 자세한 내용은 추가 오류 코드 또는 로그를 확인하세요.
## AWS 구성 요소 오류, 사용자 구성 요소 오류, 구성 요소 오류
구성 요소에 문제가 있는 경우 다음 오류 코드가 반환됩니다. 보고되는 실제 오류 유형은 오류가 발생하게 한 특정 구성 요소에 따라 다릅니다. Greengrass nucleus가 구성 요소를에서 제공한 구성 요소로 식별하면 AWS IoT Greengrass를 반환합니다`AWS_COMPONENT_ERROR`. 구성 요소가 사용자 구성 요소로 식별되면 Greengrass nucleus는 `USER_COMPONENT_ERROR`를 반환합니다. Greengrass nucleus에서 알지 못하는 경우 `COMPONENT_ERROR`를 반환합니다.
COMPONENT\$1UPDATE\$1ERROR
배포 중에 구성 요소가 업데이트되지 않는 경우 이 오류가 발생할 수 있습니다. 추가 오류 코드를 확인하거나 로그를 확인하여 오류의 원인을 확인하세요.
COMPONENT\$1BROKEN
배포 중에 구성 요소가 손상된 경우 이 오류가 발생할 수 있습니다. 구성 요소 로그에서 오류 세부 정보를 확인한 다음 배포를 다시 시도하세요.
REMOVE\$1COMPONENT\$1ERROR
배포 중에 nucleus가 구성 요소를 제거할 수 없는 경우 이 오류가 발생할 수 있습니다. 로그에서 오류 세부 정보를 확인한 다음 배포를 다시 시도하세요.
COMPONENT\$1BOOTSTRAP\$1TIMEOUT
구성 요소의 부트스트랩 태스크가 구성된 제한 시간보다 오래 걸리는 경우 이 오류가 발생할 수 있습니다. 제한 시간을 늘리거나 부트스트랩 태스크의 실행 시간을 줄인 다음 배포를 다시 시도하세요.
COMPONENT\$1BOOTSTRAP\$1ERROR
구성 요소의 부트스트랩 태스크에 오류가 있는 경우 이 오류가 발생할 수 있습니다. 로그에서 오류 세부 정보를 확인한 다음 배포를 다시 시도하세요.
COMPONENT\$1CONFIGURATION\$1NOT\$1VALID
Nucleus가 구성 요소에 대해 배포된 구성을 검증할 수 없는 경우 이 오류가 발생할 수 있습니다. 로그에서 오류 세부 정보를 확인한 다음 배포를 다시 시도하세요.
## 디바이스 오류
IO\$1WRITE\$1ERROR
파일에 쓸 때 이 오류가 발생할 수 있습니다. 자세한 내용은 로그를 확인하세요.
IO\$1READ\$1ERROR
파일에서 읽을 때 이 오류가 발생할 수 있습니다. 자세한 내용은 로그를 확인하세요.
DISK\$1SPACE\$1CRITICAL
배포 요청을 완료할 디스크 공간이 충분하지 않은 경우 이 오류가 발생할 수 있습니다. 사용 가능한 공간이 20MB 이상이거나 더 큰 아티팩트를 보관하기에 충분해야 합니다. 디스크 공간을 확보한 다음 배포를 다시 시도하세요.
IO\$1FILE\$1ATTRIBUTE\$1ERROR
파일 시스템에서 기존 파일 크기를 검색할 수 없는 경우 이 오류가 발생할 수 있습니다. 자세한 내용은 로그를 확인하세요.
SET\$1PERMISSION\$1ERROR
다운로드한 아티팩트 또는 아티팩트 디렉터리에 권한을 설정할 수 없는 경우 이 오류가 발생할 수 있습니다. 자세한 내용은 로그를 확인하세요.
IO\$1UNZIP\$1ERROR
아티팩트의 압축을 해제할 수 없는 경우 이 오류가 발생할 수 있습니다. 자세한 내용은 로그를 확인하세요.
LOCAL\$1RECIPE\$1NOT\$1FOUND
레시피 파일의 로컬 복사본을 찾을 수 없는 경우 이 오류가 발생할 수 있습니다. 배포를 다시 시도하세요.
LOCAL\$1RECIPE\$1CORRUPTED
레시피 다운로드 이후 로컬 복사본이 변경된 경우 이 오류가 발생할 수 있습니다. 레시피의 기존 복사본을 삭제하고 배포를 다시 시도하세요.
LOCAL\$1RECIPE\$1METADATA\$1NOT\$1FOUND
레시피 메타데이터 파일의 로컬 복사본을 찾을 수 없는 경우 이 오류가 발생할 수 있습니다. 배포를 다시 시도하세요.
LAUNCH\$1DIRECTORY\$1CORRUPTED
Greengrass nucleus(`/greengrass/v2/alts/current`)를 시작하는 데 사용된 디렉터리가 마지막으로 nucleus가 시작된 이후 수정되는 경우 이 오류가 발생할 수 있습니다. Nucleus를 다시 시작한 다음 배포를 다시 시도하세요.
HASHING\$1ALGORITHM\$1UNAVAILABLE
디바이스의 Java 배포에서 필수 해싱 알고리즘을 지원하지 않거나 구성 요소 레시피에 지정된 해시 알고리즘이 유효하지 않은 경우 이 오류가 발생할 수 있습니다.
DEVICE\$1CONFIG\$1NOT\$1VALID\$1FOR\$1ARTIFACT\$1DOWNLOAD
디바이스 구성에 오류가 있어 배포가 Amazon S3 또는 Greengrass 클라우드에서 아티팩트를 다운로드할 수 없는 경우 이 오류가 발생할 수 있습니다. 로그에서 특정 구성 오류를 확인한 다음 배포를 다시 시도하세요.
## 종속성 오류
DOCKER\$1ERROR
Docker 이미지를 풀링할 때 이 오류가 발생할 수 있습니다. 자세한 내용은 추가 오류 코드 또는 로그를 확인하세요.
DOCKER\$1SERVICE\$1UNAVAILABLE
Greengrass가 Docker 레지스트리에 로그인할 수 없는 경우 이 오류가 발생할 수 있습니다. 로그에 특정 오류가 있는지 확인한 다음 배포를 다시 시도하세요.
DOCKER\$1LOGIN\$1ERROR
Docker에 로그인할 때 예기치 않은 오류가 발생하는 경우 이 오류가 발생할 수 있습니다. 로그에 특정 오류가 있는지 확인한 다음 배포를 다시 시도하세요.
DOCKER\$1PULL\$1ERROR
레지스트리에서 Docker 이미지를 풀링할 때 예기치 않은 오류가 발생하는 경우 이 오류가 발생할 수 있습니다. 로그에 특정 오류가 있는지 확인한 다음 배포를 다시 시도하세요.
DOCKER\$1IMAGE\$1NOT\$1VALID
요청된 Docker 이미지가 없는 경우 이 오류가 발생할 수 있습니다. 로그에서 특정 오류를 확인하고 배포를 다시 시도하세요.
DOCKER\$1IMAGE\$1QUERY\$1ERROR
Docker에서 사용 가능한 이미지를 쿼리하는 동안 예기치 않은 오류가 발생하는 경우 이 오류가 발생할 수 있습니다. 로그에서 특정 오류를 확인하고 배포를 다시 시도하세요.
S3\$1ERROR
Amazon S3 아티팩트를 다운로드하는 경우 이 오류가 발생할 수 있습니다. 자세한 내용은 추가 오류 코드 또는 로그를 확인하세요.
S3\$1RESOURCE\$1NOT\$1FOUND
Amazon S3 작업에서 404 오류를 반환하는 경우 이 오류가 발생할 수 있습니다. 자세한 내용은 추가 오류 코드 또는 로그를 확인하세요.
S3\$1BAD\$1REQUEST
Amazon S3 작업에서 400 오류를 반환하는 경우 이 오류가 발생할 수 있습니다. 특정 오류에 대한 로그를 확인하고 요청을 다시 시도하세요.
## HTTP 오류
HTTP\$1REQUEST\$1ERROR
HTTP 요청을 하는 동안 오류가 발생하는 경우 이 오류가 발생할 수 있습니다. 로그에서 특정 오류를 확인하세요.
DOWNLOAD\$1DEPLOYMENT\$1DOCUMENT\$1ERROR
배포 문서를 다운로드할 때 HTTP 오류가 발생하는 경우 이 오류가 발생할 수 있습니다. 로그에서 특정 HTTP 오류를 확인하세요.
GET\$1GREENGRASS\$1ARTIFACT\$1SIZE\$1ERROR
퍼블릭 구성 요소 아티팩트의 크기를 가져올 때 HTTP 오류가 발생하는 경우 이 오류가 발생할 수 있습니다. 로그에서 특정 HTTP 오류를 확인하세요.
DOWNLOAD\$1GREENGRASS\$1ARTIFACT\$1ERROR
퍼블릭 구성 요소 아티팩트를 다운로드할 때 HTTP 오류가 발생하는 경우 이 오류가 발생할 수 있습니다. 로그에서 특정 HTTP 오류를 확인하세요.
## 네트워크 오류
NETWORK\$1ERROR
배포 중에 연결 문제가 있는 경우 이 오류가 발생할 수 있습니다. 디바이스가 인터넷에 연결되어 있는지 확인하고 배포를 다시 시도하세요.
## Nucleus 오류
BAD\$1REQUEST
AWS 클라우드 작업이 400 오류를 반환하면이 오류가 발생할 수 있습니다. 로그를 확인하여 오류를 일으킨 API를 확인한 다음 nucleus 소프트웨어 업데이트 페이지를 확인하여 이후 버전의 nucleus에서 문제가 수정되었는지 확인하거나에 문의하세요 지원.
NUCLEUS\$1VERSION\$1NOT\$1FOUND
코어 디바이스가 활성 nucleus의 버전을 찾을 수 없는 경우 이 오류가 발생할 수 있습니다. 로그를 확인하여 오류의 원인을 확인한 다음 nucleus 소프트웨어 업데이트 페이지에서 이후 버전의 nucleus에서 문제가 해결되었는지 확인하거나 지원에 문의하세요.
NUCLEUS\$1RESTART\$1FAILURE
Nucleus를 다시 시작해야 하는 배포 중에 nucleus가 다시 시작되지 않는 경우 이 오류가 발생할 수 있습니다. 로더 로그를 확인하여 오류의 원인을 확인한 다음 nucleus 소프트웨어 업데이트 페이지에서 이후 버전의 nucleus에서 문제가 해결되었는지 확인하거나 지원에 문의하세요.
INSTALLED\$1COMPONENT\$1NOT\$1FOUND
Nucleus가 설치된 구성 요소를 찾을 수 없는 경우 이 오류가 발생할 수 있습니다. 로그를 확인하여 오류의 원인을 확인한 다음 nucleus 소프트웨어 업데이트 페이지에서 이후 버전의 nucleus에서 문제가 해결되었는지 확인하거나 지원에 문의하세요.
DEPLOYMENT\$1DOCUMENT\$1NOT\$1VALID
디바이스가 유효하지 않은 배포 문서를 수신하는 경우 이 오류가 발생할 수 있습니다. 추가 오류 코드를 확인하거나 로그를 확인하여 오류의 원인을 확인하세요.
EMPTY\$1DEPLOYMENT\$1REQUEST
디바이스에서 빈 배포 요청을 수신하는 경우 이 오류가 발생할 수 있습니다. 로그를 확인하여 오류의 원인을 확인한 다음 nucleus 소프트웨어 업데이트 페이지에서 이후 버전의 nucleus에서 문제가 해결되었는지 확인하거나 지원에 문의하세요.
DEPLOYMENT\$1DOCUMENT\$1PARSE\$1ERROR
배포 요청 형식이 예상 형식과 일치하지 않는 경우 이 오류가 발생할 수 있습니다. 로그를 확인하여 오류의 원인을 확인한 다음 nucleus 소프트웨어 업데이트 페이지에서 이후 버전의 nucleus에서 문제가 해결되었는지 확인하거나 지원에 문의하세요.
COMPONENT\$1METADATA\$1NOT\$1VALID\$1IN\$1DEPLOYMENT
배포 요청에 유효하지 않은 구성 요소 메타데이터가 포함되어 있는 경우 이 오류가 발생할 수 있습니다. 로그를 확인하여 오류의 원인을 확인한 다음 nucleus 소프트웨어 업데이트 페이지에서 이후 버전의 nucleus에서 문제가 해결되었는지 확인하거나 지원에 문의하세요.
LAUNCH\$1DIRECTORY\$1CORRUPTED
Greengrass 디바이스를 한 그룹에서 다른 그룹으로 이동한 다음 Greengrass를 다시 시작해야 하는 배포를 사용하여 원래 그룹으로 다시 돌아오는 경우 이 오류가 발생할 수 있습니다. 오류를 해결하려면 디바이스에서 Greengrass의 시작 디렉터리를 다시 생성하세요.
자세한 내용은 [Error: com.aws.greengrass.deployment.exceptions.DeploymentException: Unable to process deployment. Greengrass launch directory is not set up or Greengrass is not set up as a system service](troubleshooting.md#deployment-error-unable-to-process-deployment) 단원을 참조하십시오.
## 서버 오류
SERVER\$1ERROR
서비스가 현재 요청을 처리할 수 없기 때문에 AWS 서비스 작업에서 500 오류를 반환할 때이 오류가 발생할 수 있습니다. 나중에 배포를 다시 시도하세요.
S3\$1SERVER\$1ERROR
Amazon S3 작업에서 500 오류를 반환하는 경우 이 오류가 발생할 수 있습니다. 자세한 내용은 추가 오류 코드 또는 로그를 확인하세요.
## 클라우드 서비스 오류
RESOLVE\$1COMPONENT\$1CANDIDATES\$1BAD\$1RESPONSE
Greengrass 클라우드 서비스가 `ResolveComponentCandidates` 작업에 호환되지 않는 응답을 보내는 경우 이 오류가 발생할 수 있습니다. 로그를 확인하여 오류의 원인을 확인한 다음 nucleus 소프트웨어 업데이트 페이지에서 이후 버전의 nucleus에서 문제가 해결되었는지 확인하거나 지원에 문의하세요.
DEPLOYMENT\$1DOCUMENT\$1SIZE\$1EXCEEDED
요청된 배포 문서가 최대 크기 할당량을 초과한 경우 이 오류가 발생할 수 있습니다. 배포 문서의 크기를 줄이고 배포를 다시 시도하세요.
GREENGRASS\$1ARTIFACT\$1SIZE\$1NOT\$1FOUND
Greengrass가 퍼블릭 구성 요소 아티팩트의 크기를 가져올 수 없는 경우 이 오류가 발생할 수 있습니다. 로그를 확인하여 오류의 원인을 확인한 다음 nucleus 소프트웨어 업데이트 페이지에서 이후 버전의 nucleus에서 문제가 해결되었는지 확인하거나 지원에 문의하세요.
DEPLOYMENT\$1DOCUMENT\$1NOT\$1VALID
디바이스가 유효하지 않은 배포 문서를 수신하는 경우 이 오류가 발생할 수 있습니다. 추가 오류 코드를 확인하거나 로그를 확인하여 오류의 원인을 확인하세요.
EMPTY\$1DEPLOYMENT\$1REQUEST
디바이스에서 빈 배포 요청을 수신하는 경우 이 오류가 발생할 수 있습니다. 로그를 확인하여 오류의 원인을 확인한 다음 nucleus 소프트웨어 업데이트 페이지에서 이후 버전의 nucleus에서 문제가 해결되었는지 확인하거나 지원에 문의하세요.
DEPLOYMENT\$1DOCUMENT\$1PARSE\$1ERROR
배포 요청 형식이 예상 형식과 일치하지 않는 경우 이 오류가 발생할 수 있습니다. 로그를 확인하여 오류의 원인을 확인한 다음 nucleus 소프트웨어 업데이트 페이지에서 이후 버전의 nucleus에서 문제가 해결되었는지 확인하거나 지원에 문의하세요.
COMPONENT\$1METADATA\$1NOT\$1VALID\$1IN\$1DEPLOYMENT
배포 요청에 유효하지 않은 구성 요소 메타데이터가 포함되어 있는 경우 이 오류가 발생할 수 있습니다. 로그를 확인하여 오류의 원인을 확인한 다음 nucleus 소프트웨어 업데이트 페이지에서 이후 버전의 nucleus에서 문제가 해결되었는지 확인하거나 지원에 문의하세요.
## 일반 오류
이러한 일반 오류에는 연결된 오류 유형이 없습니다.
DEPLOYMENT\$1INTERRUPTED
nucleus 종료 또는 기타 외부 이벤트로 인해 배포를 완료할 수 없는 경우 이 오류가 발생할 수 있습니다. 자세한 내용은 추가 오류 코드 또는 로그를 확인하세요.
ARTIFACT\$1DOWNLOAD\$1ERROR
아티팩트를 다운로드하는 데 문제가 있는 경우 이 오류가 발생할 수 있습니다. 자세한 내용은 추가 오류 코드 또는 로그를 확인하세요.
NO\$1AVAILABLE\$1COMPONENT\$1VERSION
구성 요소 버전이 클라우드 또는 로컬에 없거나 종속성 해결 충돌이 있는 경우 이 오류가 발생할 수 있습니다. 자세한 내용은 추가 오류 코드 또는 로그를 확인하세요.
COMPONENT\$1PACKAGE\$1LOADING\$1ERROR
다운로드한 아티팩트를 처리하는 동안 오류가 발생하는 경우 이 오류가 발생할 수 있습니다. 자세한 내용은 추가 오류 코드 또는 로그를 확인하세요.
CLOUD\$1API\$1ERROR
AWS 서비스 API를 호출하는 동안 오류가 발생하면이 오류가 발생할 수 있습니다. 자세한 내용은 추가 오류 코드 또는 로그를 확인하세요.
IO\$1ERROR
배포 중에 I/O 오류가 발생하는 경우 이 오류가 발생할 수 있습니다. 자세한 내용은 추가 오류 코드 또는 로그를 확인하세요.
COMPONENT\$1UPDATE\$1ERROR
배포 중에 구성 요소가 업데이트되지 않는 경우 이 오류가 발생할 수 있습니다. 추가 오류 코드를 확인하거나 로그를 확인하여 오류의 원인을 확인하세요.
## 알 수 없는 오류
DEPLOYMENT\$1FAILURE
확인되지 않은 예외가 발생하여 배포에 실패하는 경우 이 오류가 발생할 수 있습니다. 로그를 확인하여 오류의 원인을 확인한 다음 nucleus 소프트웨어 업데이트 페이지에서 이후 버전의 nucleus에서 문제가 해결되었는지 확인하거나 지원에 문의하세요.
DEPLOYMENT\$1TYPE\$1NOT\$1VALID
배포 유형이 유효하지 않은 경우 이 오류가 발생할 수 있습니다. 로그를 확인하여 오류의 원인을 확인한 다음 nucleus 소프트웨어 업데이트 페이지에서 이후 버전의 nucleus에서 문제가 해결되었는지 확인하거나 지원에 문의하세요.