Kubernetes 애플리케이션 제품의 배포 실패 문제 해결

아티클
04/12/2024

이 문서에서는 Microsoft Azure Marketplace 수락된 Kubernetes 애플리케이션 제품의 배포 실패 문제를 해결하는 방법을 설명합니다. Kubernetes 제품 구매를 시작하면 Azure는 제품을 이행하는 데 필요한 리소스를 설치하려는 ARM 템플릿(Azure Resource Manager 템플릿)을 배포합니다. 그러나 ARM 템플릿 배포는 여러 가지 이유로 실패할 수 있습니다.

문제 해결 검사 목록

배포 작업 로그 검사

배포 실패의 원인을 확인하려면 배포 작업 로그를 검사해야 합니다. Azure Portal 배포 실패 페이지를 계속 보고 있는 경우 다음 절차의 5단계에서 시작합니다. 대신 Azure Portal 종료하거나 다른 포털 페이지로 이동한 경우 다음 모든 단계를 수행합니다.

Azure Portal리소스 그룹을 검색하여 선택합니다.
리소스 그룹 목록에서 Kubernetes 애플리케이션을 배포하려고 시도한 리소스 그룹의 이름을 선택합니다.
리소스 그룹의 개요 페이지에서 Essentials 섹션을 찾은 다음 배포 필드 옆에 표시되는 하이퍼링크 텍스트를 선택합니다. 이 텍스트는 리소스 그룹의 리소스 배포 기록(예: 실패 4회, 성공 30회)의 성공률을 표시합니다.
리소스 그룹에 대해 시도한 배포 목록에서 다음 해당 필드에 따라 실패한 배포의 배포 이름 값을 선택합니다.
- 마지막으로 수정한 날짜(타임스탬핑)
- 기간
- 상태(성공대신 실패 표시)
배포 페이지의 배포 세부 정보 목록에서 상태 필드에 충돌 값이 있는 리소스를 찾습니다. 해당 리소스에 대한 작업 세부 정보 링크를 선택합니다.
작업 세부 정보 창에서 Status 속성(충돌 값 표시)을 찾아 속성 아래의 상태 메시지 상자를 검사합니다.

상태 메시지 내의 JSON 코드에는 의 Failed속성이 status 표시됩니다. 또한 의 code 자식 속성("ExtensionOperationFailed"과 같은 오류 코드 이름) 및 message ("확장 작업이 실패했습니다. 지정된 값에서 확장 버전을 resolve 못했습니다.")와 같은 오류 메시지 설명이 포함된 속성을 표시 error 합니다. JSON 코드는 다음 텍스트와 유사합니다.
```
{
    "status": "Failed",
    "error": {
        "code": "ExtensionOperationFailed",
        "message": "The extension operation failed with the following error: Failed to resolve the extension version from the given values."
    }
}
```

다음 섹션에서는 몇 가지 일반적인 오류 시나리오에 대한 원인 및 솔루션에 대해 설명합니다.

원인 1: 애플리케이션이 선택한 AKS 클러스터에 설치되지 않음

Kubernetes 애플리케이션이 선택한 AKS(Azure Kubernetes Service) 클러스터에 설치되지 않은 경우 다음 텍스트와 유사한 오류 메시지가 표시됩니다.

요청이 https://management.azure.com/subscriptions/<subscription-guid>/resourceGroups/resourceGroup/providers/Microsoft.ContainerService/managedclusters/aks-cluster/extensionaddons/default?api-version=2021-03-01에 실패했습니다. 오류 코드: 사용할 수 없습니다. 이유: 사용할 수 없습니다.
{  
  "error": {  
    "code": "AuthorizationFailed",  
    "message": "The client '<client-guid>' with object id '<client-guid>' does not have authorization to perform action 'Microsoft.ContainerService/managedclusters/extensionaddons/read' over scope '/subscriptions/<subscription-guid>/resourceGroups/resourceGroup/providers/Microsoft.ContainerService/managedclusters/aks-cluster/extensionaddons/default' or the scope is invalid. If access was recently granted, please refresh your credentials."  
  }  
} 

해결 방법 1a: Microsoft.KubernetesConfiguration 리소스 공급자 등록

Microsoft.KubernetesConfiguration 리소스 공급자를 등록합니다. 이 경우 Kubernetes 애플리케이션을 배포하려면 Microsoft.KubernetesConfiguration 리소스 공급자가 필요하기 때문에 설치에 실패했습니다. 등록 지침은 Azure Marketplace 컨테이너 제품 배포 문서의 "리소스 공급자 등록" 섹션을 참조하세요.

해결 방법 1b: AKS 클러스터의 상태 유지 관리

일반적으로 설치 기간 동안 다른 문제가 발생하지 않도록 AKS 클러스터의 상태를 검사 합니다. 클러스터가 정상인지 확인하려면 클러스터에서 식별되는 문제를 resolve.

해결 방법 1c: Azure Monitor 활동 로그 검사

클러스터가 정상 상태이지만 설치가 여전히 실패하면 어떻게 해야 할까요? 이 경우 AKS 클러스터 내의 Azure Monitor 활동 로그 를 검사하여 설치 단계에서 오류의 원인을 찾습니다.

원인 2: 구독에 리소스 제약 조건이 있습니다.

Azure 구독에 리소스 제약 조건이 있으므로 다음 텍스트와 유사한 오류 메시지를 생성하는 오류가 발생합니다.

'알 수 없는' 결제 수단은 OfferId: 'offer-name>', PlanId '<<subscription-plan-name>'을 사용하여 제품에 대해 지원되지 않습니다.

해결 방법 2: 구독이 필요한 청구 구성을 충족하는지 확인

구독의 청구 구성을 확인하여 Kubernetes 애플리케이션의 리소스 요구 사항을 충족하는지 확인합니다. 자세한 내용은 유효성 검사 구매를 참조하세요.

원인 3: 해당 지역에서 제품을 사용할 수 없음

특정 지역에서 제품을 판매할 수 없다는 오류 메시지가 표시됩니다. 오류 메시지는 다음 텍스트와 유사할 수 있습니다.

제품: '<offer-name>'은 구독에서 구매할 수 없습니다. '<subscription-guid>'는 시장에서 판매되지 않기 때문에 '<two-letter-region-code'입니다.

해결 방법 3: 제품을 계속 사용할 수 있는지 여부 및 위치 다시 확인

제품을 계속 사용할 수 있는지 확인하고 제품이 적용되는 지역을 두 번 검사.

원인 4: 내부 서버 오류가 발생했습니다.

확장 리소스가 설치되지 않아 Kubernetes 애플리케이션이 설치되지 않았습니다. 이 오류는 다음 오류 메시지를 생성합니다.

내부 서버 오류로 확장을 배포하지 못했습니다.

해결 방법 4: 확장 삭제 및 다시 설치

먼저 제품 구매의 일부인 확장 리소스를 삭제합니다. 그런 다음 확장을 다시 설치합니다.

원인 5: Helm 차트가 설치되지 않음

Helm 차트의 오류는 다음 오류 메시지를 생성합니다.

릴리스 경로 []에서 차트를 설치하지 못했습니다.

해결 방법 5: ARM 템플릿에서 만든 항목 다시 확인

ARM 템플릿 배포에 대한 Azure Portal 입력한 값과 선택 항목이 Kubernetes 애플리케이션에서 허용되는지 확인합니다.

원인 6: 이 플랜에 대한 구독에 대한 법적 조건을 수락하지 않았습니다.

구독을 사용하려면 이미지의 법적 조건에 동의해야 합니다. 그렇지 않으면 다음 오류 메시지가 표시됩니다.

이 플랜에 대한 '<subscription-guid>' 구독에 대한 법적 조건을 수락하지 않았습니다. 구독을 사용하려면 이미지의 법적 조건에 동의해야 합니다.

해결 방법 6: 법적 조건 동의

Azure Portal 통해 배포할 수 있습니다. 이 Azure Portal 법적 조건을 읽고 수락하기 위한 UI 환경을 제공합니다.

다음 단계

AKS 클러스터 확장을 배포할 때 발생하는 오류 문제 해결

타사 정보 고지 사항

이 문서에 나와 있는 다른 공급업체 제품은 Microsoft와 무관한 회사에서 제조한 것입니다. Microsoft는 이들 제품의 성능이나 안정성에 관하여 명시적이든 묵시적이든 어떠한 보증도 하지 않습니다.

도움을 요청하십시오.

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

다음을 통해 공유