O que é a solução de problemas de implantações?
Ao implantar os recursos do Azure com os arquivos Bicep ou modelos do Azure Resource Manager (modelos do ARM), você pode receber um erro. Há ferramentas de solução de problemas disponíveis para ajudar você 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 do portal do Azure, Azure PowerShell e CLI do Azure. Esta documentação ajuda você a encontrar soluções para solucionar erros.
Tipos de erro
Erros de validação ocorrem antes de uma implantação começar 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 ortografia incorreta ou uma função que está faltando um argumento.
Erros de validação de simulaçã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 pela tentativa de implantação e interação com o ambiente do Azure. Por exemplo, uma VM (máquina virtual) requer uma NIC (placa de interface de rede). Se a NIC não existir quando a VM for implantada, você obterá 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 modelos do Bicep ou do ARM.
Para seguir as melhores práticas para desenvolver seus modelos de implantação, use as seguintes ferramentas:
Provedor de recursos e versão da API
Para solucionar problemas de implantações, é útil saber mais sobre as propriedades de um provedor de recursos ou as versões de API. Para obter mais informações, consulte Definir recursos com o Bicep e a ARM.
Detalhes do erro
Ao implantar, você pode encontrar a causa de erros do portal do Azure em implantações ou no log de atividadesde um grupo de recursos. Case se estiver usando 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 baseadas no código de erro, consulte Solucionar 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.