Azure IoT Orchestrator 미리 보기 배포 문제 해결

Important

Azure IoT 작업 미리 보기 - Azure Arc에서 지원되는 Azure IoT 작업은 현재 미리 보기로 제공됩니다. 프로덕션 환경에서는 이 미리 보기 소프트웨어를 사용하면 안 됩니다.

베타, 미리 보기로 제공되거나 아직 일반 공급으로 릴리스되지 않은 Azure 기능에 적용되는 약관은 Microsoft Azure 미리 보기에 대한 추가 사용 약관을 참조하세요.

배포 문제를 해결해야 하는 경우 Azure Portal에서 오류 세부 정보를 찾아 실패하거나 성공한 리소스와 그 이유를 파악할 수 있습니다.

1. Azure Portal에서 Arc 사용 클러스터를 포함하는 리소스 그룹으로 이동합니다.

2. 탐색 메뉴의 설정 아래에서 배포를 선택합니다.

3. 배포가 실패한 경우 오류 세부 정보를 선택하여 배포의 각 개별 리소스에 대한 자세한 정보를 가져옵니다.

   

오류 코드 확인

다음 섹션에서는 수신할 수 있는 특정 오류 코드와 이를 해결하는 단계에 대한 세부 정보를 제공합니다.

공급자 오류 코드

오류 코드	설명	해결 단계
잘못된 구성	잘못된 구성입니다.	공급자 구성 요소의 구성 속성을 업데이트하세요.
초기화 실패	공급자를 초기화하지 못했습니다.	공급자 속성이 올바르게 설정되었는지 확인하세요. 공급자의 이름, 구성 형식, 구성 데이터, 컨텍스트 및 inCluster 속성이 올바르게 설정되었는지 확인하세요.
찾을 수 없음	구성 요소 또는 개체를 찾을 수 없음	참조하는 구성 요소의 이름이 올바르게 지정되었는지 확인하세요.
업데이트 실패	구성 요소를 업데이트하지 못했습니다.	이 오류의 문제 해결 단계는 공급자에 따라 달라집니다. 다음 섹션에서 특정 공급자 오류 코드를 확인하세요.
삭제 실패	구성 요소를 삭제하지 못했습니다.	이 오류의 문제 해결 단계는 공급자에 따라 달라집니다. 다음 섹션에서 특정 공급자 오류 코드를 확인하세요.

Helm 공급자 오류 코드

오류 코드	설명	해결 단계
Helm 작업 실패	공급자가 Helm 클라이언트를 만들지 못했습니다.	설정에서 Helm 버전을 확인하세요. 사용 중인 Helm 차트가 유효하고 실행 중인 Helm 버전과 호환되는지 확인하세요. helm repo add 명령을 사용하여 리포지토리에 액세스할 수 있고 helm에 올바르게 추가되었는지 확인하세요. helm repo update 명령을 사용하여 사용 가능한 차트에 대한 최신 정보를 사용하도록 Helm 리포지토리를 업데이트하세요.
유효성 검사 실패	Helm 구성 요소에 대한 규칙의 유효성을 검사하지 못했습니다.	필요한 구성 요소 유형, 속성 및 메타데이터를 설정하세요.
작업 구성 만들기 실패	작업 구성을 초기화하지 못했습니다.	설정에서 Helm 버전을 확인하세요. 사용 중인 Helm 차트가 유효하고 실행 중인 Helm 버전과 호환되는지 확인하세요. helm repo add 명령을 사용하여 리포지토리에 액세스할 수 있고 helm에 올바르게 추가되었는지 확인하세요. helm repo update 명령을 사용하여 사용 가능한 차트에 대한 최신 정보를 사용하도록 Helm 리포지토리를 업데이트하세요.
Helm 속성 가져오기 실패	구성 요소에서 Helm 속성을 가져오지 못했습니다.	Helm 버전을 확인하고 버전이 설정과 일치하는지 확인하세요. 제공한 릴리스 이름이 검사하려는 릴리스와 일치하는지 확인하세요. 릴리스가 특정 구성 요소에 배포된 경우 helm get values <RELEASE_NAME> --namespace <NAMESPACE> 명령을 사용하여 네임스페이스 속성을 해당 구성 요소에 전달하세요.
Helm 차트 끌어오기 실패	Helm 클라이언트가 리포지토리에서 Helm 차트를 가져오지 못했습니다.	Helm 차트 리포지토리의 URL이 올바른지 확인하세요. 네트워크 연결을 확인하세요. helm repo update 명령을 사용하여 Helm 리포지토리를 업데이트하세요. 끌어오려는 Helm 차트가 리포지토리에 있는지 확인하세요. Helm 버전을 확인하세요.
Helm 차트 로드 실패	Helm 클라이언트가 Helm 차트를 로드하지 못했습니다.	helm search repo <CHART_NAME> 명령을 사용하여 로드하려는 Helm 차트를 사용할 수 있는지 확인하세요. helm repo update 명령을 사용하여 최신 차트를 사용하도록 Helm 리포지토리를 업데이트하세요. 올바른 차트 이름을 사용하고 있는지 확인하세요. 차트 이름은 대/소문자를 구분합니다. 원하는 차트 버전을 지정하여 비호환성 문제를 방지하세요.
Helm 차트 적용 실패	Helm 클라이언트가 Helm 차트를 적용하지 못했습니다.	helm lint PATH [flags] 명령을 사용하여 차트의 정확성을 확인하세요. helm install <CHART_NAME> --dry-run --debug 명령을 사용하여 배포 구성의 정확성을 확인하세요.
Helm 차트 제거 실패	Helm 클라이언트가 Helm 차트를 제거하지 못했습니다.	helm version 명령을 사용하여 Helm 버전을 확인하세요. helm uninstall <RELEASE_NAME? --namespace <NAMESPACE> 명령을 사용하여 올바른 네임스페이스에서 Helm 차트를 제거하세요. 올바른 릴리스 이름을 지정하고 있는지 확인하세요. 릴리스 이름은 대/소문자를 구분하며 제거하려는 릴리스의 이름과 일치해야 합니다.
잘못된 구성	Helm 공급자에 대한 잘못된 구성 설정	inCluster 설정을 부울 값으로 설정하세요.

Kubectl 공급자 오류 코드

오류 코드	설명	해결 단계
구성 요소 사양 가져오기 실패	구성 요소 사양을 가져오지 못했습니다.	구성 요소에 대해 YAML 또는 리소스 속성이 설정되어 있는지 확인하세요. YAML 구문을 확인하고 오류가 없는지 확인하세요.
유효성 검사 실패	구성 요소 유형, 속성 또는 메타데이터의 유효성을 검사하지 못했습니다.	필요한 구성 요소 유형, 속성 및 메타데이터를 설정하세요.
YAML 읽기 실패	YAML 데이터를 읽지 못했습니다.	YAML 파일에 구문 오류가 있는지 확인하세요. YAML은 들여쓰기 및 서식 지정에 민감합니다. 다중 문서 YAML 파일이 있는 경우 3개의 하이픈(---)으로 구분되어 있는지 확인하세요.
YAML 적용 실패	사용자 지정 리소스를 적용하지 못했습니다.	YAML 파일에 구문 오류가 있는지 확인하세요. YAML은 들여쓰기 및 서식 지정에 민감합니다. 구성 파일에서 올바른 Kubernetes 클러스터를 확인하세요. kubectl config current-context 명령을 사용하고 예상되는 클러스터인지 확인하세요. YAML 파일이 metadata.namespace 필드에 네임스페이스를 지정하는지 확인하세요. 네임스페이스가 있는지 확인하거나 올바른 네임스페이스를 사용하도록 YAML 파일을 수정하세요.
리소스 속성 읽기 실패	리소스 데이터를 바이트로 변환하지 못했습니다.	YAML 파일에 구문 오류가 있는지 확인하세요. YAML은 들여쓰기 및 서식 지정에 민감합니다. kubectl이 올바른 Kubernetes 클러스터에 연결하도록 올바르게 구성되었는지 확인하세요. kubectl config current-context 명령을 사용하여 현재 컨텍스트를 확인하세요. 먼저 YAML 파일의 CRD 참조가 만들어졌는지 확인하세요.
리소스 적용 실패	사용자 지정 리소스를 적용하지 못했습니다.	YAML 파일에 구문 오류가 있는지 확인하세요. YAML은 들여쓰기 및 서식 지정에 민감합니다. 구성 파일에서 올바른 Kubernetes 클러스터를 확인하세요. kubectl config current-context 명령을 사용하고 예상되는 클러스터인지 확인하세요. YAML 파일이 metadata.namespace 필드에 네임스페이스를 지정하는지 확인하세요. 네임스페이스가 있는지 확인하거나 올바른 네임스페이스를 사용하도록 YAML 파일을 수정하세요. 이름이 같은 리소스가 클러스터에 이미 있는지 확인하세요. 리소스에 다른 이름을 사용할 것을 고려하세요.
YAML 삭제 실패	YAML 속성에서 개체를 삭제하지 못했습니다.	삭제를 위해 사용 중인 YAML 파일이 특정 경로에 이미 있는지 확인하세요. YAML 파일에 액세스하는 데 필요한 읽기 권한이 있는지 확인하세요. YAML 파일의 리소스 정의에 아직 생성되거나 적용되지 않은 다른 리소스에 대한 종속성이 없음을 확인하세요. YAML 파일에 지정된 리소스 이름이 클러스터의 기존 리소스 이름과 일치하는지 확인하세요. --dry-run 옵션을 kubectl delete 명령과 함께 사용하여 리소스를 삭제하지 않고 삭제 작업을 테스트하세요.
리소스 삭제 실패	사용자 지정 리소스를 삭제하지 못했습니다.	삭제를 위해 사용 중인 리소스가 이미 있는지 확인하세요. 리소스 정의에 아직 생성되거나 적용되지 않은 다른 리소스에 대한 종속성이 없음을 확인하세요. 리소스 이름이 클러스터의 기존 리소스 이름과 일치하는지 확인하세요. --dry-run 옵션을 kubectl delete 명령과 함께 사용하여 리소스를 삭제하지 않고 삭제 작업을 테스트하세요.
리소스 상태 확인 실패	시간 제한 기간 내에 리소스 상태를 확인하지 못했습니다.	사용 중인 리소스의 이름이 있는지 확인하세요. 리소스가 있는 클러스터를 확인하고 이를 구성 요소 속성으로 전달하세요.
YAML 또는 리소스 속성을 찾을 수 없음	구성 요소에 YAML 또는 리소스 속성이 없습니다.	구성 요소에 대한 YAML 또는 리소스 속성을 설정하세요. kubectl 공급자를 사용하려면 적어도 두 속성 값 중 하나를 정의해야 합니다. 구성 설정에서 올바른 속성 값을 확인하세요.