Guia de início rápido: use o Bicep para criar um laboratório no DevTest Labs

Este guia de início rápido usa o Bicep para criar um laboratório no Azure DevTest Labs que tenha uma máquina virtual (VM) do Windows Server 2019 Datacenter.

O Bicep é uma linguagem específica do domínio que utiliza sintaxe declarativa para implementar recursos do Azure. Fornece sintaxe concisa, segurança de tipos fiável e suporte para reutilização de código. O Bicep oferece a melhor experiência de criação para suas soluções de infraestrutura como código no Azure.

Neste guia de início rápido, você irá:

Pré-requisitos

• Uma subscrição Azure onde tem permissões para criar e gerir recursos. Se não tiver uma, crie uma conta gratuita.

Revise o arquivo Bicep

Revise o arquivo Bicep. O ficheiro utiliza os seguintes tipos de recursos para realizar as seguintes ações:

• Microsoft.DevTestLab/labs cria o laboratório.
• Microsoft.DevTestLab/labs/virtualnetworks cria uma rede virtual.
• Microsoft.DevTestLab/labs/virtualmachines cria a VM de laboratório.

@description('The name of the new lab instance to be created')
param labName string

@description('Location for all resources.')
param location string = resourceGroup().location

@description('The name of the vm to be created.')
param vmName string

@description('The size of the vm to be created.')
param vmSize string = 'Standard_D4_v3'

@description('The username for the local account that will be created on the new vm.')
param userName string

@description('The password for the local account that will be created on the new vm.')
@secure()
param password string

var labSubnetName = '${labVirtualNetworkName}Subnet'
var labVirtualNetworkId = labVirtualNetwork.id
var labVirtualNetworkName = 'Dtl${labName}'

resource lab 'Microsoft.DevTestLab/labs@2018-09-15' = {
  name: labName
  location: location
}

resource labVirtualNetwork 'Microsoft.DevTestLab/labs/virtualnetworks@2018-09-15' = {
  parent: lab
  name: labVirtualNetworkName
}

resource labVirtualMachine 'Microsoft.DevTestLab/labs/virtualmachines@2018-09-15' = {
  parent: lab
  name: vmName
  location: location
  properties: {
    userName: userName
    password: password
    labVirtualNetworkId: labVirtualNetworkId
    labSubnetName: labSubnetName
    size: vmSize
    allowClaim: false
    galleryImageReference: {
      offer: 'WindowsServer'
      publisher: 'MicrosoftWindowsServer'
      sku: '2019-Datacenter'
      osType: 'Windows'
      version: 'latest'
    }
  }
}

output labId string = lab.id

Implantar o arquivo Bicep

1. Salve o arquivo Bicep como main.bicep em seu computador local.

2. Execute os seguintes comandos usando Azure CLI ou Azure PowerShell a partir da pasta onde guardou o ficheiro Bicep. Nos comandos, substitua os seguintes marcadores de lugar:

   • <location>: Região Azure que queres usar.
   • <lab-name>: Nome para o novo laboratório.
   • <vm-name>: Nome para a nova máquina virtual.
   • <user-name>: Nome de utilizador de uma conta local para criar na nova VM. É solicitado que introduza uma palavra-passe para a conta local. Certifique-se de não usar quaisquer nomes de utilizador ou palavras-passe não permitidos listados na secção OSProfile de Máquinas Virtuais - Criar ou Atualizar.
   • Azure CLI
   • Azure PowerShell

   az group create --name exampleRG --location <location>
   az deployment group create --resource-group exampleRG --template-file main.bicep --parameters labName=<lab-name> vmName=<vm-name> userName=<user-name>
   

A implementação também cria um grupo de recursos para a VM chamado <lab-name>-<vm-name>-<numerical-string>. Este grupo de recursos contém recursos VM como o endereço IP, interface de rede e disco.

Quando a implementação termina, a saída mostra dados sobre os recursos e a implementação.

Validar a implementação

Use a CLI do Azure ou o Azure PowerShell para listar os recursos implantados no grupo de recursos. Você também pode usar o portal do Azure.

az resource list --resource-group exampleRG

Get-AzResource -ResourceGroupName exampleRG

Clean up resources (Limpar recursos)

Podes usar o Azure CLI ou o Azure PowerShell para eliminar o grupo de recursos e todos os seus recursos quando já não precisares deles. Você também pode usar o portal do Azure.

Se quiseres eliminar manualmente o grupo de recursos do laboratório, tens de apagar primeiro o laboratório. Não é possível excluir um grupo de recursos que tenha um laboratório.

az group delete --name exampleRG

Remove-AzResourceGroup -Name exampleRG

Próximo passo

Para ligar a VMs de laboratório, veja o próximo tutorial.

Conteúdo relacionado

• Tutorial: Crie um laboratório e uma máquina virtual e adicione um utilizador nos DevTest Labs
• Cenários do Azure DevTest Labs