Résoudre les problèmes liés aux machines virtuelles locales Azure activées par Azure Arc

S’applique à : déploiements hyperconvergés d’Azure Local

Cet article explique comment collecter des journaux et résoudre les problèmes liés aux machines virtuelles locales Azure activées par Azure Arc. Il répertorie également les limitations actuelles et les problèmes connus liés à la gestion des machines virtuelles locales Azure, ainsi que les résolutions recommandées.

Le réseau logique d’infrastructure n’est pas visible dans le portail Azure

Problème: Pour la version 2601 et ultérieure, le réseau logique d’infrastructure créé pendant le déploiement local Azure n’est pas visible dans le portail Azure.

Résolution: Si vous ne voyez pas le réseau logique d’infrastructure après le déploiement de la solution version 2601 ou la mise à jour, ce réseau apparaît lorsque vous tentez une mise à jour de solution ultérieure.

Si vos machines virtuelles locales Azure rencontrent des problèmes que vous ne pouvez pas résoudre, exécutez l’outil de support pour les problèmes de composant d’infrastructure locale Azure avant de déposer une demande de support. Si les problèmes persistent, utilisez les instructions fournies dans cet article pour résoudre les problèmes liés aux machines virtuelles locales Azure.

La propriété n’est pas prise en charge pour cette opération

Erreur :

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.

Cause :

Cette erreur se produit lorsque la fonctionnalité que vous essayez d’utiliser n’est pas disponible pour la version logicielle en cours d’exécution sur votre instance Locale Azure. Ce problème peut se produire si la version logicielle de votre cluster est obsolète ou si la fonctionnalité a été introduite dans une version ultérieure.

Résolution:

Pour résoudre ce problème, mettez à jour votre instance locale Azure vers la dernière version. Pour plus d’informations, consultez Update via PowerShell ou Update via le portail Azure.

L’extension de cluster ne prend pas en charge le type de ressource

Erreur :

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>'].

Cause :

Cette erreur se produit lorsque la fonctionnalité que vous essayez d’utiliser n’est pas disponible pour la version logicielle en cours d’exécution sur votre instance Locale Azure. Ce problème peut se produire si la version logicielle de votre cluster est obsolète ou si la fonctionnalité a été introduite dans une version ultérieure.

Résolution:

Pour résoudre ce problème, mettez à jour votre instance locale Azure vers la dernière version. Pour plus d’informations, consultez Update via PowerShell ou Update via le portail Azure.

Impossible de sélectionner une image pour les machines virtuelles de lancement approuvées

Le lancement fiable pour les machines virtuelles locales Azure prend actuellement en charge uniquement un ensemble sélectionné d’images d'Azure Marketplace (Place de marché Azure). Pour obtenir la liste des images prises en charge, consultez Images du système d’exploitation invité. Lorsque vous créez une machine virtuelle de lancement approuvé dans le portail Azure, la liste déroulante Image affiche uniquement les images prises en charge par le lancement approuvé. La liste déroulante Image s’affiche vide si vous sélectionnez une image non prise en charge, y compris une image personnalisée. La liste s’affiche également vide si aucune des images disponibles sur votre système local Azure n’est prise en charge par le lancement fiable.

Échec lors de la tentative d’activation de la gestion des invités

Lorsque vous essayez d’exécuter la commande pour activer la gestion des invités, vous voyez l’erreur suivante :

Erreur: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

Cette défaillance se produit, car l’identité managée n’existe pas pour cette machine virtuelle. Vous avez besoin d’une identité managée affectée par le système pour activer la gestion des invités.

Résolution:

Suivez ces étapes pour vérifier que l’identité managée n’existe pas pour cette machine virtuelle, puis activez l’identité managée affectée par le système.

  1. Dans la Portail Azure, accédez à la machine virtuelle. Accédez à la page Vue d’ensemble. Sous l’onglet Propriétés , sous Configuration, la gestion des invités s’affiche comme Désactivée. Sélectionnez l’affichage JSON dans le coin supérieur droit.

    Capture d’écran montrant comment accéder à la vue JSON.

  2. Sous le paramètre Identity, le type apparaît sous forme de None.

    Capture d’écran de la vue JSON indiquant que l’identité managée est absente.

  3. Pour créer une identité managée, connectez-vous à la machine locale Azure via le protocole RDP (Remote Desktop Protocol). Exécutez la commande suivante :

    az extension add --name connectedmachine
    
  4. Vérifiez que l’extension CLI de l’ordinateur connecté est installée sur le système. Voici un exemple de sortie avec l’extension correctement installée. Indique connectedmachine que la version 0.7.0 est installée.

    [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. Exécutez la commande suivante pour affecter une identité managée système à la machine virtuelle.

    az connectedmachine update --ids "<Resource Manager ID for the VM>" --set identity.type="SystemAssigned"
    
  6. Accédez au portail Azure et accédez à la page Vue d’ensemble . La Vue JSON indique que l’identité managée du système est maintenant affectée à la machine virtuelle.

    Capture d’écran de la vue JSON lorsque l’identité managée est activée.

Échec du déploiement d’une image de machine virtuelle à partir d’un compte de stockage

Vous voyez l’erreur suivante lors de la tentative de déploiement d’une image de machine virtuelle à partir d’un compte de stockage sur votre local Azure :

Erreur:{"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"}

Vous voyez également cette erreur :

Erreur:{"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"}

L’échec se produit, car l’utilisateur qui crée l’image n’a pas les autorisations appropriées pour accéder à l’image à partir du compte de stockage. L’utilisateur doit avoir le rôle Contributeur aux données Blob du stockage sur le compte de stockage que vous utilisez pour l’image. Pour plus d’informations, consultez Affecter des rôles Azure pour accéder aux données BLOB.

Résolution:

Ajoutez le rôle Contributeur aux données Blob du stockage à l’utilisateur qui doit créer une image à partir de ce compte de stockage. Après avoir ajouté le rôle, réessayez de déployer l’image.

Vous pouvez également voir l’erreur suivante lors de la tentative de déploiement d’une image de machine virtuelle à partir d’un compte de stockage :

Erreur:{"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":""}}]}

Cet échec survient parce que le type d'objet blob n'est pas correct dans le compte de stockage. L’image doit être de page blob type.

Résolution:

Chargez l’image dans votre compte page blob format de stockage et réessayez de déployer l’image.

Vérifiez que vous disposez des autorisations appropriées et que l’objet blob est au format correct. Pour plus d’informations, consultez Ajouter une image de machine virtuelle à partir du compte stockage Azure.

Échec du déploiement d’une machine virtuelle locale Azure

Vous voyez l’erreur suivante lors de la tentative de déploiement d’une machine virtuelle locale Azure :

Erreur:{"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."}

Cet échec se produit parce que l’objet SystemAssigned d’identité managée n’est pas sous le Microsoft.HybridCompute/machines type de ressource.

Résolution:

Vérifiez dans votre modèle de déploiement que :

  • L’objet d’identité managée SystemAssigned est sous le type de ressource Microsoft.HybridCompute/machines et non sous le type de ressource Microsoft.AzureStackHCI/VirtualMachineInstances.

  • Le modèle de déploiement correspond à l’exemple de modèle fourni. Pour plus d’informations, consultez l’exemple de modèle dans Créer des machines virtuelles locales Azure activées par Azure Arc.

L’installation d’Azure CLI n’est pas reconnue

Si votre environnement ne reconnaît pas Azure CLI après l’avoir installé, exécutez le bloc de code suivant pour ajouter le chemin d’installation d’Azure CLI au chemin d’accès de l’environnement.

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

Le message « Windows a créé un fichier de pagination temporaire » s’affiche au démarrage

Erreur :

Lorsque vous déployez une machine virtuelle locale Azure à l’aide de SQL Server 2022 sur les images de la Place de marché Azure Windows Server 2022 (Standard ou Entreprise), vous pouvez voir l’avertissement suivant au démarrage :

Windows a créé un fichier de pagination temporaire...

Résolution:

Pour résoudre ce problème, effectuez les étapes suivantes :

  1. Sélectionnez OK dans la fenêtre contextuelle d’avertissement. Ou, accédez aux propriétés système>avancées>de performances>paramètres pour ouvrir la fenêtre Options de performances.

  2. Dans la fenêtre Options de performances , sélectionnez Modifier sous la section Mémoire virtuelle .

    Capture d’écran de la fenêtre Options de performances mettant en surbrillance le bouton Modifier.

  3. Dans la fenêtre Mémoire virtuelle , sélectionnez Taille gérée par le système.  Vérifiez également que la case à cocher Gérer automatiquement la taille du fichier de pagination pour tous les lecteurs est désactivée.

    Capture d’écran de la fenêtre Mémoire virtuelle montrant les options permettant de configurer la taille du fichier de pagination pour chaque lecteur.

  4. Sélectionnez Définir, puis ok pour appliquer les modifications.

  5. Redémarrez la machine virtuelle. Après le redémarrage, le message d’avertissement ne doit pas apparaître.

Échec du déploiement de ressources en raison d’un espace disque insuffisant sur le premier chemin de stockage

Erreur :

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

Cause :

Si vous ne spécifiez pas de chemin de stockage pendant le déploiement, le système place automatiquement les ressources sur le premier chemin de stockage, même si le cluster a des chemins de stockage supplémentaires. Ce comportement peut entraîner un espace disque insuffisant sur le premier chemin de stockage, même lorsque d’autres chemins de stockage ont toujours une capacité disponible.

Résolution:

Lorsque vous créez une machine virtuelle, un disque de données ou une image, choisissez manuellement un chemin de stockage.

Dans le portail Azure, lorsque vous créez une machine virtuelle, attachez des disques de données ou créez une image, sélectionnez l’option Choisir manuellement pour le chemin de stockage. Ensuite, sélectionnez un chemin de stockage dans la liste disponible pour éviter le placement automatique sur le premier chemin de stockage.