Edit

Share via

Quickstart: Create an Game Developer Virtual Machine using Bicep

  • Article

Important

Azure Game Development Virtual Machine is scheduled for retirement on February 1st, 2024. Learn more.

This quickstart will show you how to create a Windows 10 Game Developer Virtual Machine using Bicep. Game Developer Virtual Machines are cloud-based virtual machines preloaded with a suite of game developer frameworks and tools. When deployed on GPU-powered compute resources, all tools and libraries are configured to use the GPU.

Prerequisites

An Azure subscription. If you don't have an Azure subscription, create a free account before you begin.

Review the Bicep file

The Bicep file is based on the quickstart from Azure Quickstart Templates.

param vmName string
param adminName string
@secure()
param adminPass string = newGuid()

module win10 'br/public:azure-gaming/game-dev-vm:1.0.1' = {
  name: 'win10_ue_4_27_2'
  params: {
    location  : resourceGroup().location
    vmName    : 'bicep'
    adminName : 'gdvmadmin'
    adminPass : adminPass
    osType    : 'win10'
    gameEngine: 'ue_4_27_2'
    vmSize    : 'Standard_D4s_v3'
  }
}

outputs adminPass string = adminPass

Deploy the Bicep file

  1. Save the Bicep file as main.bicep to your local computer.

  2. Deploy the Bicep file using either Azure CLI or Azure PowerShell.

    az group create \
  --name exampleRG \
  --location eastus
az deployment group create \
  --resource-group exampleRG \
  --template-file main.bicep \
  --parameters adminName=<admin-user> \
  vmName=<vm-name>

    Note

    Replace <admin-user> with the username for the administrator account. Replace <vm-name> with the name of your virtual machine.

    When the deployment finishes, you should see a message indicating the deployment succeeded.

Review deployed resources

Use the Azure CLI, or Azure PowerShell to list the deployed resources in the resource group.

az resource list \
  --resource-group exampleRG

Clean up resources

When no longer needed, use the Azure CLI, or Azure PowerShell to delete the resource group and its resources.

az group delete \
  --name exampleRG

See also