Guia de Início Rápido: Usar 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 tem uma VM (máquina virtual) do Windows Server 2019 Datacenter.

Bicep é uma DSL (linguagem específica de domínio) que usa sintaxe declarativa para implantar recursos do Azure. Ele fornece sintaxe concisa, segurança de tipos confiá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 início rápido, você:

Pré-requisitos

• Uma assinatura do Azure em que você tem permissões para criar e gerenciar recursos. Se você não tiver uma, crie uma conta gratuita.

Examinar o arquivo Bicep

Revisar o arquivo Bicep. O arquivo usa os seguintes tipos de recurso para executar 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 do 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

Implante o arquivo Bicep

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

2. Execute os comandos a seguir usando a CLI do Azure ou o Azure PowerShell na pasta em que você salvou o arquivo Bicep. Nos comandos, substitua os seguintes espaços reservados:

   • <location>: região do Azure que você deseja usar.
   • <lab-name>: nome do novo laboratório.
   • <vm-name>: nome da nova VM.
   • <user-name>: nome de usuário de uma conta local a ser criada na nova VM. Você será solicitado a inserir uma senha para a conta local. Certifique-se de não usar nomes de usuário ou senhas não permitidos listados na seçã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 implantação também cria um grupo de recursos para a VM chamada <lab-name>-<vm-name>-<numerical-string>. Esse grupo de recursos contém recursos de VM, como o endereço IP, a interface de rede e o disco.

Quando a implantação for concluída, a saída mostrará dados sobre os recursos e a implantação.

Validar a implantaçã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

Limpar os recursos

Você pode usar a CLI do Azure ou o Azure PowerShell para excluir o grupo de recursos e todos os seus recursos quando não precisar mais deles. Você também pode usar o portal do Azure.

Se você quiser excluir manualmente o grupo de recursos do laboratório, exclua o laboratório primeiro. Você não pode excluir um grupo de recursos que contenha um laboratório.

az group delete --name exampleRG

Remove-AzResourceGroup -Name exampleRG

Próxima etapa

Para se conectar às VMs de laboratório, confira o próximo tutorial.

Conteúdo relacionado

• Tutorial: Criar um laboratório e uma VM e adicionar um usuário no DevTest Labs
• Cenários do Azure DevTest Labs