Azure 앱 구성 확장 설치 오류 문제 해결

아티클
11/19/2024

이 문서에서는 AKS(Microsoft Azure Kubernetes Service)에 대한 Azure 앱 구성 확장을 설치하거나 업데이트할 때 발생할 수 있는 몇 가지 일반적인 오류 시나리오에 대해 설명합니다.

참고 항목

Azure 앱 구성 확장이 성공적으로 설치되었지만 사용하는 동안 문제가 발생하는 경우 Azure 앱 구성 Kubernetes 공급자 문제 해결 가이드를 참조하세요.

시나리오 1: Azure 앱 구성 Kubernetes 공급자가 이미 설치되어 있습니다.

AKS용 Azure 앱 구성 확장을 설치하려고 하지만 Azure 앱 구성 Kubernetes 공급자가 명령을 통해 helm install 이미 설치되어 있음을 나타내는 오류 메시지가 표시됩니다. 오류 메시지는 다음 오류 메시지 중 하나와 유사할 수 있습니다.

메시지 1

(ExtensionOperationFailed) 다음 오류로 확장 작업이 실패했습니다. 오류: [ InnerError: [Helm 설치 실패: 클러스터 에 이미 존재하는 리소스: 권장 사항: 현재 클러스터에 있는 리소스를 수동으로 삭제하고 설치를 다시 시도하세요. 이러한 리소스를 삭제하려면 다음 명령을 실행합니다. kubectl delete {resource type} -n {resource namespace} {resource name} InnerError [렌더링된 매니페스트에는 이미 존재하는 리소스가 포함되어 있습니다. 설치를 계속할 수 없음: "" 네임스페이스에 CustomResourceDefinition "azureappconfigurationproviders.azconfig.io"이 있으며 현재 릴리스로 가져올 수 없습니다. 소유권 메타데이터가 잘못되었습니다. 주석 유효성 검사 오류: 키 "meta.helm.sh/release-name"은 "azureappconfig"여야 합니다. 현재 값은 "azureappconfiguration.kubernetesprovider"입니다. 주석 유효성 검사 오류: "meta.helm.sh/release-namespace" 키는 "kube-system"이어야 합니다. 현재 값은 "azappconfig-system"]]] 작업을 수행하는 동안 발생했습니다. 구성에서 [만들기], 일반적인 문제 해결 방문: https://aka.ms/k8s-extensions-TSG.

메시지 2

(ExtensionOperationFailed) 다음 오류로 확장 작업이 실패했습니다. 오류: [ InnerError: [Helm 설치 실패: 클러스터 에 이미 존재하는 리소스: 권장 사항: 현재 클러스터에 있는 리소스를 수동으로 삭제하고 설치를 다시 시도하세요. 이러한 리소스를 삭제하려면 다음 명령을 실행합니다. kubectl delete {resource type} -n {resource namespace} {resource name} InnerError [렌더링된 매니페스트에는 이미 존재하는 리소스가 포함되어 있습니다. 설치를 계속할 수 없음: "azappconfig-system" 네임스페이스의 ServiceAccount "az-appconfig-k8s-provider"가 존재하며 현재 릴리스로 가져올 수 없습니다. 소유권 메타데이터가 잘못되었습니다. 주석 유효성 검사 오류: "meta.helm.sh/release-name" 키는 "azureappconfig"여야 합니다. 현재 값은 "azureappconfiguration.kubernetesprovider"]]] 작업을 수행하는 동안 발생했습니다. 구성에서 [만들기], 일반적인 문제 해결 방문: https://aka.ms/k8s-extensions-TSG.

솔루션 1: 구성 Kubernetes 공급자를 먼저 Azure 앱 제거

Azure 앱 구성 확장을 설치하기 전에 Azure 앱 Configuration Kubernetes 공급자를 제거합니다. 자세한 내용은 리소스 정리를 참조하세요.

시나리오 2: 대상 Azure 앱 구성 확장 버전이 없습니다.

특정 버전을 대상으로 하는 Azure 앱 구성 확장을 설치하려고 하면 Azure 앱 구성 버전이 존재하지 않는다는 오류 메시지가 표시됩니다.

(ExtensionOperationFailed) 다음 오류 로 확장 작업이 실패했습니다. 지정된 값에서 확장 버전을 해결하지 못했습니다. https://aka.ms/k8s-extension-type-versions 설치에 대한 올바른 버전을 찾으려면 일반적인 문제 해결을 참조 https://aka.ms/k8s-extensions-TSG하세요. .

코드: ExtensionOperationFailed

메시지: 다음 오류 로 확장 작업이 실패했습니다. 지정된 값에서 확장 버전을 해결하지 못했습니다. https://aka.ms/k8s-extension-type-versions 설치에 대한 올바른 버전을 찾으려면 일반적인 문제 해결을 참조 https://aka.ms/k8s-extensions-TSG하세요. .

솔루션 2: 지원되는 Azure 앱 구성 확장 버전에 대해 다시 설치

확장을 다시 설치합니다. 지원되는 버전의 Azure 앱 구성 확장을 사용해야 합니다.

시나리오 3: 대상 Azure 앱 구성 확장 버전이 있지만 지정된 지역에는 없습니다.

Azure 앱 구성 확장은 모든 AKS 지역에서 사용할 수 없으므로 다음 오류 메시지가 표시될 수 있습니다.

(ExtensionTypeRegistrationGetFailed) 확장 유형 microsoft.appconfiguration이 지역 <이름>에 등록되지 않았습니다.

코드: ExtensionTypeRegistrationGetFailed

메시지: 확장 유형 microsoft.appconfiguration이 지역 <이름에 등록되지 않았습니다.>

솔루션 3: 다른 지역에 설치

클러스터 확장이 지원하는 지역에서 설치를 실행합니다.

다음 단계

설치 문제가 계속 발생하는 경우 AKS 문제 해결 가이드를 살펴보세요.

도움을 요청하십시오.

질문이 있거나 도움이 필요한 경우 지원 요청을 생성하거나 Azure 커뮤니티 지원에 문의하세요. Azure 피드백 커뮤니티에 제품 피드백을 제출할 수도 있습니다.

다음을 통해 공유