Azure App Configuration 확장(미리 보기) 설치 오류 문제 해결

아티클
05/29/2024

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

참고

이 문제는 확장의 미리 보기 버전에만 적용됩니다.
Azure App Configuration 확장이 성공적으로 설치되었지만 사용하는 동안 문제가 발생하는 경우 Azure App Configuration Kubernetes 공급자 문제 해결 가이드를 참조하세요.

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

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

메시지 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: 먼저 Azure App Configuration Kubernetes 공급자 제거

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

시나리오 2: 대상 Azure App Configuration 확장 버전이 없습니다.

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

(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 App Configuration 확장 버전에 대해 다시 설치

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

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

일부 버전의 Azure App Configuration 확장은 일부 지역에서 사용할 수 없으므로 다음 오류 메시지가 표시될 수 있습니다.

(ExtensionTypeRegistrationGetFailed) 확장 유형 microsoft.appconfiguration은 region-name<>에 등록되지 않았습니다.

코드: ExtensionTypeRegistrationGetFailed

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

해결 방법 3: 다른 지역에 설치

Azure App Configuration 확장이 지원되는 지역에서 설치를 실행합니다.

다음 단계

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

도움을 요청하십시오.

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

다음을 통해 공유