Quickstart: Create an Unreal Cloud DDC using Bicep

Important

The Unreal Cloud Derived Data Cache (DDC) offering has been removed from the Azure Marketplace. As such, we're retiring this documentation on March 31, 2024. Until then, this documentation exists for reference only, with no official support available from Microsoft.

Please contact your Epic Games representative for more information about using Unreal Cloud DDC.

This quickstart will show you how to create an Unreal Cloud DDC deployment using Bicep.

Review the Bicep file

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

param name                     string = 'horde-cluster'
param agentPoolName            string = 'k8agent'
param location                 string = 'eastus2'
param managedResourceGroupName string = 'mrg'
param agentPoolCount           int    = 3

var managedResourceGroupId = '${subscription().id}/resourceGroups/${resourceGroup().name}-${managedResourceGroupName}'

resource hordeStorage 'Microsoft.Solutions/applications@2017-09-01' = {
  location: location
  kind: 'MarketPlace'
  name: name
  plan: {
    name: 'aks'
    product: 'horde-storage-preview'
    publisher: 'microsoft-azure-gaming'
    version: '0.0.4'
  }
  properties: {
    managedResourceGroupId: managedResourceGroupId
    parameters: {
      location: {
        value: location
      }
      name: {
        value: name
      }
      agentPoolCount: {
        value: agentPoolCount
      }
      agentPoolName: {
        value: agentPoolName
      }
    }
    jitAccessPolicy: null
  }
}

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.

   CLI

   az group create \
     --name exampleRG \
     --location eastus
   az deployment group create \
     --resource-group exampleRG \
     --template-file main.bicep \
     --parameters name=<horde-storage-name>
   
   

   PowerShell

   New-AzResourceGroup -Name exampleRG -Location eastus
   New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep -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

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

CLI

az resource list \
  --resource-group managedResourceGroupId

PowerShell

Get-AzResource -ResourceGroupName managedResourceGroupId

Clean up resources

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

CLI

az group delete \
  --name exampleRG

PowerShell

Remove-AzResourceGroup -Name exampleRG

Next steps

• Post deployment configuration to complete setup

See also

• Deploy Bicep files from Visual Studio Code
• Configure your Bicep environment
• Use Bicep linter
• Use functions in Bicep
• Use modules in Bicep