Quickstart: Bicep gebruiken om een lab te maken in DevTest Labs

In deze quickstart wordt Bicep gebruikt om een lab te maken in Azure DevTest Labs met daarin één virtuele Machine (VM) van Windows Server 2019 Datacenter.

Bicep is een domeinspecifieke taal (DSL) die declaratieve syntaxis gebruikt om Azure-resources te implementeren. Deze taal voorziet in een beknopte syntaxis, betrouwbare typeveiligheid en ondersteuning voor hergebruik van code. Bicep biedt de beste ontwerpervaring voor uw infrastructuur als code-oplossingen in Azure.

In deze snelstart, gaat u het volgende doen:

Vereisten

• Een Azure-abonnement met machtigingen voor het maken en beheren van resources. Als je er geen hebt, maak een gratis account aan.

Het Bicep-bestand controleren

Controleer het Bicep-bestand. Het bestand gebruikt de volgende resourcetypen om de volgende acties uit te voeren:

• Microsoft.DevTestLab/labs maakt het lab.
• Microsoft.DevTestLab/labs/virtualnetworks maakt een virtueel netwerk.
• Microsoft.DevTestLab/labs/virtualmachines maakt de lab-VM.

@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

Het Bicep-bestand implementeren

1. Sla het Bicep-bestand op als main.bicep op uw lokale computer.

2. Voer de volgende opdrachten uit met behulp van Azure CLI of Azure PowerShell vanuit de map waarin u het Bicep-bestand hebt opgeslagen. Vervang in de opdrachten de volgende tijdelijke aanduidingen:

   • <location>: Azure-regio die u wilt gebruiken.
   • <lab-name>: Naam voor het nieuwe lab.
   • <vm-name>: Naam voor de nieuwe virtuele machine.
   • <user-name>: Gebruikersnaam van een lokaal account dat moet worden gemaakt op de nieuwe VIRTUELE machine. U wordt gevraagd een wachtwoord in te voeren voor het lokale account. Zorg ervoor dat u geen niet-toegestane gebruikersnamen of wachtwoorden gebruikt die worden vermeld in de sectie OSProfile van Virtuele machines - Maken of bijwerken.
   • 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>
   

Met de implementatie wordt ook een resourcegroep gemaakt voor de virtuele machine met de naam<lab-name>-<vm-name>-<numerical-string>. Deze resourcegroep bevat VM-resources zoals het IP-adres, de netwerkinterface en de schijf.

Wanneer de implementatie is voltooid, worden in de uitvoer gegevens over de resources en de implementatie weergegeven.

De implementatie valideren

Gebruik Azure CLI of Azure PowerShell om de geïmplementeerde resources in de resourcegroep weer te geven. U kunt ook Azure Portal gebruiken.

az resource list --resource-group exampleRG

Get-AzResource -ResourceGroupName exampleRG

Resources opschonen

U kunt Azure CLI of Azure PowerShell gebruiken om de resourcegroep en alle bijbehorende resources te verwijderen wanneer u deze niet meer nodig hebt. U kunt ook Azure Portal gebruiken.

Als u de resourcegroep van het lab handmatig wilt verwijderen, moet u eerst het lab verwijderen. U kunt een resourcegroep met daarin een lab niet verwijderen.

az group delete --name exampleRG

Remove-AzResourceGroup -Name exampleRG

Volgende stap

Zie de volgende zelfstudie om verbinding te maken met lab-VM's.

Verwante inhoud

• Zelfstudie: Een lab en VM maken en een gebruiker toevoegen in DevTest Labs
• Azure DevTest Labs-scenario's