O que é a solução de problemas de implantação?

Ao implantar recursos do Azure com arquivos Bicep ou modelos do ARM (Azure Resource Manager), você poderá receber um erro. Há ferramentas de solução de problemas disponíveis para ajudá-lo a resolver erros de sintaxe antes da implantação. Você pode obter mais informações sobre códigos de erro e erros de implantação no portal do Azure, no Azure PowerShell e na CLI do Azure. Esta documentação ajuda você a encontrar soluções para solucionar erros.

Tipos de erro

Erros de validação ocorrem antes do início de uma implantação e são causados pela sintaxe incorreta que pode ser identificada por um editor de código como o Visual Studio Code. Por exemplo, um nome de propriedade com erro de ortografia ou uma função para a qual falta um argumento.

Erros de validação de pré-vôo ocorrem quando um comando de implantação é executado, mas os recursos não são implantados no Azure. Por exemplo, se um valor de parâmetro incorreto for usado, o comando de implantação retornará uma mensagem de erro.

Os erros de implantação só podem ser determinados ao tentar a implantação e interagir com seu ambiente do Azure. Por exemplo, uma máquina virtual (VM) requer uma NIC (placa de adaptador de rede). Se a NIC não existir quando a VM for implantada, você receberá um erro de implantação.

Ferramentas de solução de problemas

Há várias ferramentas de solução de problemas disponíveis para resolver erros.

Erros de sintaxe

Para ajudar a identificar erros de sintaxe antes de uma implantação, use a versão mais recente do Visual Studio Code. Instale a versão mais recente da extensão para templates Bicep ou ARM.

• Bíceps
• Ferramentas do Azure Resource Manager

Para seguir as práticas recomendadas para desenvolver seus modelos de implantação, use as seguintes ferramentas:

• Linter do Bicep
• Kit de ferramentas de teste de modelo do ARM

Provedor de recursos e versão da API

Para solucionar problemas de implantações, é útil saber mais sobre as propriedades ou versões de API de um provedor de recursos. Para obter mais informações, consulte Definir recursos com modelos Bicep e ARM.

Detalhes do erro

Ao implantar, você pode encontrar a causa de erros do portal do Azure no log de Implantações ou Atividades de um grupo de recursos. Se você estiver usando o Azure PowerShell, use comandos como Get-AzResourceGroupDeploymentOperation e Get-AzActivityLog. Para CLI do Azure, use comandos como az deployment operation group e az monitor activity-log list.

Próximas etapas

• Para saber mais sobre como encontrar códigos de erro de implantação e solucionar problemas de implantação, consulte Localizar códigos de erro.
• Para obter soluções com base no código de erro, consulte Solucionar problemas de erros comuns de implantação do Azure.
• Para obter uma introdução à localização do código de erro, consulte Início Rápido: solução de problemas de implantações JSON do modelo do ARM ou Início Rápido: solucionar problemas de implantações de arquivos Bicep.