Entender os modos de implantação

Concluído

O Azure Resource Manager dá suporte a dois modos de implantação: incremental e completo.

Modo incremental

O modo de implantação padrão é o incremental. Nesse modo, o Resource Manager não exclui nada. Se os recursos existirem no grupo de recursos, mas não forem especificados no modelo, o Resource Manager não os alterará. Os recursos no modelo serão adicionados ao grupo de recursos se eles ainda não existirem e, se existirem, o Resource Manager os atualizará para a configuração no modelo.

Modo completo

Você precisa solicitar explicitamente que a sua implantação seja executada no modo completo. Quando você usa esse modo, os recursos que existem no Azure, mas que não são especificados no modelo, são excluídos. O modo completo não exclui todos os recursos no seu grupo de recursos. Alguns tipos de recursos são isentos.

Cuidado

Quando você executar o comando no modo completo, todos os seus recursos serão removidos se não forem definidos no arquivo de modelo.

No Bicep, você pode consultar um recurso existente usando a palavra-chave existing. Referir-se a um recurso dessa forma não impede que ele seja excluído durante uma implantação no modo completo. Você precisa defini-lo como um recurso completo.

Quando devo usar o modo completo?

Pode parecer uma ideia estranha permitir que o Azure exclua os seus recursos dessa forma. No entanto, há um bom motivo pelo qual talvez você queira considerar essa opção. Se toda a sua infraestrutura estiver definida em modelos, utilizar o modo completo sempre que implantar garante que nenhum recurso errôneo seja deixado para trás. Em outras palavras, isso ajuda a evitar um descompasso de configuração no seu ambiente.

Se tiver certeza de que o que está no arquivo de modelo constitui o estado completo da sua implantação, utilize esse modo. Se você usar ferramentas como a CLI do Azure ou o PowerShell para atualizar o estado gradualmente, o modo incremental será a melhor opção.

Escopos de implantação

O modo completo está disponível quando você implanta em um grupo de recursos. Se você utilizar modelos para implantar recursos em uma assinatura, um grupo de gerenciamento ou um locatário, não poderá usar o modo completo.