Tutorial: Utilizar a referência de modelo do ARM

  • Artigo

Saiba como encontrar as informações de esquema do modelo e utilize as informações para criar modelos do Azure Resource Manager (modelos arm).

Neste tutorial, vai utilizar um modelo base dos Modelos de Início Rápido do Azure. Com a documentação de referência do modelo, valide o modelo.

Resource Manager referência de modelo implementar conta de armazenamento

Este tutorial abrange as seguintes tarefas:

  • Abrir um modelo de Início Rápido
  • Compreender o modelo
  • Encontre a referência do modelo
  • Editar o modelo
  • Implementar o modelo

Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

Pré-requisitos

Para concluir este artigo, precisa de:

Abrir um modelo de Início Rápido

Os Modelos de Início Rápido do Azure são um repositório para modelos arm. Em vez de criar um modelo do zero, pode encontrar um modelo de exemplo e personalizá-lo. O modelo utilizado neste início rápido chama-se Criar uma conta de armazenamento padrão. O modelo define um recurso de conta de Armazenamento do Azure.

  1. No Visual Studio Code, selecione Ficheiro>Abrir Ficheiro.

  2. em Nome de ficheiro, cole o seguinte URL:

    https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json

  3. Selecione Abrir para abrir o ficheiro.

  4. Selecione Ficheiro>Guardar Como para guardar o ficheiro como azuredeploy.json no seu computador local.

Compreender o esquema

  1. No Visual Studio Code, feche o modelo para o nível de raiz. Tem a estrutura mais simples com os seguintes elementos:

    Estrutura mais simples do modelo do Resource Manager

    • $schema: especifique a localização do ficheiro de esquema JSON que descreve a versão da linguagem de modelo.
    • contentVersion: especifique qualquer valor para este elemento documentar alterações significativas no seu modelo.
    • metadata: especifique os metadados do modelo.
    • parameters: especifique os valores que são fornecidos quando a implementação é executada para personalizar a implementação de recursos.
    • variables: especifique os valores que são utilizados como fragmentos JSON no modelo para simplificar as expressões de linguagem de modelo. Este modelo não contém este elemento.
    • resources: especifique os tipos de recursos que são implementados ou atualizados num grupo de recursos.
    • outputs: especifique os valores que são devolvidos após a implementação.

  2. Expanda resources. Existe um Microsoft.Storage/storageAccounts recurso definido. A versão da API apresentada na captura de ecrã é 2022-09-01. O nome do SKU utiliza um valor de parâmetro. O parâmetro chama-se storageAccountType.

    Definição da conta de armazenamento do modelo do Resource Manager

  3. Expanda parameters para ver como storageAccountType é definido. O parâmetro tem oito valores permitidos. Resource Manager skUs de recursos da conta de armazenamento de modelos

Com a referência de modelo, pode descobrir se está a utilizar a versão mais recente da API e se a definição do parâmetro inclui todos os valores permitidos.

Encontre a referência do modelo

  1. Navegue para Referência de modelos do Azure.

  2. Na caixa Filtrar por título, introduza contas de armazenamento e selecione as primeiras Contas de Armazenamento em Armazenamento de Referência>.

    Conta de armazenamento de referência do modelo do Resource Manager

  3. Selecione Modelo arm.

  4. Normalmente, um tipo de recurso tem várias versões de API. Esta página mostra a versão mais recente do esquema de modelo por predefinição. Selecione a caixa pendente Mais recente para ver as versões. A versão mais recente apresentada na captura de ecrã é 2022-09-01. Selecione Mais Recente ou a versão abaixo de Mais Recente para ver a versão mais recente. Certifique-se de que esta versão corresponde à versão utilizada para o recurso da conta de armazenamento no seu modelo. Se atualizar a versão da API, verifique se a definição do recurso corresponde à referência do modelo.

    Resource Manager modelo referencia as versões da conta de armazenamento

  5. Esta página lista os detalhes do tipo de recurso storageAccount. Por exemplo, lista os valores permitidos para o objeto SKU . Existem oito SKUs e correspondem aos listados no modelo de início rápido que abriu anteriormente.

    Resource Manager modelo referencia skus da conta de armazenamento

Implementar o modelo

  1. Iniciar sessão na Cloud Shell do Azure

  2. Escolha o seu ambiente preferido ao selecionar PowerShell ou Bash (para a CLI) no canto superior esquerdo. É necessário reiniciar o Shell quando mudar.

    portal do Azure Cloud Shell carregar ficheiro

  3. Selecione Carregar/transferir ficheiros e, em seguida, selecione Carregar. Veja a captura de ecrã anterior. Selecione o ficheiro que guardou na secção anterior. Depois de carregar o ficheiro, pode utilizar o ls comando e o cat comando para verificar se o ficheiro foi carregado com êxito.

  4. Na Cloud Shell, execute os seguintes comandos. Selecione o separador para mostrar o código do PowerShell ou o código da CLI.

    Quando implementar o modelo, especifique o storageAccountType parâmetro com um valor recém-adicionado, por exemplo, Standard_RAGRS. A implementação falharia se utilizasse o modelo de início rápido original porque Standard_RAGRS não era um valor permitido.

    echo "Enter a project name that is used to generate resource group name:" &&
read projectName &&
echo "Enter the location (i.e. centralus):" &&
read location &&
resourceGroupName="${projectName}rg" &&
az group create --name $resourceGroupName --location "$location" &&
az deployment group create --resource-group $resourceGroupName --template-file "$HOME/azuredeploy.json" --parameters storageAccountType='Standard_RAGRS'

Limpar recursos

Quando os recursos do Azure já não forem necessários, limpe os recursos implementados ao eliminar o grupo de recursos.

  1. Na portal do Azure, selecione Grupo de recursos no menu esquerdo.
  2. Introduza o nome do grupo de recursos no campo Filtrar por nome.
  3. Selecione o nome do grupo de recursos. Verá um total de seis recursos no grupo de recursos.
  4. Selecione Eliminar grupo de recursos no menu superior.

Passos seguintes

Neste tutorial, aprendeu a utilizar a referência de modelo para personalizar um modelo existente. Para saber mais sobre como criar várias instâncias de contas de armazenamento, veja:

Criar múltiplas instâncias