Azure App Service容器挂载Azure Files至容器目录的实现方案（含Terraform/YAML）

可行性说明 #

完全可行。Azure App Service 针对容器部署场景，支持将Azure Files文件共享直接挂载到容器内部指定目录，足以满足你存储超100GB数据的需求（Azure Files标准层最大支持100TiB，Premium层容量也完全覆盖）。之前挂载仅生效于App Service路径，核心原因是配置时未正确指定容器内的目标挂载路径。

实现方法 #

1. Terraform脚本配置 #

在现有App Service的Terraform配置中，添加storage_account块，明确存储账户信息、文件共享名称，关键是指定container_path（容器内的挂载目标目录）。

示例配置片段：

resource "azurerm_linux_web_app" "example" {
  name                = "example-app-service"
  resource_group_name = azurerm_resource_group.example.name
  location            = azurerm_resource_group.example.location
  service_plan_id     = azurerm_service_plan.example.id

  site_config {
    application_stack {
      docker_image     = "<NAME>.azurecr.io/your-image:tag"
      docker_image_tag = "latest"
    }

    # 存储挂载核心配置
    storage_account {
      name                     = "your-storage-account-name"
      access_key               = azurerm_storage_account.example.primary_access_key
      share_name               = "your-file-share-name"
      mount_path               = "/data"
      container_path           = "/data"  # 关键：指定容器内要挂载的目标目录
      type                     = "AzureFiles"
      read_only                = false    # 开启读写权限
    }
  }

  # 已有的ACR认证配置
  app_settings = {
    DOCKER_REGISTRY_SERVER_URL = "https://<NAME>.azurecr.io"
    DOCKER_REGISTRY_SERVER_USERNAME = azurerm_container_registry.example.admin_username
    DOCKER_REGISTRY_SERVER_PASSWORD = azurerm_container_registry.example.admin_password
  }
}

# 关联的存储账户与文件共享（若未定义则添加）
resource "azurerm_storage_account" "example" {
  name                     = "yourstorageaccount"
  resource_group_name      = azurerm_resource_group.example.name
  location                 = azurerm_resource_group.example.location
  account_tier             = "Standard"
  account_replication_type = "LRS"
}

resource "azurerm_storage_share" "example" {
  name                 = "yourfileshare"
  storage_account_name = azurerm_storage_account.example.name
  quota                = 1000  # 单位GB，可按需调整，最大支持102400（100TiB）
}

注意事项：

• container_path必须与容器内需要挂载的/data目录完全一致，这是之前配置缺失的核心项
• 确保存储账户访问密钥拥有足够权限（如存储文件数据SMB共享参与者角色）
• 按需调整文件共享的quota值，满足超100GB的存储需求

2. YAML/ARM模板配置 #

若使用ARM模板或App Service配置YAML，可在siteConfig的storageAccounts节点中指定容器路径：

示例ARM模板片段：

"siteConfig": {
  "applicationStack": {
    "dockerImage": "<NAME>.azurecr.io/your-image:tag",
    "dockerImageTag": "latest"
  },
  "storageAccounts": {
    "your-storage-account-name": {
      "type": "AzureFiles",
      "accountName": "your-storage-account-name",
      "shareName": "your-file-share-name",
      "accessKey": "[listKeys(resourceId('Microsoft.Storage/storageAccounts', 'your-storage-account-name'), '2023-01-01').keys[0].value]",
      "mountPath": "/data",
      "containerPath": "/data",
      "readOnly": false
    }
  }
}

验证方法 #

部署完成后，可通过以下方式确认挂载生效：

• 进入App Service的容器终端，执行df -h查看挂载点，确认/data已关联到Azure Files
• 在容器内/data目录创建测试文件，登录Azure门户查看文件共享是否同步出现该文件

内容的提问来源于stack exchange，提问作者DKos