Azure Arc で有効になっている Azure ローカル仮想マシンのトラブルシューティング

適用対象: Azure Local の Hyperconverged デプロイ

この記事では、ログを収集し、Azure Arc で有効になっている Azure Local Virtual Machines に関する問題のトラブルシューティングを行う方法について説明します。また、Azure ローカル VM 管理に関する現在の制限事項と既知の問題と、推奨される解決策も示します。

Arc リソース ブリッジ VM の高い推定メモリ需要

問題:

Hyper-V Manager または Windows Admin Center では、Azure Arc リソース ブリッジ VM に、割り当てられたメモリよりも大きい推定メモリ需要値が表示される場合があります。

原因:

Arc リソース ブリッジは、コンテナー化されたワークロードを実行する Linux VM です。 Hyper-V 推定メモリ需要は、メモリ割り当てとページ フォールト動作に基づく控えめな見積もりです。 これは、VM 内でアクティブに使用されるメモリの測定値ではありません。 Linux キャッシュとコンテナーの割り当てパターンでは、VM にメモリ不足がない場合でも、高い見積もりが発生する可能性があります。 値が大きいだけでは、過剰なメモリ使用量、メモリ リーク、パフォーマンスの問題は示されません。

解決策:

Arc リソース ブリッジ VM のサイズを変更したり、この値のみに基づいてメモリ設定を変更したりしないでください。 これらの変更を行っても、リソース ブリッジ VM のゲスト内メモリは変更されません。 リソース ブリッジと Azure Local VM 管理が引き続き機能している場合は、アクションは必要ありません。

Arc リソース ブリッジの障害が継続的に発生する場合は、インフラストラクチャ コンポーネントの問題Azure Localサポート ツールを実行します。 問題が解決しない場合は、Microsoft サポート にお問い合わせください。 サポートでは、内部メトリックを確認して、Arc リソース ブリッジ VM で実際のメモリ不足が発生しているかどうかを判断できます。

インフラストラクチャ論理ネットワークが Azure portal に表示されない

問題： バージョン 2601 以降では、Azure ローカル デプロイ中に作成されたインフラストラクチャ論理ネットワークは Azure portal に表示されません。

解像 度： ソリューション バージョン 2601 のデプロイ後または更新後にインフラストラクチャ論理ネットワークが表示されない場合は、後続のソリューション更新を試みると、このネットワークが表示されます。

解決できない問題が Azure ローカル VM で発生する場合は、サポート 要求を提出する前に 、Azure ローカル インフラストラクチャ コンポーネントの問題のサポート ツール を実行してください。 問題が解決しない場合は、この記事に記載されているガイダンスを使用して、Azure ローカル VM のトラブルシューティングをさらに進めてください。

プロパティは、この操作ではサポートされていません

エラー:

Property '<Property Name>' isn't supported for this operation on your Azure Local cluster version. Please update your cluster if you want to set this property for this operation. Please view aka.ms/hciproperties.

原因:

このエラーは、使用しようとしている機能が、Azure Local インスタンスで実行されているソフトウェア バージョンで使用できない場合に発生します。 この問題は、クラスター上のソフトウェア バージョンが古い場合、または機能が新しいバージョンで導入された場合に発生する可能性があります。

解決策:

この問題を解決するには、Azure Local インスタンスを最新バージョンに更新します。 詳細については、「 PowerShell を使用した更新」 または 「Azure portal を使用した更新」を参照してください。

クラスター拡張機能はリソースの種類をサポートしていません

エラー:

The cluster extension '<Cluster Extension Azure Resource Manager ID>' doesn't support resource type 'Microsoft.AzureStackHCI/<Resource Type>'. The currently enabled resource types are '<Supported Resource Type Names>'. Please ensure the 'Microsoft.AzureStackHCI' cluster extension version metadata file supports the resource type. [ClusterExtensionVersion='<Cluster Extension Version>'] [CorrelationId='<Correlation ID>'].

原因:

このエラーは、使用しようとしている機能が、Azure Local インスタンスで実行されているソフトウェア バージョンで使用できない場合に発生します。 この問題は、クラスター上のソフトウェア バージョンが古い場合、または機能が新しいバージョンで導入された場合に発生する可能性があります。

解決策:

この問題を解決するには、Azure Local インスタンスを最新バージョンに更新します。 詳細については、「 PowerShell を使用した更新」 または 「Azure portal を使用した更新」を参照してください。

信頼された起動 VM のイメージを選択できない

現在、Azure ローカル VM の信頼された起動では、一連の Azure Marketplace イメージのみがサポートされています。 サポートされているイメージの一覧については、「 ゲスト オペレーティング システム イメージ」を参照してください。 Azure portal で信頼できる起動 VM を作成すると、[ イメージ ] ドロップダウン リストに、信頼された起動でサポートされているイメージのみが表示されます。 サポートされていない イメージ (カスタム イメージを含む) を選択すると、[イメージ] ドロップダウンが空白で表示されます。 信頼された起動で Azure ローカル システムで使用可能なイメージがサポートされていない場合も、一覧は空白で表示されます。

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

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

エラー: Deployment failed. Correlation ID: aaaa0000-bb11-2222-33cc-444444dddddd. 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 を有効にするには、次の手順に従います。

1. Azure portal で VM に移動します。 Overview ページに移動します。 [ プロパティ ] タブの [ 構成] の下に、[ ゲスト管理 ] が [無効] と表示されます。 右上隅から JSON ビュー を選択します。

   

2. パラメーター Identity 、 type は Noneとして表示されます。

   

3. マネージド ID を作成するには、リモート デスクトップ プロトコル (RDP) 経由で Azure ローカル コンピューターに接続します。 次のコマンドを実行します。

   az extension add --name connectedmachine
   

4. 接続されたマシン 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>
       ```
   

5. 次のコマンドを実行して、システム マネージド ID を VM に割り当てます。

   az connectedmachine update --ids "<Resource Manager ID for the VM>" --set identity.type="SystemAssigned"
   

6. Azure portal に移動し、 Overview ページを参照します。 JSON ビューは、システム マネージド ID が VM に割り当てられていることを示します。

   

ストレージ アカウントから VM イメージをデプロイできない

Azure Local のストレージ アカウントから VM イメージをデプロイしようとすると、次のエラーが表示されます。

エラー: {"code":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=AuthorizationPermissionMismatch) =====\nDescription=, Details: (none)\n","message":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=AuthorizationPermissionMismatch) =====\nDescription=, Details: (none)\n"}

または、次のエラーが表示されます。

エラー: {"code":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=NoAuthenticationInformation) =====\nDescription=, Details: (none)\n","message":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=NoAuthenticationInformation) =====\nDescription=, Details: (none)\n"}

このエラーは、イメージを作成するユーザーがストレージ アカウントからイメージにアクセスするための適切なアクセス許可を持っていないために発生します。 ユーザーには、イメージに使用するストレージ アカウントに対する Storage BLOB データ共同作成者 ロールが必要です。 詳細については、「 Azure ロールの割り当て BLOB データへのアクセス」を参照してください。

解決策:

このストレージ アカウントからイメージを作成する必要があるユーザーに、 Storage BLOB データ共同作成者 ロールを追加します。 ロールを追加したら、イメージのデプロイを再試行します。

ストレージ アカウントから VM イメージをデプロイしようとすると、次のエラーが表示される場合もあります。

エラー: {"code":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=InvalidBlobType) =====\nDescription=The blob type is invalid for this operation.\nRequestId:5e74055f-e01e-0033-66eb-ff9734000000\nTime:2024-09-05T23:32:56.3001852Z, Details: (none)\n","message":"moc-operator galleryimage serviceClient returned an error while reconciling: rpc error: code = Unknown desc = ===== RESPONSE ERROR (ErrorCode=InvalidBlobType) =====\nDescription=The blob type is invalid for this operation.\nRequestId:5e74055f-e01e-0033-66eb-ff9734000000\nTime:2024-09-05T23:32:56.3001852Z, Details: (none)\n","additionalInfo":[{"type":"ErrorInfo","info":{"category":"Uncategorized","recommendedAction":"","troubleshootingURL":""}}]}

このエラーは、ストレージ アカウント内で BLOB の種類が正しくないために発生します。 イメージは page blob 型である必要があります。

解決策:

page blob formatでイメージをストレージ アカウントにアップロードし、イメージのデプロイを再試行します。

適切なアクセス許可があり、BLOB が正しい形式であることを確認します。 詳細については、「 Azure Storage アカウントからの VM イメージの追加」を参照してください。

Azure ローカル VM のデプロイに失敗する

Azure ローカル VM をデプロイしようとすると、次のエラーが表示されます。

エラー: {"code":"ConflictingOperation","message":"Unable to process request 'Microsoft.AzureStackHCI/virtualMachineInstances'. There is already a previous running operation for resource '/subscriptions/<subscription ID>/resourceGroups/<Resource group name>/providers/Microsoft.HybridCompute/machines/<VM name>/providers/Microsoft.AzureStackHCI/virtualMachineInstances/default'. Please wait for the previous operation to complete."}

このエラーは、 SystemAssigned マネージド ID オブジェクトが Microsoft.HybridCompute/machines リソースの種類の下にないために発生します。

解決策:

デプロイ テンプレートで次のことを確認します。

• SystemAssignedマネージド ID オブジェクトはMicrosoft.HybridCompute/machinesリソースの種類の下にあり、Microsoft.AzureStackHCI/VirtualMachineInstancesリソースの種類の下にはありません。

• デプロイ テンプレートは、指定されたサンプル テンプレートと一致します。 詳細については、「 Azure Arc で有効になっている Azure ローカル仮想マシンを作成する」のサンプル テンプレートを参照してください。

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

起動時に "Windows によって一時ページング ファイルが作成されました" というメッセージが表示される

エラー:

Windows Server 2022 Azure Marketplace イメージ (Standard または Enterprise) で SQL Server 2022 を使用して Azure ローカル VM をデプロイすると、起動時に次の警告が表示されることがあります。

Windows で一時ページング ファイルが作成されました...

解決策:

この問題を解決するには、次の手順に従ってください。

1. 警告ポップアップで [OK] を選択します 。 または、 システム プロパティ>Advanced>Performance>Settings に移動して 、[パフォーマンス オプション] ウィンドウを開きます。

2. [パフォーマンス オプション] ウィンドウで、[仮想メモリ] セクションの [変更] を選択します。

   

3. [ 仮想メモリ ] ウィンドウで、[ システム管理サイズ] を選択します。  また、[ すべてのドライブのページング ファイル サイズを自動的に管理する ] チェック ボックスがオフになっていることを確認します。

   

4. [ 設定] を選択し、[ OK] を 選択して変更を適用します。

5. VM を再起動します。 再起動後、警告メッセージは表示されません。

最初のストレージ パスのディスク領域が不足しているため、リソースのデプロイが失敗する

エラー:

The system failed to create <Azure resource name>: There is not enough space on the disk.

原因:

デプロイ時にストレージ パスを指定しない場合、クラスターに追加のストレージ パスがある場合でも、最初のストレージ パスにリソースが自動的に配置されます。 この動作により、他のストレージ パスに使用可能な容量が残っている場合でも、最初のストレージ パスのディスク領域が不足する可能性があります。

解決策:

VM、データ ディスク、またはイメージを作成するときは、ストレージ パスを手動で選択します。

"storageProfile": {
 "vmConfigStoragePathId": "Insert ARM ID of specified storage path"
}

関連する手順

• Azure ローカル VM 管理に関する FAQ