Condividi tramite

Guida alla risoluzione dei problemi nel servizio Azure Kubernetes abilitato da Azure Arc in VMware

  • Articolo

Si applica a: servizio Azure Kubernetes abilitato da Azure Arc in VMware (anteprima)

Questo articolo illustra i passaggi per la risoluzione dei problemi noti e gli errori che possono verificarsi durante la distribuzione del servizio Azure Kubernetes abilitato dall'anteprima di Azure Arc in VMware. È anche possibile esaminare i problemi noti qui o seguire la panoramica della risoluzione dei problemi per segnalare i bug o fornire commenti e suggerimenti sui prodotti.

Questa pagina viene continuamente aggiornata, quindi controlla qui le nuove informazioni. Man mano che vengono identificati problemi critici che richiedono soluzioni alternative, vengono aggiunti. Esaminare attentamente queste informazioni prima di distribuire l'anteprima di Arc del servizio Azure Kubernetes in VMware.

Arc Resource Bridge

Problemi del bridge di risorse di Azure Arc

Per i problemi relativi al bridge di risorse di Azure Arc, vedere la guida alla risoluzione dei problemi qui.

Eseguire il ripristino da distribuzioni non riuscite di Arc Resource Bridge

Vedere la guida alla risoluzione dei problemi qui.

Connessione vCenter ad Azure

Se viene visualizzato un messaggio di errore che indica che il nome> del bridge di risorse del bridge <di risorse associato a questo vCenter non è attualmente disponibile. Le operazioni eseguite in questo vCenter potrebbero non riuscire di conseguenza", indica che il bridge di risorse usato per connettere vCenter è inattivo o eliminato.

Per ovviare a questo problema, esegui la procedura seguente:

Raccogliere i log

In caso di problemi, è possibile condividere i file di log e la versione dell'interfaccia della riga di comando con tecnici del supporto per scopi di debug.

Problemi prima della distribuzione di Arc Resource Bridge

Recuperare il file kva.log dal sistema in c:\programdata\kva\kva.log per informazioni più dettagliate.

Problemi durante la distribuzione di Arc Resource Bridge

Per raccogliere i log, eseguire i comandi seguenti dal computer usato in precedenza per tentare la distribuzione del bridge di risorse Arc. A partire dalla versione 1.0.0 dell'interfaccia della riga di comando, è prima necessario eseguire il comando az arcappliance get-credentials. In questo modo tutte le credenziali necessarie per la raccolta di log vengono estratte nel computer. Per altre informazioni su questo comando, vedere la documentazione dell'interfaccia della riga di comando:

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

Dopo aver eseguito il az arcappliance get-credentials comando, è possibile procedere con la raccolta di log usando il az arcappliance logs vmware comando :

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>

Se non è ancora stata creata una macchina virtuale dell'appliance, il az arcappliance logs vmware comando non è utile e il file di chiave di log non viene generato.

Problemi relativi all'esecuzione di Arc Resource Bridge

Per raccogliere i log, eseguire il az arcappliance logs vmware comando dallo stesso computer usato per distribuire Arc Resource Bridge:

  • Se si dispone di kubeconfig per l'appliance e la macchina virtuale dell'appliance è in esecuzione con un server API raggiungibile, il comando seguente raccoglie i log dall'appliance e restituisce un file .zip nella directory di lavoro corrente:

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

  • Se non si ha kubeconfig o il server API non è raggiungibile, il comando seguente raccoglie i log usando l'indirizzo IP della macchina virtuale dell'appliance specificato (controllare l'infrastruttura di virtualizzazione, ad esempio, la console di gestione di Hyper-V per individuare l'indirizzo IP della macchina virtuale dell'appliance). Si noti che il kubeconfig parametro è ancora obbligatorio, ma può essere passato come stringa vuota se viene fornito anche un INDIRIZZO IP:

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

Esempi con valori popolati

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

Ottenere la versione dell'estensione dell'interfaccia della riga di comando

È possibile restituire la versione dell'estensione dell'interfaccia della riga di comando dell'appliance eseguendo il comando seguente:

az extension show --name arcappliance -o table

È necessario avere una versione recente dell'interfaccia della riga di comando di Az installata in tutti i nodi del cluster fisico.

  • Verificare di avere l'interfaccia della riga di comando di Az eseguendo az -v.
  • Eseguire l'aggiornamento alla versione più recente eseguendo az upgrade.

Messaggi di errore e passaggi per la risoluzione dei problemi

Questa sezione fornisce un elenco dei messaggi di errore comuni e dei relativi passaggi per la risoluzione dei problemi.

Errore: "AlreadyDeployedError"

  • Causa radice: questo errore si verifica perché l'ambiente non è stato pulito dalla distribuzione precedente prima di tentare di eseguire di nuovo la distribuzione.
  • Soluzione: per risolvere questo problema, disinstallare Arc Resource Bridge e quindi riprovare a eseguire la distribuzione.

Errore: x509: il certificato è scaduto o non è ancora valido: l'ora <corrente1> è precedente a <time2>. Controllo non riuscito

  • Causa radice: questo errore si verifica quando i certificati scadono a causa di una mancata corrispondenza temporale tra il computer client e la macchina virtuale (o il server ESXi). Uno di essi non è abilitato per NTP.
  • Soluzione:
    1. Controllare se l'ora della macchina virtuale corrisponde all'ora nel computer usato per la distribuzione di ARB.
    2. Connettere il server ESXi a un server NTP per sincronizzarne l'ora e risolvere il problema.

Errore: il termine 'az' non viene riconosciuto come nome di un cmdlet, di una funzione, di un file di script o di un programma eseguibile. Controllare l'ortografia del nome o se è stato incluso un percorso, verificare che il percorso sia corretto e riprovare

  • Causa radice: l'interfaccia della riga di comando di Az non viene riconosciuta perché la finestra di PowerShell precedente è stata chiusa e non è stata sincronizzata con l'installazione dell'interfaccia della riga di comando di Azure.
  • Soluzione:
    1. Aprire una nuova finestra di PowerShell e passare alla cartella in cui è stato archiviato lo script di onboarding di Arc Resource Bridge.
    2. Eseguire .temp\.env\Scripts\Activate.ps1 per installare Python venv.

Passaggi successivi