Usar o portal do Azure para exportar um modelo
Para ajudar na criação de modelos do Azure Resource Manager, você pode exportar um modelo de recursos existentes. O modelo exportado ajuda você 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 requer algumas modificações antes de poderem ser usados para implantar recursos do Azure.
O Resource Manager permite que você escolha um ou mais recursos para exportar para um modelo. Você pode se concentrar exatamente nos recursos necessários no modelo.
Este artigo mostra como exportar modelos através do portal. Para outras opções, consulte:
- Exportar modelo com a CLI do Azure
- Exportar modelo com o Azure PowerShell
- Exportação da API REST do grupo de recursos e exportação da API REST do histórico de implantação.
Escolha a opção de exportação certa
Existem duas formas de exportar um modelo:
Exportar do grupo de recursos ou recurso. Esta opção gera um novo modelo a partir de 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.
Salve da história. Esta opção recupera uma cópia exata de um modelo usado para implantação. Você especifica a implantação a partir do histórico de implantação.
Dependendo da opção escolhida, os modelos exportados têm qualidades diferentes.
| Do grupo de recursos ou recurso | Da história |
|---|---|
| O modelo é gerado automaticamente. Você provavelmente vai querer melhorar o código antes de implantá-lo. | Modelo é uma cópia exata do criado pelo autor do modelo. Ele está pronto para ser reimplantado sem alterações. |
| O modelo é um instantâneo do estado atual dos recursos. Ele inclui todas as alterações manuais feitas após a implantação. | O modelo mostra apenas o estado dos recursos no momento da implantação. Quaisquer alterações manuais feitas após a implantação não serão incluídas. |
| Você pode selecionar quais recursos de um grupo de recursos devem ser exportados. | Todos os recursos para uma implantação específica estão incluídos. Não é possível escolher um subconjunto desses recursos ou adicionar recursos que foram adicionados em um momento diferente. |
| O modelo inclui todas as propriedades dos recursos, incluindo algumas propriedades que você normalmente não definiria 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 são codificados 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 poder criar seus próprios parâmetros. | O modelo inclui parâmetros que facilitam a reimplantação em diferentes ambientes. |
Exporte o modelo de um grupo de recursos ou recurso, quando:
- Você precisa capturar alterações nos recursos que foram feitas após a implantação original.
- Você deseja selecionar quais recursos serão exportados.
- Os recursos não foram criados com um modelo.
Exporte o modelo do histórico, quando:
- Você quer um modelo fácil de reutilizar.
- Não é necessário incluir as alterações feitas após a implantação original.
Limitações
Não é garantido 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, modelo ARM ou terraform.
Ao exportar de um grupo de recursos ou recurso, o modelo exportado é gerado a partir dos esquemas publicados para cada tipo de recurso. Ocasionalmente, o esquema não tem a versão mais recente para um tipo de recurso. Verifique o modelo exportado para se certificar de que inclui as propriedades de que necessita. Se necessário, edite o modelo exportado para usar a versão da API necessária.
Alguns parâmetros de senha podem estar faltando nos modelos exportados. Você precisa verificar a referência do modelo e adicionar manualmente esses parâmetros antes de poder usar os modelos para implantar recursos.
O recurso de modelo de exportação não oferece suporte à exportação de recursos do Azure Data Factory. Para saber como exportar recursos do Data Factory, consulte Copiar ou clonar uma fábrica de dados 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 você receber um aviso ao exportar um modelo que indique que um tipo de recurso não foi exportado, ainda poderá descobrir as propriedades desse recurso. Para propriedades do recurso, consulte referência de modelo. Você também pode examinar a API REST do Azure para o tipo de recurso.
Há um limite de 200 recursos no grupo de recursos para o qual você cria o modelo exportado. Se você tentar exportar um grupo de recursos que tenha mais de 200 recursos, a mensagem Export template is not supported for resource groups more than 200 resources de erro será mostrada.
Exportar modelo a partir 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 você 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 modelo Exportar no menu superior só fica habilitado depois que você seleciona pelo menos um recurso.
Selecione Exportar modelo no menu superior. O modelo Exportar no menu esquerdo exporta todos os recursos do grupo para um modelo.
O modelo exportado é exibido e está disponível para download e implantação.
Incluir parâmetros é selecionado 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, alterne essa caixa de seleção para não incluí-los.
Exportar modelo a partir 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 você deseja exportar para abri-lo.
Para esse recurso, selecione Exportar modelo no painel esquerdo.
O modelo exportado é exibido e está disponível para download e implantação. O modelo contém apenas o único recurso. Incluir parâmetros é selecionado 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, alterne essa caixa de seleção para não incluí-los.
Modelo de exportação após a implantação
Você pode exportar o modelo que foi usado para implantar recursos existentes. O modelo que você obtém é exatamente o que foi usado para implantação.
Selecione o grupo de recursos que deseja exportar.
Selecione o link em Implantações.
Selecione uma das implantações no histórico de implantação.
Selecione Modelo. O modelo usado para essa implantação é exibido e está disponível para download.
Próximos passos
- Saiba como exportar modelos com a CLI do Azure, o Azure PowerShell ou a API REST.
- Para aprender a sintaxe do modelo do Resource Manager, consulte Compreender a estrutura e a sintaxe dos modelos do Azure Resource Manager.
- Para saber como desenvolver modelos, consulte os tutoriais passo a passo.