Udostępnij za pośrednictwem

Przewodnik rozwiązywania problemów z usługą AKS włączonym przez usługę Azure Arc w oprogramowaniu VMware

  • Artykuł

Dotyczy: usługa AKS włączona przez usługę Azure Arc w programie VMware (wersja zapoznawcza)

W tym artykule opisano kroki rozwiązywania problemów ze znanymi problemami i błędami, które mogą wystąpić podczas wdrażania usługi AKS włączonej przez usługę Azure Arc w wersji zapoznawczej programu VMware. Możesz również przejrzeć znane problemy tutaj lub postępować zgodnie z omówieniem rozwiązywania problemów, aby zgłosić usterki lub przekazać opinię o produkcie.

Ta strona jest stale aktualizowana, więc sprawdź tutaj, aby uzyskać nowe informacje. W miarę identyfikowania krytycznych problemów, które wymagają obejścia, dodajemy je. Przed wdrożeniem usługi AKS Arc w wersji zapoznawczej programu VMware przejrzyj te informacje.

Mostek zasobów łuku

Problemy z mostem zasobów usługi Azure Arc

W przypadku problemów z mostem zasobów usługi Azure Arc zapoznaj się z przewodnikiem rozwiązywania problemów tutaj.

Odzyskiwanie po nieudanych wdrożeniach mostka zasobów usługi Arc

Zobacz przewodnik rozwiązywania problemów tutaj.

Połączenie programu vCenter z platformą Azure

Jeśli zostanie wyświetlony komunikat o błędzie informujący o tym, że nazwa> mostka zasobów mostka <zasobów skojarzona z tym programem vCenter jest obecnie niedostępna. Operacje wykonywane w tym programie vCenter mogą zakończyć się niepowodzeniem" — wskazuje, że mostek zasobów używany do połączenia z programem vCenter jest wyłączony lub usunięty.

Aby rozwiązać problem, wykonaj następujące kroki:

Zbieranie dzienników

Jeśli wystąpią problemy, możesz udostępnić pliki dziennika i wersję interfejsu wiersza polecenia inżynierom pomocy technicznej na potrzeby debugowania.

Problemy przed wdrożeniem mostka zasobów usługi Arc

Pobierz plik kva.log z systemu pod adresem c:\programdata\kva\kva.log, aby uzyskać więcej pełnych informacji.

Problemy podczas wdrażania mostka zasobów usługi Arc

Aby zebrać dzienniki, wykonaj następujące polecenia z komputera, którego wcześniej użyto do próby wdrożenia mostka zasobów usługi Arc. Począwszy od interfejsu wiersza polecenia w wersji 1.0.0, należy najpierw uruchomić polecenie az arcappliance get-credentials. Dzięki temu wszystkie wymagane poświadczenia do zbierania dzienników są ściągane na maszynę. Aby uzyskać więcej informacji na temat tego polecenia, zobacz dokumentację interfejsu wiersza polecenia:

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

Po uruchomieniu az arcappliance get-credentials polecenia możesz kontynuować zbieranie dzienników az arcappliance logs vmware przy użyciu polecenia :

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>

Jeśli jeszcze nie utworzono maszyny wirtualnej urządzenia, az arcappliance logs vmware polecenie nie jest przydatne, a plik klucza dziennika nie jest generowany.

Problemy z uruchamianiem mostka zasobów usługi Arc

Aby zebrać dzienniki, uruchom az arcappliance logs vmware polecenie z tej samej maszyny, która została użyta do wdrożenia mostka zasobów usługi Arc:

  • Jeśli masz narzędzie kubeconfig dla urządzenia, a maszyna wirtualna urządzenia jest uruchomiona z dostępnym serwerem interfejsu API, następujące polecenie zbiera dzienniki z urządzenia i generuje plik .zip w bieżącym katalogu roboczym:

    az arcappliance logs vmware --kubeconfig='<path to your kubeconfig>'

  • Jeśli nie masz narzędzia kubeconfig lub serwer interfejsu API jest niedostępny, następujące polecenie zbiera dzienniki przy użyciu określonego adresu IP maszyny wirtualnej urządzenia (sprawdź sieć szkieletową wirtualizacji, na przykład Menedżera funkcji Hyper-V, aby zlokalizować adres IP maszyny wirtualnej urządzenia). Należy pamiętać, że kubeconfig parametr jest nadal wymagany, ale można go przekazać jako pusty ciąg, jeśli podano również adres IP:

    az arcappliance logs vmware --kubeconfig='' --ip='<IP address of Arc Resource Bridge VM>'

Przykłady z wypełnionymi wartościami

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

Pobieranie wersji rozszerzenia interfejsu wiersza polecenia

Wersję rozszerzenia interfejsu wiersza polecenia urządzenia można zwrócić, uruchamiając następujące polecenie:

az extension show --name arcappliance -o table

Musisz mieć najnowszą wersję interfejsu wiersza polecenia Az zainstalowaną we wszystkich węzłach w klastrze fizycznym.

  • Sprawdź, czy masz interfejs wiersza polecenia Az, uruchamiając polecenie az -v.
  • Przeprowadź uaktualnienie do najnowszej wersji, uruchamiając polecenie az upgrade.

Komunikaty o błędach i kroki rozwiązywania problemów

Ta sekcja zawiera listę typowych komunikatów o błędach i ich kroków rozwiązywania problemów.

Błąd: "AlreadyDeployedError"

  • Główna przyczyna: ten błąd występuje, ponieważ środowisko nie zostało wyczyszczone z poprzedniego wdrożenia przed podjęciem próby ponownego wdrożenia.
  • Rozwiązanie: aby rozwiązać ten problem, odinstaluj mostek zasobów usługi Arc, a następnie spróbuj wdrożyć ponownie.

Błąd: x509: certyfikat wygasł lub nie jest jeszcze prawidłowy: bieżąca godzina <1 jest przed <godziną 2>>. Sprawdzanie nie powiodło się

  • Główna przyczyna: ten błąd występuje, gdy certyfikaty wygasają z powodu niezgodności czasu między maszyną klienta a maszyną wirtualną (lub serwerem ESXi). Jedna z nich nie jest włączona w systemie NTP.
  • Rozwiązanie:
    1. Sprawdź, czy czas na maszynie wirtualnej jest zgodny z czasem na maszynie używanej na potrzeby wdrożenia usługi ARB.
    2. Połącz serwer ESXi z serwerem NTP, aby zsynchronizować czas i rozwiązać problem.

Błąd: Termin "az" nie jest rozpoznawany jako nazwa polecenia cmdlet, funkcji, pliku skryptu lub programu możliwego do obsługi. Sprawdź pisownię nazwy lub jeśli ścieżka została dołączona, sprawdź, czy ścieżka jest poprawna i spróbuj ponownie

  • Główna przyczyna: interfejs wiersza polecenia az nie został rozpoznany, ponieważ poprzednie okno programu PowerShell zostało zamknięte i nie zostało zsynchronizowane z instalacją interfejsu wiersza polecenia platformy Azure.
  • Rozwiązanie:
    1. Otwórz nowe okno programu PowerShell i przejdź do folderu, w którym zapisano skrypt dołączania mostka zasobów arc.
    2. Wykonaj polecenie .temp\.env\Scripts\Activate.ps1 , aby zainstalować plik venv języka Python.

Następne kroki