Azure Arc VM 管理のトラブルシューティング

[アーティクル]
02/07/2024

適用対象: Azure Stack HCI バージョン 23H2

この記事では、Azure Stack HCI クラスターでログを収集し、Azure Arc 仮想マシン (VM) に関する問題のトラブルシューティングを行う方法に関するガイダンスを提供します。また、Azure Arc VM 管理に現在存在する制限事項と既知の問題の一覧も示します。

ログの収集

ログを収集して、Azure Stack HCI システムの Arc VM に関する問題を特定してトラブルシューティングできます。 Microsoft サポートに問い合わせる前に、これらのログを使用して重要な情報を収集してください。

ログ収集用の最新の PowerShell モジュールがあることを確認します。 PowerShell モジュールを更新するには、次のコマンドを実行します。

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

Azure Stack HCI クラスター内の Arc VM のログを収集するには、次のコマンドを実行します。

$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

各値の説明:

$csv_path は、Arc Resource Bridge を作成するために提供されるクラスター共有ボリュームの完全なパスです。
$VMIP_1 は、Arc リソースブリッジ VM の IP アドレスです。
必要に応じて、パラメーターを -logDir 設定して、生成されたログが格納されるディレクトリへのパスを指定します。パスまたはパラメーターを指定しない場合、既定ではログは現在の作業ディレクトリに格納されます。

Azure Arc VM のトラブルシューティング

このセクションでは、Azure Arc VM の管理に関連するエラーと、推奨される解決策について説明します。

ゲスト管理を有効にしようとすると失敗する

コマンドを実行してゲスト管理を有効にしようとすると、次のエラーが表示されます。

エラー：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

上記のエラーは、この VM に対してマネージド ID が作成されなかったためです。ゲスト管理を有効にするには、システム割り当てマネージド ID が必要です。

解決策:

次の手順に従って、この VM に対してマネージド ID が作成されていないことを確認し、システム割り当てマネージド ID を有効にします。

Azure portalで、VM に移動します。 [概要] ページに移動します。 [ プロパティ ] タブの [ 構成] で、[ ゲスト管理 ] が [無効] と表示されます。右上隅にある [JSON ビュー ] を選択します。
パラメーターの下 Identity に、 type がとして None表示されます。
マネージド ID を作成するには、RDP 経由で Azure Stack HCI サーバーに接続します。次のコマンドを実行します。
```
az extension add --name connectedmachine
```

接続されたマシン CLI 拡張機能がクラスターにインストールされていることを確認します。拡張機能が正常にインストールされたサンプル出力を次に示します。は connectedmachine 、バージョン 0.7.0 がインストールされていることを示します。

[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>
    ```

次のコマンドを実行して、VM にシステムマネージド ID を割り当てます。
```
az connectedmachine update --ids "<ARM ID for the VM>" --set identity.type="SystemAssigned"
```
Azure portalに移動し、[概要] ページを参照します。 JSON ビューは、システムマネージド ID が VM に割り当てられていることを示す必要があります。

Azure CLI のインストールが認識されない

インストール後に環境が Azure CLI を認識できない場合は、次のコードブロックを実行して、Azure CLI のインストールパスを環境パスに追加します。

        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"
        }

次の手順

Azure Arc VM の管理に関する FAQ