Mount Azure File Share to Azure App Service or Azure Functions Linux Container Apps

Code description

This code snippet shows you how to mount Azure Storage file share as a local drive in a Linux container app hosted in Azure App Service or Azure Functions.

Outline of the code

The code snippet does the following:

• Create a storage account

• Create file service

• Create a file share

• Create an App Service resource with Linux container

• Mount the file share to the app

For .NET 8 containers

If you use .NET 8 images that runs without root permissions, please mount the file share to path under /home. Otherwise, you may encounter errors like the following when deploying to Azure:

"message":"The resource write operation failed to complete successfully, because it reached terminal provisioning state 'Failed'.","details":[{"code":"DeploymentFailed","target":"/subscriptions/***/resourceGroups/***/providers/Microsoft.Resources/deployments/kontext-web","message":"At least one resource deployment operation failed. Please list deployment operations for details. Please see https://aka.ms/arm-deployment-operations for usage details.","details":[{"code":"InternalServerError","message":"There was an unexpected InternalServerError. Please try again later. x-ms-correlation-request-id: ***"}

Code snippet

param location string = 'australiaeast'
param storageAccountName string = 'mystorageaccount'

resource storageAccount 'Microsoft.Storage/storageAccounts@2023-01-01' = {
  kind: 'StorageV2'
  location: location
  name: storageAccountName
  properties: {
    accessTier: 'Cool'
    allowBlobPublicAccess: true
    encryption: {
      keySource: 'Microsoft.Storage'
      services: {
        blob: {
          enabled: true
          keyType: 'Account'
        }
        file: {
          enabled: true
          keyType: 'Account'
        }
      }
    }
    minimumTlsVersion: 'TLS1_2'
    supportsHttpsTrafficOnly: true
  }
  sku: {
    name: 'Standard_LRS'
  }
}

// File share for sharing data across services.
resource storageAccountFileService 'Microsoft.Storage/storageAccounts/fileServices@2023-01-01' = {
  parent: storageAccount
  name: 'default'
}

resource storageAccountFileShareMain 'Microsoft.Storage/storageAccounts/fileServices/shares@2023-01-01' = {
  parent: storageAccountFileService
  name: 'fs-main'
  properties: {
    shareQuota: 5 // Set the quota for the file share in GiB. Adjust as needed.
  }
}


resource appServicePlan 'Microsoft.Web/serverfarms@2023-01-01' = {
  name: 'myAsp'
  location: location
  sku: {
    name: 'B1'
    tier: 'Basic'
    size: 'B1'
    family: 'B1'
    capacity: 1
  }
  properties: {
    reserved: true // This is for Linux
  }
}

resource myApp 'Microsoft.Web/sites@2023-01-01' = {
  name: 'myApp'
  location: location
  // For function app, change kind to functionapp,linux
  kind: 'linux'
  properties: {
    serverFarmId: appServicePlan.id
    siteConfig: {
      linuxFxVersion: 'Docker|***:latest'
      appSettings: [
      ]
      connectionStrings: [
      ]
      azureStorageAccounts: {
        myFileShare: {
          type: 'AzureFiles'
          accountName: storageAccount.name
          shareName: storageAccountFileShareMain.name
          accessKey: storageAccount.listKeys().keys[0].value
          mountPath: '/home/fs-main'
        }
      }
    }
    httpsOnly: true
  }
}