Partager via


Démarrage rapide : Utiliser Bicep pour créer un labo dans DevTest Labs

Ce guide de démarrage rapide utilise Bicep pour créer un labo dans Azure DevTest Labs qui contient une machine virtuelle Windows Server 2019 Datacenter.

Bicep est un langage spécifique à un domaine (DSL) qui utilise la syntaxe déclarative pour déployer des ressources Azure. Il fournit une syntaxe concise, une cohérence des types fiable et une prise en charge de la réutilisation du code. Bicep offre la meilleure expérience de création pour vos solutions d’infrastructure en tant que code dans Azure.

Dans ce guide de démarrage rapide, vous :

  • Examiner le fichier Bicep.
  • Déployer le fichier Bicep pour créer un labo et une machine virtuelle.
  • Vérifier le déploiement
  • Supprimer des ressources.

Prérequis

  • Un abonnement Azure dans lequel vous disposez des autorisations nécessaires pour créer et gérer des ressources. Si vous n’en avez pas, créez un compte gratuit.

Examiner le fichier Bicep

Examiner le fichier Bicep. Le fichier utilise les types de ressources suivants pour effectuer les actions suivantes :

@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

Déployer le fichier Bicep

  1. Enregistrez le fichier Bicep en tant que main.bicep sur votre ordinateur local.

  2. Exécutez les commandes suivantes à l’aide d’Azure CLI ou d’Azure PowerShell à partir du dossier dans lequel vous avez enregistré le fichier Bicep. Dans les commandes, remplacez les marqueurs de position suivants :

    • <location>: région Azure que vous souhaitez utiliser.
    • <lab-name>: Nom du nouveau labo.
    • <vm-name>: Nom de la nouvelle machine virtuelle.
    • <user-name>: nom d’utilisateur d’un compte local à créer sur la nouvelle machine virtuelle. Vous êtes invité à entrer un mot de passe pour le compte local. Veillez à ne pas utiliser de noms d’utilisateur ou de mots de passe non autorisés répertoriés dans la section OSProfile des machines virtuelles - Créer ou mettre à jour.
    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>
    

Le déploiement crée également un groupe de ressources pour la machine virtuelle nommée <lab-name>-<vm-name>-<numerical-string>. Ce groupe de ressources contient des ressources de machine virtuelle telles que l’adresse IP, l’interface réseau et le disque.

Une fois le déploiement terminé, la sortie affiche des données sur les ressources et le déploiement.

Valider le déploiement

Utilisez Azure CLI ou Azure PowerShell pour lister les ressources déployées dans le groupe de ressources. Vous pouvez également utiliser le portail Azure.

az resource list --resource-group exampleRG

Nettoyer les ressources

Vous pouvez utiliser Azure CLI ou Azure PowerShell pour supprimer le groupe de ressources et toutes ses ressources lorsque vous n’en avez plus besoin. Vous pouvez également utiliser le portail Azure.

Si vous souhaitez supprimer manuellement le groupe de ressources du labo, vous devez d’abord supprimer le labo. Vous ne pouvez pas supprimer un groupe de ressources contenant un labo.

az group delete --name exampleRG

Étape suivante

Pour vous connecter à des machines virtuelles lab, consultez le tutoriel suivant.