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
- Para saber mais sobre como encontrar códigos de erro de implementação e resolver problemas de implementação, veja Localizar códigos de erro.
- Para obter soluções com base no código de erro, veja Resolver erros comuns de implementação do Azure.
- Para obter uma introdução à localização do código de erro, veja Início Rápido: Resolver problemas de implementações JSON do modelo arm ou Início Rápido: Resolver problemas de implementações de ficheiros bicep.