Risolvere i problemi relativi alla gestione delle macchine virtuali di Azure Arc

Articolo
02/07/2024

Si applica a: Azure Stack HCI, versione 23H2

Questo articolo fornisce indicazioni su come raccogliere i log e risolvere i problemi relativi alle macchine virtuali di Azure Arc nel cluster Azure Stack HCI. Elenca anche le limitazioni e i problemi noti attualmente esistenti con la gestione delle macchine virtuali di Azure Arc.

Raccogli registri

È possibile raccogliere i log per identificare e risolvere i problemi relativi alle macchine virtuali Arc nel sistema Azure Stack HCI. Usare questi log per raccogliere informazioni chiave prima di contattare il supporto tecnico Microsoft per ulteriori informazioni.

Assicurarsi di avere il modulo powerShell più recente per la raccolta log. Per aggiornare il modulo di PowerShell, eseguire il comando seguente:

#Update the PowerShell module
Install-Module -Name ArcHci -Force -Confirm:$false -SkipPublisherCheck -AcceptLicense

Per raccogliere i log per le macchine virtuali Arc nel cluster Azure Stack HCI, eseguire il comando seguente:

$csv_path="<input-from-admin>"
$VMIP_1="<input-from-admin>"
az login --use-device-code
Get-ArcHCILogs -workDirectory $csv_path\ResourceBridge -kvaTokenPath $csv_path\ResourceBridge\kvatoken.tok -ip $VMIP_1

dove:

$csv_path è il percorso completo del volume condiviso del cluster fornito per la creazione di Arc Resource Bridge.
$VMIP_1 è l'indirizzo IP della macchina virtuale Arc Resource Bridge.
Facoltativamente, impostare il -logDir parametro per specificare il percorso della directory in cui vengono archiviati i log generati. Se non si specifica il percorso o il parametro, per impostazione predefinita i log vengono archiviati nella directory di lavoro corrente.

Risolvere i problemi relativi alle macchine virtuali di Azure Arc

Questa sezione descrive gli errori correlati alla gestione delle macchine virtuali di Azure Arc e alle relative risoluzioni consigliate.

Errore durante il tentativo di abilitare la gestione guest

Quando si tenta di eseguire il comando per abilitare la gestione guest, viene visualizzato l'errore seguente:

Errore:Deployment failed. Correlation ID: 5d0c4921-78e0-4493-af16-dffee5cbf9d8. VM Spec validation failed for guest agent provisioning: Invalid managed identity. A system-assigned managed identity must be enabled in parent resource: Invalid Configuration

L'errore precedente è dovuto al fatto che l'identità gestita non è stata creata per questa macchina virtuale. L'identità gestita assegnata dal sistema è necessaria per abilitare la gestione guest.

Risoluzione:

Seguire questa procedura per verificare che l'identità gestita non venga creata per questa macchina virtuale e quindi abilitare l'identità gestita assegnata dal sistema.

Nella portale di Azure passare alla macchina virtuale. Passare alla pagina Panoramica . Nella scheda Proprietà , in Configurazione, la gestione guest deve essere visualizzata come Disabilitata. Selezionare la visualizzazione JSON nell'angolo superiore destro.
In parametro Identity , l'oggetto type deve essere visualizzato come None.
Per creare un'identità gestita, connettersi al server Azure Stack HCI tramite RDP. Eseguire il comando seguente:
```
az extension add --name connectedmachine
```

Verificare che l'estensione dell'interfaccia della riga di comando del computer connesso sia installata nel cluster. Ecco un output di esempio con l'estensione installata correttamente. Indica connectedmachine che la versione 0.7.0 è installata.

[v-hostl]: PS C:\Clusterstorage\lnfrastructure_l\ArcHci> az version
{
"azure-cli": "2.53.0",
"azure-cli-core": "2.53.0",
"azure-cli-telemetry": "1.1.0",
"extensions": {
    "akshybrid": "0.1.1",
    "arcappliance"^ "1.0.2”,
    "connectedk8s": "1.5.4",
    "connectedmachine": "0.7.0",
    "customlocation": "0.1.3",
    "hybridaks": "0.2.4",
    "k8s-extension": "1.4.5",
    "stack-hci-vm": “0.1.8"
    }
}
[v-hostl]: PS C:\ClusterStorage\Infrastructure_l\ArcHci>
    ```

Eseguire il comando seguente per assegnare un'identità gestita dal sistema alla macchina virtuale.
```
az connectedmachine update --ids "<ARM ID for the VM>" --set identity.type="SystemAssigned"
```
Passare alla portale di Azure e passare alla pagina Panoramica. La visualizzazione JSON deve indicare che l'identità gestita del sistema è ora assegnata alla macchina virtuale.

L'installazione dell'interfaccia della riga di comando di Azure non viene riconosciuta

Se l'ambiente non riconosce l'interfaccia della riga di comando di Azure dopo l'installazione, eseguire il blocco di codice seguente per aggiungere il percorso di installazione dell'interfaccia della riga di comando di Azure al percorso dell'ambiente.

        if ( -not( $env:PATH -like '*C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\wbin*') ) {
            $env:PATH += "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\wbin;"
            Write-Host "Updated path $env:PATH"
        }

Passaggi successivi

Domande frequenti sulla gestione delle macchine virtuali di Azure Arc