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