Usar o portal do Azure para exportar um modelo

Artigo
03/20/2024

Para ajudar na criação de modelos do Azure Resource Manager, você pode exportar um modelo de recursos existentes. O modelo exportado ajuda a entender a sintaxe JSON e as propriedades que implantam seus recursos. Para automatizar implantações futuras, comece com o modelo exportado e modifique-o para seu cenário. O processo de modelo de exportação tenta criar um modelo utilizável. No entanto, a maioria dos modelos exportados exige algumas modificações antes de serem usados para implantar recursos do Azure.

O Resource Manager permite que você escolha um ou mais recursos para exportar para um modelo. Você pode focar nos recursos exatos dos quais precisa no modelo.

Este artigo mostra como exportar modelos pelo portal. Para obter outras opções, confira:

Escolha a opção de exportação correta

Há duas maneiras de exportar um modelo:

Exportação do grupo de recursos ou do recurso. Essa opção gera um novo modelo com base nos recursos existentes. O modelo exportado é um "instantâneo" do estado atual do grupo de recursos. Você pode exportar um grupo de recursos inteiro ou recursos específicos dentro desse grupo de recursos.
Salvar do histórico. Essa opção recupera uma cópia exata de um modelo usado para implantação. Você especifica a implantação do histórico de implantação.

Os modelos exportados têm qualidades diferentes, dependendo da opção escolhida.

De grupo de recursos ou de recurso	Do histórico
O modelo é gerado automaticamente. Você provavelmente vai querer melhorar o código antes de implantá-lo.	O modelo é uma cópia exata da criada pelo autor do modelo. Ele está pronto para ser reimplantado sem nenhuma alteração.
O modelo é um instantâneo do estado atual dos recursos. Ele inclui quaisquer alterações manuais que foram feitas após a implantação.	O modelo mostra apenas o estado dos recursos no momento da implantação. As alterações manuais feitas após a implantação não são incluídas.
Você pode selecionar quais recursos de um grupo de recursos para exportar.	Todos os recursos de uma implantação específica estão incluídos. Você não pode escolher um subconjunto desses recursos ou incluir recursos que foram adicionados em um momento diferente.
O modelo inclui todas as propriedades para os recursos, incluindo algumas propriedades que normalmente não seriam definidas durante a implantação. Talvez você queira remover ou limpar essas propriedades antes de reutilizar o modelo.	O modelo inclui apenas as propriedades necessárias para a implantação. O modelo é mais esparso e mais fácil de ler.
O modelo provavelmente não inclui todos os parâmetros necessários para reutilização. A maioria dos valores de propriedade é codificada no modelo. Para reimplantar o modelo em outros ambientes, você precisa adicionar parâmetros que aumentem a capacidade de configurar os recursos. Você pode desmarcar Incluir parâmetros para que você possa criar seus próprios parâmetros.	O modelo inclui parâmetros que facilitam a reimplantação em ambientes diferentes.

Exporte o modelo de um grupo de recursos quando:

Você precisa capturar alterações para recursos que foram feitos após a implantação original.
Você vai querer escolher quais recursos são exportados.
Os recursos não foram criados com um modelo.

Exportar o modelo a partir do histórico de implantações quando:

Você vai querer um modelo fácil de reutilizar.
Você não precisa incluir as alterações feitas após a implantação original.

Limitações

Não há garantia de que a exportação seja bem-sucedida. A exportação não é uma maneira confiável de transformar recursos pré-existentes em modelos utilizáveis na produção. É melhor criar recursos do zero usando o arquivo Bicep escrito à mão, o modelo do ARM ou o terraform.

Ao exportar de um grupo de recursos ou recurso, o modelo exportado é gerado a partir dos esquemas publicados para cada tipo de recurso. Pode acontecer de o esquema não ter a versão mais recente para um tipo de recurso. Verifique o modelo exportado para ver se ele inclui as propriedades das quais você precisa. Se necessário, edite o modelo exportado para usar a versão da API necessária.

Alguns parâmetros de senha podem estar ausentes dos modelos exportados. Você precisa verificar a referência do modelo e adicionar manualmente esses parâmetros antes de usar os modelos para implantar recursos.

O recurso de exportação de modelo não dá suporte à exportação de recursos do Azure Data Factory. Para saber mais sobre como você pode exportar recursos do Data Factory, consulte Copiar ou clonar um data factory no Azure Data Factory.

Para exportar recursos criados por meio do modelo de implantação clássico, você deve migrá-los para o modelo de implantação do Resource Manager.

Se, ao exportar um modelo, você receber um aviso dizendo que um tipo de recurso não foi exportado, você ainda poderá descobrir as propriedades desse recurso. Para propriedades de recursos, veja a referência do modelo. Você também pode dar uma olhada no API REST do Azure para o tipo de recurso específico.

O grupo de recursos para o qual você cria o modelo exportado tem um limite de 200 recursos. Se você tentar exportar um grupo de recursos que tenha mais de 200 recursos, a mensagem de erro Export template is not supported for resource groups more than 200 resources será exibida.

Exportar modelo de um grupo de recursos

Para exportar um ou mais recursos de um grupo de recursos:

Selecione o grupo de recursos que contém os recursos que deseja exportar.
Selecione um ou mais recursos marcando as caixas de seleção. Para selecionar todos, marque a caixa de seleção à esquerda de Nome. O item de menu Exportar modelo só fica habilitado depois que você seleciona pelo menos um recurso.

Na captura de tela, somente a conta de armazenamento está selecionada.
Selecione Exportar modelo.
O modelo exportado será exibido e estará disponível para download e implantação.

A opção Incluir parâmetros vem selecionada por padrão. Quando selecionado, todos os parâmetros do modelo são incluídos quando o modelo é gerado. Se você quiser criar seus próprios parâmetros, não marque a caixa de seleção para incluí-los.

Exportar modelo de um recurso

Para exportar um recurso:

Selecione o grupo de recursos que contém o recurso que você deseja exportar.
Selecione o recurso que deseja exportar para abri-lo.
Para esse recurso, selecione Exportar modelo no painel esquerdo.
O modelo exportado será exibido e estará disponível para download e implantação. O modelo contém apenas o recurso único. A opção Incluir parâmetros vem selecionada por padrão. Quando selecionado, todos os parâmetros do modelo são incluídos quando o modelo é gerado. Se você quiser criar seus próprios parâmetros, não marque a caixa de seleção para incluí-los.

Baixar modelo antes da implantação

O portal tem a opção de baixar um modelo antes de implantá-lo. Essa opção não está disponível por meio do PowerShell ou da CLI do Azure.

Selecione o serviço do Azure que você deseja implantar.
Preencha os valores do novo serviço.
Depois de passar na validação, mas antes de iniciar a implantação, selecione Baixar um modelo para automação.
O modelo será exibido e estará disponível para download e implantação.

Exportar modelo após a implantação

Você pode exportar o modelo que foi usado para implantar recursos existentes. O modelo que você recebe é exatamente aquele que foi usado para implantação.

Selecione o grupo de recursos que você quer exportar.
Selecione o link em Implantações.
Selecione uma das implantações do histórico de implantações.
Selecionar Modelo. O modelo usado para esta implantação é exibido e está disponível para download.

Próximas etapas

Saiba como exportar modelos com a CLI do Azure, Azure PowerShellou API REST.
Para saber mais sobre a sintaxe do modelo do Resource Manager, confira Noções básicas de estrutura e sintaxe dos modelos do Azure Resource Manager.
Para saber como desenvolver modelos, veja os tutoriais passo a passo.