在 Azure 容器應用程式中使用儲存體掛接

容器應用程式可以存取不同類型的儲存體。 如有需要,單一應用程式可以利用一種以上的儲存體類型。

附註

避免在磁碟區名稱中使用特殊字元,以避免部署失敗。 例如,名為 credentials.json 的磁碟區包含特殊字元 (.),這會導致部署錯誤。

儲存體類型 描述 持續性 使用範例
容器範圍儲存體 可供執行中容器使用的暫時性儲存體 資料在容器關閉之前可供使用 撰寫本機應用程式快取。
複本範圍儲存體 在相同複本中的容器之間共用檔案的暫時性儲存體 資料在複本關閉之前可供使用 寫入 Sidecar 容器所處理之記錄檔的主要應用程式容器。
Azure 檔案儲存體 永久儲存體 資料已儲存至 Azure 檔案儲存體 將檔案寫入檔案共用,讓其他系統能夠存取資料。

附註

Azure 容器應用程式 不支援從 Azure NetApp Files 或 Azure Blob 儲存體 掛載檔案共享。

暫時性儲存體

容器應用程式可以讀取暫存資料並將其寫入暫時性儲存體。 暫時性儲存體的範圍可以設定為容器或複本。 每個複本可用的容器範圍和複本範圍儲存體總數,取決於配置給複本的 vCPU 總數。

vCPU 暫時性儲存體總計
0.25 以下 1 GiB
0.5 以下 2 GiB
1 以下 4 GiB
超過 1 8 GiB

容器範圍儲存體

容器可以寫入自己的檔案系統。

容器檔案系統儲存體具有下列特性:

  • 儲存是暫時性的,當容器關閉或重啟時就會消失。
  • 只有目前容器中執行的程序才能看到寫入此儲存的檔案。

複本範圍儲存體

您可以掛載一個臨時性、短暫的磁碟卷,其功能相當於 Kubernetes 中的 EmptyDir (空目錄)。 此儲存體的範圍設定為單一複本。 使用 EmptyDir 磁碟區在相同複本中的容器之間共用資料。

複本範圍儲存體具有下列特性:

  • 檔案會持續存在於副本的整個生命週期內。
    • 如果複本中的容器重新啟動,磁碟區中的檔案會維持不變。
  • 複本中的任何 Init 或應用程式容器都可以掛接相同的磁碟區。
  • 容器可以掛接多個 EmptyDir 磁碟區。

若要設定複本範圍儲存體,請先在修訂中定義 EmptyDir 磁碟區。 然後,在修訂中的一或多個容器中定義磁碟區掛接。

先決條件

需求 Instructions
Azure 帳戶 如果您沒有 帳戶,請免費建立帳戶。
Azure 容器應用程式 環境 建立容器應用程式環境。

組態

當你使用 Azure CLI 設定複本範圍儲存時,必須使用 YAML 定義來建立或更新你的容器應用程式。

  1. 若要更新現有的容器應用程式以使用複本範圍儲存體,請將應用程式的規格匯出至名為 app.yaml 的 YAML 檔案。

    az containerapp show -n <APP_NAME> -g <RESOURCE_GROUP_NAME> -o yaml > app.yaml
    
  2. 對容器應用程式規格進行下列變更。

    • 將 volumes 陣列新增至容器應用程式定義的 template 區段,並定義磁碟區。 如果您已有 volumes 陣列,請將新的磁碟區新增至陣列。
      • name 是磁碟區的識別碼。
      • 使用 EmptyDir 作為 storageType。
    • 針對範本中要掛接磁碟區的每個容器,在容器定義的 volumeMounts 陣列中定義磁碟區掛接。
      • volumeName 是 volumes 陣列中定義的名稱。
      • mountPath 是容器中要掛接磁碟區的路徑。
    properties:
      managedEnvironmentId: /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP_NAME>/providers/Microsoft.App/managedEnvironments/<ENVIRONMENT_NAME>
      configuration:
        activeRevisionsMode: Single
      template:
        containers:
        - image: <IMAGE_NAME1>
          name: my-container-1
          volumeMounts:
          - mountPath: /myempty
            volumeName: myempty
        - image: <IMAGE_NAME_2>
          name: my-container-2
          volumeMounts:
          - mountPath: /myempty
            volumeName: myempty
        volumes:
        - name: myempty
          storageType: EmptyDir
    
  3. 使用 YAML 檔案更新你的容器應用程式。

    az containerapp update --name <APP_NAME> --resource-group <RESOURCE_GROUP_NAME> \
        --yaml app.yaml
    

完整範例請參見 YAML 規範。

若要建立複本範圍磁碟區並將其掛接在容器中,請對 ARM 範本中的容器應用程式資源進行下列變更:

  • 將 volumes 陣列新增至容器應用程式定義的 template 區段,並定義磁碟區。 如果您已有 volumes 陣列,請將新的磁碟區新增至陣列。
    • name 是磁碟區的識別碼。
    • 使用 EmptyDir 作為 storageType。
  • 針對範本中要掛接磁碟區的每個容器,在容器定義的 volumeMounts 陣列中定義磁碟區掛接。
    • volumeName 是 volumes 陣列中定義的名稱。
    • mountPath 是容器中要掛接磁碟區的路徑。

範例 ARM 範本程式碼片段:

{
  "apiVersion": "2022-03-01",
  "type": "Microsoft.App/containerApps",
  "name": "[parameters('containerappName')]",
  "location": "[parameters('location')]",
  "properties": {

    ...

    "template": {
      "revisionSuffix": "myrevision",
      "containers": [
        {
          "name": "main",
          "image": "[parameters('container_image')]",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          },
          "volumeMounts": [
            {
              "mountPath": "/myempty",
              "volumeName": "myempty"
            }
          ]
        },
        {
          "name": "sidecar",
          "image": "[parameters('sidecar_image')]",
          "resources": {
            "cpu": 0.5,
            "memory": "1Gi"
          },
          "volumeMounts": [
            {
              "mountPath": "/myempty",
              "volumeName": "myempty"
            }
          ]
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 3
      },
      "volumes": [
        {
          "name": "myempty",
          "storageType": "EmptyDir"
        }
      ]
    }
  }
}

如需完整範例,請參閱 ARM樣本 API 規格 。

若要建立以複本為範圍的磁碟區並將其掛載至容器中,請使用 Azure 入口網站部署容器應用程式的新修訂版本。

  1. 在 Azure 入口網站,前往你的容器應用程式。

  2. 在左側功能表中選取 [修訂管理]。

  3. 選取 [建立新修訂]。

  4. 選取要掛接磁碟區的容器。

  5. 在 [編輯容器] 內容窗格中,選取 [磁碟區掛接] 索引標籤。

  6. 在 短暫儲存 區塊中,建立一個包含以下資訊的新卷:

    • 磁碟區名稱:暫時磁碟區的名稱。
    • 掛接路徑:容器中掛接磁碟區的絕對路徑。
  7. 選取 [儲存],以儲存變更並結束內容窗格。

  8. 選取 [建立] 以建立新修訂。

Azure 檔案儲存體磁碟區

您可以在容器中,將 Azure 檔案儲存體的檔案共用掛載為磁碟區。

Important

Azure 容器應用程式 只支援經典的 Azure 檔案分享,這些分享是在儲存帳號(資源類型)Microsoft.Storage/storageAccounts/fileServices/shares內建立的。 容器應用程式不支援較 Microsoft.FileShares 新的頂層資源類型。 如果你嘗試掛載資源 Microsoft.FileShares ,操作會失敗。 要建立支援的檔案分享,請參見「建立經典 Azure 檔案分享」。

Azure 檔案儲存體 儲存具有以下特性:

  • 在掛接位置下寫入的檔案會保存到檔案共用。
  • 共用中的檔案可透過掛接位置取得。
  • 多個容器可以掛接相同的檔案共用,包括位於另一個複本、修訂或容器應用程式中的檔案共用。
  • 掛接共用的所有容器,都可以存取任何其他容器或方法所寫入的檔案。
  • 多個 Azure 檔案儲存體 卷可掛載於同一個容器中。

Azure 檔案儲存體 支援 SMB(伺服器訊息區塊)和 NFS(網路檔案系統)協定。 你可以用任一協定掛載 Azure 檔案儲存體 共享。 您在環境中所定義的檔案共用必須使用儲存體帳戶中的檔案共用所使用的相同通訊協定來進行設定。

對於新的 SMB 檔案掛載,請使用 受控識別驗證(預覽) 取代儲存帳戶金鑰。 Container Apps 會使用指派給 Container Apps 環境(而非個別容器應用程式)的系統指派或使用者指派受控識別,向 Azure 檔案儲存體 進行驗證。 此模式省去了擷取、儲存或輪換儲存帳戶金鑰的需求。 您必須在儲存定義中明確選擇受管理身份驗證;現有的儲存帳戶金鑰掛載仍被支援。

管理身份驗證僅適用於 SMB 共享。 NFS 共享使用基於網路的存取控制,且不使用 SMB 認證設定。

要在容器中啟用 Azure 檔案儲存體 儲存,請先設定你的環境和容器應用程式如下:

  • 在容器應用程式環境中建立儲存體定義。
  • 如果您使用 NFS,則必須使用自訂 VNet 來設定您的環境,且必須將儲存體帳戶設定為允許從該 VNet 進行存取。 欲了解更多資訊,請參閱Azure 檔案儲存體 <>中的 NFS 檔案分享。
  • 如果你用的是 NFS,儲存帳號就不需要加密的 NFS 連線。 容器應用程式不支援 NFS 檔案分享的傳輸加密。 如果儲存帳號的「 Require Encryption in Transit for NFS」 設定已啟用,或該設定未設定且啟用 「安全傳輸所需 」,掛載將失敗,錯誤如 mount.nfs: access denied by server while mounting。 欲了解更多資訊,請參閱 NFS Azure 檔案共享的傳輸加密資訊。
  • 如果使用自訂 VNet 來設定您的環境,則必須允許與子網路相關聯的網路安全性群組 (NSG) 中的連接埠 445 和 2049。
  • 在修訂中定義類型為 AzureFile (SMB) 或 NfsAzureFile (NFS) 的磁碟區。
  • 在修訂中的一或多個容器中定義磁碟區掛接。
  • 所使用的 Azure 檔案儲存體 儲存帳號必須能從容器應用程式的虛擬網路存取。 如需詳細資訊,請參閱 授與虛擬網路的存取權。

先決條件

需求 Instructions
Azure 帳戶 如果您沒有 帳戶,請免費建立帳戶。
Azure 儲存帳戶 建立一個有經典 Azure 檔案分享的儲存帳號。
Azure 容器應用程式 環境 建立容器應用程式環境。
用於 SMB 驗證的受控識別 啟用環境的系統指派受控識別,或將使用者指派的受控識別指派給環境。 請參見「管理環境識別」。
SMB 管理身份驗證的儲存帳號設定 在儲存帳戶啟用 SMB 的受控識別 (SMBOAuth)。 其 SMB 安全設定 也必須允許 Kerberos 認證。
適用於 SMB 受控身分識別驗證的 Azure RBAC 將 Storage File Data SMB MI Admin 角色指派給所選的環境身分識別,範圍為儲存體帳戶範圍。 請參閱為受控身分識別指派內建 RBAC 角色。 要指派角色,你需要在該範圍具有 Microsoft.Authorization/roleAssignments/write 權限。 在掛載共用前,請留出時間讓角色分配生效。

組態

當你用 Azure CLI 設定容器應用程式掛載 Azure 檔案儲存體 卷時,必須使用 YAML 定義來建立或更新你的容器應用程式。

安裝最新的 Azure CLI 並更新容器應用程式擴充功能:

az extension add --name containerapp --upgrade

如需掛載 SMB 檔案共用的逐步教學課程,請參閱在 Azure 容器應用程式中建立 Azure 檔案儲存體 儲存體掛接。

  1. 將儲存體定義新增至您的容器應用程式環境。

    管理式身份驗證(建議)

    若要使用環境中系統指派的受控識別,請先啟用它:

    az containerapp env identity assign --name my-env --resource-group my-group \
        --system-assigned
    

    在你的儲存帳號上,賦予該身分「Storage File Data SMB MI Admin」角色,並依照前置條件啟用 Managed Identity for SMB。 接著建立儲存定義:

    az containerapp env storage set --name my-env --resource-group my-group \
        --storage-name mystorage \
        --storage-type AzureFile \
        --azure-file-account-name <STORAGE_ACCOUNT_NAME> \
        --azure-file-identity system \
        --azure-file-share-name <STORAGE_SHARE_NAME> \
        --access-mode ReadWrite
    

    用你的儲存體帳戶和檔案共用名稱替換 <STORAGE_ACCOUNT_NAME> 和 <STORAGE_SHARE_NAME>。 The value system值會選取環境的系統指派受控身分識別。

    若要改用使用者指派的受控識別,請將其指派給環境:

    az containerapp env identity assign --name my-env --resource-group my-group \
        --user-assigned <MANAGED_IDENTITY_RESOURCE_ID>
    

    在儲存體帳戶上賦予該身分相同的角色。 在儲存體命令中,將--azure-file-identity system取代為--azure-file-identity <MANAGED_IDENTITY_RESOURCE_ID>,並使用身分識別的完整 Azure 資源識別碼,而非其用戶端識別碼或用戶主體識別碼。

    不要將 --azure-file-account-key 與 --azure-file-key-vault-secret-url 或 --azure-file-identity 組合使用。 這些認證模式彼此互斥。

    儲存帳號金鑰認證(替代方案)

    如果你無法使用受控識別驗證,你可以改用儲存體帳戶金鑰:

    az containerapp env storage set --name my-env --resource-group my-group \
        --storage-name mystorage \
        --storage-type AzureFile \
        --azure-file-account-name <STORAGE_ACCOUNT_NAME> \
        --azure-file-account-key <STORAGE_ACCOUNT_KEY> \
        --azure-file-share-name <STORAGE_SHARE_NAME> \
        --access-mode ReadWrite
    

    將 <STORAGE_ACCOUNT_NAME> 和 <STORAGE_ACCOUNT_KEY> 取代為您儲存體帳戶的名稱和金鑰。 將 <STORAGE_SHARE_NAME> 取代為儲存體帳戶中的檔案共用名稱。

    --access-mode 的允許值為 ReadWrite 和 ReadOnly。

  2. 若要更新現有的容器應用程式以掛接檔案共用,請將應用程式的規格匯出至名為 app.yaml 的 YAML 檔案。

    az containerapp show -n <APP_NAME> -g <RESOURCE_GROUP_NAME> -o yaml > app.yaml
    
  3. 對容器應用程式規格進行下列變更。

    • 將 volumes 陣列新增至容器應用程式定義的 template 區段,並定義磁碟區。 如果您已有 volumes 陣列,請將新的磁碟區新增至陣列。
      • name 是磁碟區的識別碼。
      • 對於 storageType,將 AzureFile 用於 SMB,或將 NfsAzureFile 用於 NFS。 此值必須符合您在環境中所定義的儲存體類型。
      • 針對 storageName,請使用您在環境中定義的儲存體名稱。
      • mountOptions是掛接選項的逗號分隔字串。 更多資訊,請參見 Azure 文件中的使用 mountOptions 設定。
      • secrets 清單是要在磁碟區中掛接之秘密的清單。 欲了解更多資訊,請參閱 「在磁碟區中掛載秘密」。
    • 針對範本中要掛接 Azure 檔案儲存體的每個容器,在容器定義的 volumeMounts 陣列中定義磁碟區掛接。
      • volumeName 是 volumes 陣列中定義的名稱。
      • mountPath 是容器中要掛接磁碟區的路徑。
      • subPath 是磁碟區中要掛接的路徑。 如果未指定此值,則會掛載磁碟區的根目錄。 欲了解更多資訊,請參閱 子路徑。
    properties:
      managedEnvironmentId: /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP_NAME>/providers/Microsoft.App/managedEnvironments/<ENVIRONMENT_NAME>
      configuration:
      template:
        containers:
        - image: <IMAGE_NAME>
          name: my-container
          volumeMounts:
          - volumeName: azure-files-volume
            mountPath: /my-files
            subPath: my-sub-path
        volumes:
        - name: azure-files-volume
          storageType: AzureFile
          storageName: mystorage
    
  4. 使用 YAML 檔案更新你的容器應用程式。

    az containerapp update --name <APP_NAME> --resource-group <RESOURCE_GROUP_NAME> \
        --yaml app.yaml
    

完整範例請參見 YAML 規範。

以下 ARM 範本摘要示範如何將 Azure 檔案儲存體 分享加入容器應用程式環境,並在容器應用程式中使用。 對於 SMB 受控識別驗證,請先在環境中啟用或指派識別,並完成儲存體帳戶的前置條件,然後再部署儲存定義。

  1. 將 storages 子資源新增至容器應用程式環境。

    管理式身份驗證(建議)

    首先,請在 Microsoft.App/managedEnvironments 資源上啟用受管理識別,而不是在 Microsoft.App/containerApps 資源上。 要啟用環境的系統指派身份,請在您的環境資源中新增以下頂層 identity 屬性:

    {
      "identity": {
        "type": "SystemAssigned"
      }
    }
    

    將這個片段合併到你現有的環境資源中,保留其其他配置。 使用支援受管理身份的環境 API 版本,例如 2026-03-02-preview。 關於資源結構描述,請參見 Microsoft.App/managedEnvironments。

    在儲存體帳戶上啟用適用於 SMB 的受控身分識別 (SMBOAuth) ,並在儲存體帳戶範圍將 Storage File Data SMB MI Admin 角色指派給環境身分識別,如先決條件所述。

    然後用 API 版本 2026-03-02-preview 用於該儲存資源。 將 properties.azureFile.identity 設為 system,以選取環境的系統指派身分:

    {
      "type": "Microsoft.App/managedEnvironments/storages",
      "apiVersion": "2026-03-02-preview",
      "name": "[concat(parameters('environment_name'), '/myazurefiles')]",
      "properties": {
        "azureFile": {
          "accountName": "[parameters('storage_account_name')]",
          "identity": "system",
          "shareName": "[parameters('storage_share_name')]",
          "accessMode": "ReadWrite"
        }
      }
    }
    

    若要改用使用者指派的受控識別,請將其加入環境的頂層 identity 屬性:

    {
      "identity": {
        "type": "UserAssigned",
        "userAssignedIdentities": {
          "[parameters('managed_identity_resource_id')]": {}
        }
      }
    }
    

    將 managed_identity_resource_id 參數定義為包含該身分完整 Azure 資源 ID 的 string。 在儲存資源中,將 properties.azureFile.identity 設為 [parameters('managed_identity_resource_id')],而不是 system。 在儲存體帳戶上賦予該身分相同的角色。

    保留任何已指派給環境的身分識別。 如果您同時啟用這兩種身分識別類型,請使用SystemAssigned,UserAssigned作為環境的 identity.type,並保留其userAssignedIdentities項目。

    使用管理身分驗證時,請勿包含 accountKey 或 accountKeyVaultProperties。 如需儲存體資源結構描述,請參閱 Microsoft.App/managedEnvironments/storages。

    儲存帳號金鑰認證(替代方案)

    若要使用儲存帳戶金鑰,請設定 accountKey 並省略 identity。 定義 storage_account_key 模板參數為 secureString。

    {
      "type": "Microsoft.App/managedEnvironments/storages",
      "apiVersion": "2022-03-01",
      "name": "[concat(parameters('environment_name'), '/myazurefiles')]",
      "properties": {
        "azureFile": {
          "accountName": "[parameters('storage_account_name')]",
          "accountKey": "[parameters('storage_account_key')]",
          "shareName": "[parameters('storage_share_name')]",
          "accessMode": "ReadWrite"
        }
      }
    }
    

    這些儲存體程式碼片段假設環境與檔案共用已存在。 如果你在同一個範本中部署它們,請將環境和檔案共享資源加入儲存資源的 dependsOn 陣列。 對於受控識別驗證,如果你在該範本中建立角色指派,也要新增對角色指派的相依性。 部署依賴性並不會消除角色指派傳播的延遲。

  2. 更新容器應用程式資源,以新增磁碟區和磁碟區掛接。

    SMB 認證是在環境的儲存定義中設定的。 應用程式層級的磁碟區設定在管理身份與儲存帳號金鑰驗證時相同。 如果你在同一個範本中部署儲存資源和容器應用程式,請將儲存資源加入容器應用程式的 dependsOn 陣列。

    {
      "apiVersion": "2023-05-01",
      "type": "Microsoft.App/containerApps",
      "name": "[parameters('containerappName')]",
      "location": "[parameters('location')]",
      "properties": {
    
        ...
    
        "template": {
          "revisionSuffix": "myrevision",
          "containers": [
            {
              "name": "main",
              "image": "[parameters('container_image')]",
              "resources": {
                "cpu": 0.5,
                "memory": "1Gi"
              },
              "volumeMounts": [
                {
                  "mountPath": "/myfiles",
                  "volumeName": "azure-files-volume",
                  "subPath": "my-sub-path"
                }
              ]
            }
          ],
          "scale": {
            "minReplicas": 1,
            "maxReplicas": 3
          },
          "volumes": [
            {
              "name": "azure-files-volume",
              "storageType": "AzureFile",
              "storageName": "myazurefiles"
            }
          ]
        }
      }
    }
    
    • 將 volumes 陣列新增至容器應用程式定義的 template 區段,並定義磁碟區。 如果您已有 volumes 陣列,請將新的磁碟區新增至陣列。
      • name 是磁碟區的識別碼。
      • 對於 storageType,將 AzureFile 用於 SMB,或將 NfsAzureFile 用於 NFS。 此值必須符合您在環境中所定義的儲存體類型。
      • 針對 storageName,請使用您在環境中定義的儲存體名稱。
      • mountOptions是掛接選項的逗號分隔字串。 更多資訊,請參見 Azure 文件中的使用 mountOptions 設定。
      • secrets 清單是要在磁碟區中掛接之秘密的清單。 欲了解更多資訊,請參閱 「在磁碟區中掛載秘密」。
    • 針對範本中要掛接 Azure 檔案儲存體的每個容器,在容器定義的 volumeMounts 陣列中定義磁碟區掛接。
      • volumeName 是 volumes 陣列中定義的名稱。
      • mountPath 是容器中要掛接磁碟區的路徑。
      • subPath (選用) 是磁碟區中要掛接的路徑。 如果未指定,則會掛載磁碟區的根目錄。 欲了解更多資訊,請參閱 子路徑。

如需完整範例,請參閱 ARM樣本 API 規格 。

要在 Azure 入口網站設定 Azure 檔案儲存體 儲存的磁碟掛載,請先在容器應用程式環境中新增檔案分享,然後透過建立新的版本為容器應用程式新增磁碟掛載。 針對新的 SMB 掛接,請選取受控身分識別驗證。

  1. 在 Azure 入口網站中,導覽到你的容器應用程式環境。

  2. 針對 SMB 受控身分識別驗證,請選取設定>身分識別,並啟用系統指派身分識別,或將使用者指派身分識別新增至環境。 在新增共享前,請完成 Azure 檔案儲存體 前置條件中描述的儲存帳號設定和角色分配。

  3. 在導覽面板的 設定中,選擇 「音量掛載」。

  4. 選取 [新增]。

  5. 根據檔案共用所使用的通訊協定,選取 伺服器訊息區塊 (SMB) 或 網路檔案系統 (NFS)。

  6. 在 [ 新增檔案共享 內容] 窗格中,輸入下列資訊:

    • 名稱:環境儲存定義的名稱。
    • 儲存體帳戶名稱:包含檔案共用的記憶體帳戶名稱。
    • 驗證:選取受控身分識別 (建議)。
    • 身份:從管理身份清單中選擇環境的系統指派身份或使用者指派的身份。 選取在儲存體帳戶上具有 Storage File Data SMB MI Admin 角色的身分識別。
    • 檔案分享名稱:SMB 檔案共用的名稱。
    • 存取模式:檔案共享的存取模式。 有效值為 讀取/寫入 和 唯讀。

    若要改用儲存帳號金鑰驗證,請在「認證」中選擇儲存帳號金鑰,並輸入該儲存帳號的存取金鑰。 選擇一種儲存定義的驗證方式。

  7. 選取 [新增] 以結束內容窗格。

  8. 選取 [儲存] 以認可變更。

  9. 打開你的容器應用程式。

  10. 在瀏覽窗格中的 [ 應用程式] 底下,選取 [ 修訂和複本]。

  11. 選取 [建立新修訂]。

  12. 在 建立和部署新的修訂 頁面中,選取 儲存空間 索引標籤。

  13. 選取 [新增]。

  14. 在 「新增音量 上下文」面板中,設定以下數值。

    • Volume Type: Azure file volume。
    • 名稱:輸入磁碟區名稱。
    • 檔案分享名稱:選取您先前建立的檔案分享。
    • 掛接選項:選擇性地輸入以逗號分隔的掛接選項字串。 更多資訊,請參見 Azure 文件中的使用 mountOptions 設定。
  15. 選取 [新增] 以結束內容窗格。

  16. 在 「建立並部署新版本 」頁面,選擇 容器 標籤。

  17. 選取要在其中掛接磁碟區的容器。

  18. 在 [編輯容器] 內容窗格中,選取 [磁碟區掛接] 索引標籤。

  19. 在 [ 磁碟區名稱] 底下,選取您先前建立的磁碟區。

  20. 在 [掛接路徑] 中,輸入容器中要掛接磁碟區的絕對路徑。

  21. 在子路徑(選填)中,輸入要掛接之磁碟區中的路徑。 如果未指定此值,則會掛載磁碟區的根目錄。 欲了解更多資訊,請參閱 子路徑。

  22. 選取 [儲存],以儲存變更並結束內容窗格。

  23. 選取 [建立] 以建立新修訂。

子路徑

當你從 Azure 檔案儲存體 掛載檔案分享時,可以同時指定掛載路徑和子路徑。

  • 掛接路徑:容器中要掛接磁碟區的路徑。
  • 子路徑:您要掛接的磁碟區內的路徑。

子路徑是選擇性的。 如果未指定子路徑,則會掛載磁碟區的根目錄。

子路徑是磁碟區根目錄的相對路徑。 不要用 / 作為子路徑的開頭。 如果你指定一個以/開頭的子路徑,你的容器應用程式可能無法啟動。 例如, my-volume-folder 是有效的子路徑,但 /my-volume-folder 又不是。

子路徑可能是磁碟區中的資料夾或檔案。

  • 如果子路徑參考資料夾,掛接路徑應該參考容器中的空白資料夾。

  • 如果子路徑指的是檔案,掛載路徑則應該指容器中尚未存在的檔案。

    例如,假設子路徑為 my-volume-folder/my-volume-file.txt,而掛接路徑為 /my-container-folder/my-container-file.txt。 該資料夾 /my-container-folder 應該已經存在於容器中,但目前還不應該包含該檔案 my-container-file.txt。

系統會忽略子路徑後方的斜線。