Partage via


Qu’est-ce que la résolution des problèmes de déploiement ?

Quand vous déployez des ressources Azure avec des fichiers Bicep ou des modèles Azure Resource Manager (ARM), vous pouvez obtenir une erreur. Des outils de dépannage sont disponibles pour vous aider à résoudre les erreurs de syntaxe avant le déploiement. Vous pouvez obtenir un complément d’informations sur les codes d’erreur et les erreurs de déploiement via le portail Azure, Azure PowerShell et Azure CLI. Cette documentation vous aide à trouver des solutions pour résoudre les erreurs.

Types d’erreurs

Les erreurs de validation se produisent avant le début d’un déploiement et sont provoquées par une syntaxe incorrecte que peut identifier un éditeur de code tel que Visual Studio Code. Par exemple, il peut s’agir d’un nom de propriété mal orthographié ou d’un argument manquant dans une fonction.

Les erreurs de validation préalable se produisent quand une commande de déploiement est exécutée, mais que les ressources ne sont pas déployées dans Azure. Par exemple, si une valeur de paramètre incorrecte est utilisée, la commande de déploiement retourne un message d’erreur.

Les erreurs de déploiement ne peuvent être déterminées qu’en tentant le déploiement et en interagissant avec votre environnement Azure. Par exemple, une machine virtuelle nécessite une carte réseau (NIC). Si la carte réseau n’existe pas lorsque la machine virtuelle est déployée, vous obtenez une erreur de déploiement.

Outils de résolution des problèmes

Il est possible de résoudre les erreurs à l’aide des différents outils de résolution des problèmes disponibles.

Erreurs de syntaxe

Pour faciliter l’identification des erreurs de syntaxe avant un déploiement, utilisez la version la plus récente de Visual Studio Code. Installez la dernière version de l’extension pour les modèles Bicep ou ARM.

Pour suivre les bonnes pratiques en matière de développement de modèles de déploiement, utilisez les outils suivants :

Fournisseur de ressources et version d’API

Pour dépanner les déploiements, il est utile d’en savoir plus sur les propriétés d’un fournisseur de ressources ou les versions de l’API. Pour plus d’informations, consultez Définir des ressources à l’aide de Bicep et de modèles ARM.

Détails de l’erreur

Lorsque vous effectuez un déploiement, vous pouvez trouver la cause des erreurs à partir du portail Azure dans les section Déploiements ou Journal d’activité d’un groupe de ressources. Si vous utilisez Azure PowerShell, utilisez des commandes telles que Get-AzResourceGroupDeploymentOperation et Get-AzActivityLog. Pour Azure CLI, utilisez des commandes telles que az deployment operation group et az monitor activity-log list.

Étapes suivantes