Use Azure Files for network derived data cache with Unreal Engine

Important

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

It is essential that you understand the Azure Files performance and redundancy, and Active Directory authentication and authorization features to support the requirement of using Derived Data Cache (DDC) for the Unreal Engine.

Prerequisites

Plan Azure Files

The first thing to be done is to plan for an Azure Files for deployment. Since the Game Development Virtual Machine is running on the Windows operating system, the SMB file protocol is recommended. For more information about what to take into consideration when planning Azure Files for deployment refer to the following articles:

When you’re ready to deploy, you will first need to create an Azure file share. Your Azure File share should look like the following:

Screenshot showing an Azure file share

Mount Azure Storage File Share

There are two different methods to mount the Azure Storage File Share.

Method 1: Mount Azure File automatically during Game Development Virtual Machine creation

  1. Begin walking through the steps to create a Game Development Virtual Machine with Unreal Engine.
  2. When you get to the Data Storage tab, select to Mount an existing Azure Storage File Share.
  3. Select the Storage Account.
  4. Select the File Share.
  5. Finish creating the VM.

Screenshot showing where to mount an existing Azure Storage File Share

Method 2: Mount Azure File manually after Game Development Virtual Machine creation

  1. Follow the instructions to mount the SMB Azure File share manually.
  2. Verify that the mounted Azure file is accessible with permission to read/write files and folders after successful remote Game Development Virtual Machine access.

Screenshot showing a mounted Azure Storage File Share

Setup and use DDC

You can now follow the Epic Games documentation to setup and use shared DDC using Azure file share.

Below is the example of completed configuration of shared DDC, the Global Network DDC, in the Epic Unreal Engine Editor. The S:/test path is now connected to the Azure File share on your Game Development Virtual Machine.

Screenshot showing the path of the connected Azure File share

Next steps

Continue using Unreal Engine with a shared DDC set up on Azure Files. This improves the team collaboration experience with faster processing time.