Utilizar portal do Azure para exportar um modelo

Para ajudar a criar modelos do Azure Resource Manager, pode exportar um modelo a partir de recursos existentes. O modelo exportado ajuda-o a compreender a sintaxe JSON e as propriedades que implementam os seus recursos. Para automatizar futuras implementações, comece com o modelo exportado e modifique-o para o seu cenário. O processo de exportação do modelo tenta criar um modelo utilizável. No entanto, a maioria dos modelos exportados requer algumas modificações antes de poderem ser utilizados para implementar recursos do Azure.

Resource Manager permite-lhe escolher um ou mais recursos para exportar para um modelo. Pode concentrar-se exatamente nos recursos de que precisa no modelo.

Este artigo mostra como exportar modelos através do portal. Para outras opções, consulte:

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

Existem duas formas de exportar um modelo:

  • Exportar a partir de um 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. Pode exportar um grupo de recursos inteiro ou recursos específicos nesse grupo de recursos.

  • Guardar a partir do histórico. Esta opção obtém uma cópia exata de um modelo utilizado para implementação. Especifique a implementação a partir do histórico de implementações.

Consoante a opção que escolher, os modelos exportados têm qualidades diferentes.

A partir do grupo de recursos ou recurso Da história
O modelo é gerado automaticamente. É provável que queira melhorar o código antes de o implementar. O modelo é uma cópia exata da criada pelo autor do modelo. Está pronto para ser reimplementado sem quaisquer alterações.
O modelo é um instantâneo do estado atual dos recursos. Inclui quaisquer alterações manuais efetuadas após a implementação. O modelo só mostra o estado dos recursos no momento da implementação. As alterações manuais efetuadas após a implementação não são incluídas.
Pode selecionar os recursos de um grupo de recursos a exportar. Todos os recursos para uma implementação específica estão incluídos. Não pode escolher um subconjunto desses recursos nem adicionar recursos que foram adicionados num momento diferente.
O modelo inclui todas as propriedades dos recursos, incluindo algumas propriedades que normalmente não definiria durante a implementação. Poderá querer remover ou limpar estas propriedades antes de reutilizar o modelo. O modelo inclui apenas as propriedades necessárias para a implementação. O modelo é mais disperso e mais fácil de ler.
O modelo provavelmente não inclui todos os parâmetros de que precisa para reutilizar. A maioria dos valores de propriedade são hard-coded no modelo. Para reimplementar o modelo noutros ambientes, tem de adicionar parâmetros que aumentem a capacidade de configurar os recursos. Pode anular a seleção de Incluir parâmetros para que possa criar os seus próprios parâmetros. O modelo inclui parâmetros que facilitam a reimplementação em diferentes ambientes.

Exporte o modelo a partir de um grupo de recursos ou recurso, quando:

  • Tem de capturar as alterações aos recursos que foram efetuados após a implementação original.
  • Quer selecionar os recursos que são exportados.
  • Os recursos não foram criados com um modelo.

Exportar o modelo do histórico, quando:

  • Quer um modelo fácil de reutilizar.
  • Não precisa de incluir as alterações efetuadas após a implementação original.

Limitações

Não é garantido que a exportação tenha êxito. A exportação não é uma forma fiável de transformar recursos pré-existentes em modelos utilizáveis na produção. É melhor criar recursos do zero com o ficheiro Bicep escrito à mão, o modelo do ARM ou o terraform.

Ao exportar a partir 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 precisa. Se necessário, edite o modelo exportado para utilizar a versão da API de que precisa.

Alguns parâmetros de palavra-passe podem estar em falta nos modelos exportados. Tem de verificar a referência do modelo e adicionar manualmente estes parâmetros antes de poder utilizar os modelos para implementar recursos.

A funcionalidade exportar modelo não suporta a exportação de recursos Azure Data Factory. Para saber como pode exportar recursos do Data Factory, veja Copiar ou clonar uma fábrica de dados no Azure Data Factory.

Para exportar recursos criados através do modelo de implementação clássica, tem de migrá-los para o modelo de implementação Resource Manager.

Se receber um aviso ao exportar um modelo que indica que um tipo de recurso não foi exportado, ainda pode detetar as propriedades desse recurso. Para obter as propriedades do recurso, veja referência de modelo. Também pode ver a API REST do Azure para o tipo de recurso.

Existe um limite de 200 recursos no grupo de recursos para o qual cria o modelo exportado. Se tentar exportar um grupo de recursos com mais de 200 recursos, é apresentada a mensagem Export template is not supported for resource groups more than 200 resources de erro.

Exportar modelo a partir de um grupo de recursos

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

  1. Selecione o grupo de recursos que contém os recursos que pretende exportar.

  2. Selecione um ou mais recursos ao selecionar as caixas de verificação. Para selecionar todos, selecione a caixa de verificação à esquerda de Nome. O item de menu Exportar modelo só fica ativado depois de selecionar, pelo menos, um recurso.

    Captura de ecrã a mostrar a seleção de todos os recursos para exportação no portal do Azure.

    Na captura de ecrã, apenas a conta de armazenamento está selecionada.

  3. Selecione Exportar modelo.

  4. O modelo exportado é apresentado e está disponível para transferência e implementação.

    Captura de ecrã do modelo exportado apresentado no portal do Azure.

    Os parâmetros de inclusão estão selecionados por predefinição. Quando selecionado, todos os parâmetros do modelo serão incluídos quando o modelo for gerado. Se quiser criar os seus próprios parâmetros, alterne esta caixa de verificação para não os incluir.

Exportar modelo a partir de um recurso

Para exportar um recurso:

  1. Selecione o grupo de recursos que contém o recurso que pretende exportar.

  2. Selecione o recurso que pretende exportar para abrir o recurso.

  3. Para esse recurso, selecione Exportar modelo no painel esquerdo.

    Captura de ecrã a mostrar a exportação de um único recurso no portal do Azure.

  4. O modelo exportado é apresentado e está disponível para transferência e implementação. O modelo contém apenas o recurso único. Os parâmetros de inclusão estão selecionados por predefinição. Quando selecionado, todos os parâmetros do modelo serão incluídos quando o modelo for gerado. Se quiser criar os seus próprios parâmetros, alterne esta caixa de verificação para não os incluir.

Transferir o modelo antes da implementação

O portal tem a opção de transferir um modelo antes de o implementar. Esta opção não está disponível através do PowerShell ou da CLI do Azure.

  1. Selecione o serviço do Azure que pretende implementar.

  2. Preencha os valores do novo serviço.

  3. Depois de passar a validação, mas antes de iniciar a implementação, selecione Transferir um modelo para automatização.

    Captura de ecrã da opção para transferir um modelo antes da implementação no portal do Azure.

  4. O modelo é apresentado e está disponível para transferência e implementação.

Exportar modelo após a implementação

Pode exportar o modelo que foi utilizado para implementar recursos existentes. O modelo que obtém é exatamente o que foi utilizado para a implementação.

  1. Selecione o grupo de recursos que pretende exportar.

  2. Selecione a ligação em Implementações.

    Captura de ecrã a mostrar a seleção do histórico de implementações no portal do Azure.

  3. Selecione uma das implementações no histórico de implementações.

    Captura de ecrã a mostrar a seleção de uma implementação específica do histórico de implementações no portal do Azure.

  4. Selecione Modelo. O modelo utilizado para esta implementação é apresentado e está disponível para transferência.

    Captura de ecrã a mostrar a seleção do modelo utilizado para uma implementação específica no portal do Azure.

Passos seguintes