VMware의 Azure Arc에서 사용하도록 설정된 AKS의 문제에 대한 문제 해결 가이드

아티클
04/01/2024

적용 대상: VMware에서 Azure Arc에서 사용하도록 설정된 AKS(미리 보기)

이 문서에서는 VMware 미리 보기에서 Azure Arc에서 사용하도록 설정된 AKS를 배포할 때 발생할 수 있는 알려진 문제 및 오류에 대한 문제 해결 단계를 간략하게 설명합니다. 여기에서 알려진 문제를 검토하거나 문제 해결 개요에 따라 버그를 보고하거나 제품 피드백을 제공할 수도 있습니다.

이 페이지는 지속적으로 업데이트되므로 새 정보를 보려면 여기로 검사. 해결 방법이 필요한 중요한 문제를 식별할 때 추가합니다. VMware 미리 보기에 AKS Arc를 배포하기 전에 이 정보를 주의 깊게 검토하세요.

Arc 리소스 브리지

Azure Arc 리소스 브리지 문제

Azure Arc 리소스 브리지 문제는 여기에서 문제 해결 가이드를 참조하세요.

Arc Resource Bridge의 실패한 배포에서 복구

여기에서 문제 해결 가이드를 참조하세요.

Azure에 대한 vCenter 연결

"이 vCenter와 연결된 리소스 브리지 <이름을> 현재 사용할 수 없습니다. 이 vCenter에서 수행된 작업은 결과적으로 실패할 수 있습니다." vCenter를 연결하는 데 사용되는 리소스 브리지가 다운되거나 삭제되었음을 나타냅니다.

이 문제를 해결하려면 다음 단계를 수행합니다.

Arc 리소스 브리지가 삭제되면 다시 배포합니다.
Arc Resource Bridge가 다운된 경우(오프라인) 재해 복구 작업 수행 - Azure Arc에 나열된 재해 복구 단계를 수행합니다.

로그 수집

문제가 발생하는 경우 디버깅을 위해 지원 엔지니어와 로그 파일 및 CLI 버전을 공유할 수 있습니다.

Arc Resource Bridge 배포 전 문제

자세한 내용은 c:\programdata\kva\kva.log 시스템에서 kva.log파일을 검색합니다.

Arc Resource Bridge 배포 중 문제

로그를 수집하려면 이전에 Arc 리소스 브리지 배포를 시도하는 데 사용한 컴퓨터에서 다음 명령을 실행합니다. CLI 버전 1.0.0부터 먼저 명령을 az arcappliance get-credentials실행해야 합니다. 이렇게 하면 로그 수집에 필요한 모든 자격 증명이 컴퓨터로 끌어올 수 있습니다. 이 명령에 대한 자세한 내용은 CLI 설명서를 참조하세요.

az arcappliance get-credentials –name <name of Arc Resource Bridge> --resource-group <name of resource group>

명령을 실행한 az arcappliance get-credentials 후 명령을 사용하여 로그 수집을 진행할 수 있습니다.az arcappliance logs vmware

az arcappliance logs vmware --ip <Arc Resource Bridge VM control plane IP endpoint> --address <vCenter FQDN/IP address, same one used when creating config files> --username <vcenter username> --password <vcenter password>

어플라이언스 VM az arcappliance logs vmware 을 아직 만들지 않은 경우 명령은 유용하지 않으며 로그 키 파일이 생성되지 않습니다.

Arc Resource Bridge가 실행 중일 때 발생하는 문제

로그를 수집하려면 Arc Resource Bridge를 az arcappliance logs vmware 배포하는 데 사용한 것과 동일한 컴퓨터에서 명령을 실행합니다.

어플라이언스 대한 kubeconfig가 있고 어플라이언스 VM이 연결 가능한 API 서버에서 실행되는 경우 다음 명령은 어플라이언스 로그를 수집하고 현재 작업 디렉터리에 .zip 파일을 출력합니다.
```
az arcappliance logs vmware --kubeconfig='<path to your kubeconfig>'
```
kubeconfig가 없거나 API 서버에 연결할 수 없는 경우 다음 명령은 지정된 어플라이언스 VM IP 주소(가상화 패브릭 검사(예: Hyper-V 관리자)를 사용하여 로그를 수집하여 어플라이언스 VM IP 주소를 찾습니다. kubeconfig 매개 변수는 여전히 필요하지만 IP도 제공되는 경우 빈 문자열로 전달할 수 있습니다.
```
az arcappliance logs vmware --kubeconfig='' --ip='<IP address of Arc Resource Bridge VM>'
```

채워진 값이 있는 예제

az arcappliance logs vmware --kubeconfig .\resourcebridge\kubeconfig
az arcappliance logs vmware --kubeconfig='kubeconfig'
az arcappliance logs vmware --kubeconfig='' --ip=10.0.1.166

CLI 확장 버전 가져오기

다음 명령을 실행하여 어플라이언스 CLI 확장 버전을 반환할 수 있습니다.

az extension show --name arcappliance -o table

물리적 클러스터의 모든 노드에 최신 버전의 Az CLI 가 설치되어 있어야 합니다.

를 실행 az -v하여 Az CLI가 있는지 확인합니다.
를 실행 az upgrade하여 최신 버전으로 업그레이드합니다.

오류 메시지 및 문제 해결 단계

이 섹션에서는 일반적인 오류 메시지 목록과 문제 해결 단계를 제공합니다.

오류: "AlreadyDeployedError"

근본 원인: 이 오류는 환경이 이전 배포에서 정리되지 않은 후 다시 배포를 시도하기 때문에 발생합니다.
해결 방법: 이 문제를 resolve Arc Resource Bridge를 제거한 다음 다시 배포를 시도합니다.

오류: x509: 인증서가 만료되었거나 아직 유효하지 않습니다. 현재 시간<1>은 time2> 이전<입니다. 실패 확인

근본 원인: 이 오류는 클라이언트 컴퓨터와 VM(또는 ESXi 서버) 간의 시간 불일치로 인해 인증서가 만료될 때 발생합니다. 그 중 하나는 NTP 사용이 아닙니다.
해결 방법:
1. VM의 시간이 ARB 배포에 사용한 컴퓨터의 시간과 일치하는지 확인합니다.
2. ESXi 서버를 NTP 서버에 연결하여 시간을 동기화하고 문제를 resolve.

오류: 'az'라는 용어는 cmdlet, 함수, 스크립트 파일 또는 작동 가능한 프로그램의 이름으로 인식되지 않습니다. 이름의 철자를 확인하거나 경로가 포함된 경우 경로가 올바른지 확인하고 다시 시도합니다.

근본 원인: 이전 PowerShell 창이 닫혀 있고 Azure CLI 설치와 동기화되지 않았기 때문에 Az CLI가 인식되지 않습니다.
해결 방법:
1. 새 PowerShell 창을 열고 Arc Resource Bridge 온보딩 스크립트를 저장한 폴더로 이동합니다.
2. 를 실행 .temp\.env\Scripts\Activate.ps1 하여 Python venv를 설치합니다.

다음을 통해 공유