O que é a resolução de problemas de implementação?

Quando implementa recursos do Azure com ficheiros Bicep ou modelos de Resource Manager do Azure (modelos arm), poderá obter um erro. Existem ferramentas de resolução de problemas disponíveis para o ajudar a resolver erros de sintaxe antes da implementação. Pode obter mais informações sobre códigos de erro e erros de implementação da portal do Azure, Azure PowerShell e CLI do Azure. Esta documentação ajuda-o a encontrar soluções para resolver erros.

Tipos de erro

Os erros de validação ocorrem antes do início de uma implementação e são causados por uma 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 ortográfico ou uma função com um argumento em falta.

Os erros de validação de pré-voo ocorrem quando um comando de implementação é executado, mas os recursos não são implementados no Azure. Por exemplo, se for utilizado um valor de parâmetro incorreto, o comando de implementação devolve uma mensagem de erro.

Os erros de implementação só podem ser determinados ao tentar implementar e interagir com o seu ambiente do Azure. Por exemplo, uma máquina virtual (VM) requer uma placa de interface de rede (NIC). Se o NIC não existir quando a VM é implementada, obtém um erro de implementação.

Ferramentas de resolução de problemas

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

Erros de sintaxe

Para ajudar a identificar erros de sintaxe antes de uma implementação, utilize a versão mais recente do Visual Studio Code. Instale a versão mais recente da extensão para modelos bicep ou ARM.

Para seguir as melhores práticas para desenvolver os seus modelos de implementação, utilize as seguintes ferramentas:

Fornecedor de recursos e versão da API

Para resolver problemas de implementações, é útil saber mais sobre as propriedades ou versões de API de um fornecedor de recursos. Para obter mais informações, veja Definir recursos com modelos bicep e ARM.

Detalhes do erro

Ao implementar, pode encontrar a causa dos erros do portal do Azure no registo de Implementações ou Atividade de um grupo de recursos. Se estiver a utilizar Azure PowerShell, utilize comandos como Get-AzResourceGroupDeploymentOperation e Get-AzActivityLog. Para a CLI do Azure, utilize comandos como az deployment operation group e az monitor activity-log list.

Passos seguintes