Che cos'è la risoluzione dei problemi di distribuzione?

  • Articolo

Quando si distribuiscono risorse di Azure con file Bicep o modelli di Azure Resource Manager (modelli di ARM), è possibile che venga visualizzato un errore. Sono disponibili strumenti per la risoluzione dei problemi che consentono di risolvere gli errori di sintassi prima della distribuzione. È possibile ottenere altre informazioni sui codici di errore e sugli errori di distribuzione dal portale di Azure, da Azure PowerShell e dall'interfaccia della riga di comando di Azure. Questa documentazione consente di trovare soluzioni per la risoluzione degli errori.

Tipi di errore

Gli errori di convalida si verificano prima dell'inizio di una distribuzione e sono causati da una sintassi errata che può essere identificata da un editor di codice come Visual Studio Code. Ad esempio, un nome di proprietà con errori di ortografia o una funzione cui manca un argomento.

Gli errori di convalida preliminare si verificano quando viene eseguito un comando di distribuzione, ma le risorse non vengono distribuite in Azure. Ad esempio, se viene usato un valore di parametro non corretto, il comando di distribuzione restituisce un messaggio di errore.

Gli errori di distribuzione possono essere determinati solo provando la distribuzione e interagendo con l'ambiente Azure. Ad esempio, una macchina virtuale (VM) richiede una scheda di interfaccia di rete (NIC). Se la scheda di interfaccia di rete non esiste quando viene distribuita la macchina virtuale, viene visualizzato un errore di distribuzione.

Strumenti per la risoluzione dei problemi

Sono disponibili diversi strumenti di risoluzione dei problemi per risolvere gli errori.

Errori di sintassi

Per identificare gli errori di sintassi prima di una distribuzione, usare la versione più recente di Visual Studio Code. Installare la versione più recente dell'estensione per Bicep o modelli di ARM.

Per seguire le procedure consigliate per lo sviluppo di modelli di distribuzione, usare gli strumenti seguenti:

Provider di risorse e versione dell'API

Per risolvere i problemi relativi alle distribuzioni, è utile conoscere le proprietà o le versioni API di un provider di risorse. Per altre informazioni, vedere Definire le risorse con modelli Bicep e ARM.

Dettagli errore

Quando si esegue la distribuzione, è possibile trovare la causa degli errori del portale di Azure in Distribuzioni di un gruppo di risorse o Log attività. Se si usa Azure PowerShell, usare comandi come Get-AzResourceGroupDeploymentOperation e Get-AzActivityLog. Per l'interfaccia della riga di comando di Azure, usare comandi come az deployment operation group e az monitor activity-log list.

Passaggi successivi