教學課程:在 Azure 容器應用程式中建立 Azure 檔案儲存體磁碟區掛接

了解如何使用Azure 檔案儲存體掛接,在容器應用程式中寫入永久儲存體。 如需記憶體掛接的詳細資訊,請參閱 在 Azure 容器應用程式 中使用記憶體掛接。

本教學使用受管身分驗證(預覽),我們建議新 SMB 檔案掛載使用此驗證方式。 受控識別屬於容器應用程式環境。 你不需要取回、儲存或輪換儲存帳戶金鑰來掛載共用。

在本教學課程中,您將瞭解如何:

  • 建立容器應用程式環境
  • 建立 Azure 儲存體帳戶
  • 在記憶體帳戶中定義檔案共用
  • 授與環境的受控身分識別對檔案共用的存取權
  • 將環境連結至儲存體檔案共用
  • 在個別容器中掛接儲存體共用
  • 檢視網站存取記錄來確認記憶體掛接

備註

Azure 容器應用程式 支援使用 SMB 和 NFS 通訊協定掛接檔案共用。 本教學課程示範如何使用 SMB 通訊協定掛載 Azure 檔案共用。 如需深入了解如何掛接 NFS 共用,請參閱在 Azure 容器應用程式中使用儲存體掛接。

先決條件

  • 安裝最新版的 Azure CLI。
  • 使用具有建立資源及指派 Azure 角色型存取控制(Azure RBAC)角色權限的 Azure 訂閱。 若要指派角色,您需要具有 Microsoft.Authorization/roleAssignments/write 權限,範圍為儲存體帳戶。

進行環境設定

下列命令會定義環境變數,並確定您的 Container Apps 擴充功能是最新的。

  1. 登入 Azure CLI。

    az login
    
  2. 設定用於接下來各種命令的環境變數。

    RESOURCE_GROUP="my-container-apps-group"
    ENVIRONMENT_NAME="my-storage-environment"
    LOCATION="canadacentral"
    
  3. 請確定您有最新版的 Container Apps Azure CLI 擴充功能。

    az extension add -n containerapp --upgrade
    
  4. 註冊 Microsoft.App 命名空間。

    az provider register --namespace Microsoft.App
    
  5. 如果您之前未曾使用過,請註冊 Azure 監視器 Log Analytics 工作區的 Microsoft.OperationalInsights 提供者。

    az provider register --namespace Microsoft.OperationalInsights
    

建立環境

下列步驟會建立資源群組和 Container Apps 環境。

  1. 建立資源群組。

    az group create \
      --name $RESOURCE_GROUP \
      --location $LOCATION \
      --query "properties.provisioningState"
    

    命令建立後,會回傳「已成功」訊息。

    在本教學課程結束時,您可以刪除資源群組,以移除本文期間建立的所有服務。

  2. 建立容器應用程式環境。

    az containerapp env create \
      --name $ENVIRONMENT_NAME \
      --resource-group $RESOURCE_GROUP \
      --location "$LOCATION" \
      --mi-system-assigned \
      --query "properties.provisioningState"
    

    建立完成後,命令會傳回「已成功」訊息。

    使用該 --mi-system-assigned 旗標來啟用環境的系統指派型受控識別。 在後續步驟中,你會授權這個身份存取檔案共用。

    記憶體掛接會與容器應用程式環境相關聯,並在個別容器應用程式中設定。

設定儲存體帳戶

接下來,建立儲存帳戶,並建立檔案共用以掛載至容器應用程式。

  1. 定義記憶體帳戶名稱。

    此命令會產生記憶體帳戶名稱的隨機後綴,以確保唯一性。

    STORAGE_ACCOUNT_NAME="myacastorageaccount$RANDOM"
    
  2. 建立 Azure 記憶體帳戶。

    az storage account create \
      --resource-group $RESOURCE_GROUP \
      --name $STORAGE_ACCOUNT_NAME \
      --location "$LOCATION" \
      --kind StorageV2 \
      --sku Standard_LRS \
      --enable-large-file-share \
      --enable-smb-oauth true \
      --query provisioningState
    

    命令建立後,會回傳「已成功」訊息。

    此 --enable-smb-oauth true 標誌會在儲存帳戶上啟用 SMB 的受控識別(SMBOAuth)。 如果你使用現有的儲存帳號,請在建立掛載前啟用此設定。 如需相關指示,請參閱在儲存體帳戶上設定受控身分識別的存取屬。

    儲存帳號的 SMB 安全設定也必須允許 Kerberos 認證。 如果你使用自訂的 SMB 安全設定檔,請參閱 SMB 安全設定。

  3. 定義檔案共享名稱。

    STORAGE_SHARE_NAME="myfileshare"
    
  4. 建立 Azure 記憶體檔案共用。

    az storage share-rm create \
      --resource-group $RESOURCE_GROUP \
      --storage-account $STORAGE_ACCOUNT_NAME \
      --name $STORAGE_SHARE_NAME \
      --quota 1024 \
      --enabled-protocols SMB \
      --output table
    
  5. 定義記憶體掛接名稱。

    STORAGE_MOUNT_NAME="mystoragemount"
    

    此值是用來定義容器應用程式環境到 Azure 記憶體帳戶之記憶體掛接連結的名稱。

授與受控身分識別存取權

在儲存帳號範圍內,將 儲存檔案資料 SMB MI 管理員 角色指派到環境的管理身份。 此角色授權身份存取 SMB 共享中的檔案與目錄。

ENVIRONMENT_PRINCIPAL_ID=$(az containerapp env show \
  --name $ENVIRONMENT_NAME \
  --resource-group $RESOURCE_GROUP \
  --query identity.principalId \
  --output tsv)

STORAGE_ACCOUNT_ID=$(az storage account show \
  --name $STORAGE_ACCOUNT_NAME \
  --resource-group $RESOURCE_GROUP \
  --query id \
  --output tsv)

az role assignment create \
  --assignee-object-id "$ENVIRONMENT_PRINCIPAL_ID" \
  --assignee-principal-type ServicePrincipal \
  --role "Storage File Data SMB MI Admin" \
  --scope "$STORAGE_ACCOUNT_ID"

在建立儲存掛載前,請先等待角色指派完成傳播。 若想在 Azure 入口網站中指派該角色,請參見「將內建 RBAC 角色指派給受控識別」。

建立儲存體掛接

現在您可以更新容器應用程式組態以支援記憶體掛接。

  1. 在環境中建立記憶體連結。

    az containerapp env storage set \
      --access-mode ReadWrite \
      --storage-type AzureFile \
      --azure-file-account-name $STORAGE_ACCOUNT_NAME \
      --azure-file-identity system \
      --azure-file-share-name $STORAGE_SHARE_NAME \
      --storage-name $STORAGE_MOUNT_NAME \
      --name $ENVIRONMENT_NAME \
      --resource-group $RESOURCE_GROUP \
      --output table
    

    此指令會在容器應用程式環境與該 az storage share-rm 指令建立的檔案分享之間建立連結。 --azure-file-identity system選項會使用環境的系統指派受控身分識別,向 Azure 檔案儲存體進行驗證。

    對於使用者指派的管理身份,請將身份指派給環境,並使用其完整的資源 ID,而非 system。 儲存帳號金鑰認證仍被支援作為替代方案。 不要將 --azure-file-account-key 與 --azure-file-key-vault-secret-url 或 --azure-file-identity 組合使用。 範例請參見「在 Azure 容器應用程式 中使用儲存掛載」。

    既然記憶體帳戶和環境已連結,您可以建立使用記憶體掛接的容器應用程式。

  2. 定義容器應用程式名稱。

    CONTAINER_APP_NAME="my-container-app"
    
  3. 建立容器應用程式。

    az containerapp create \
      --name $CONTAINER_APP_NAME \
      --resource-group $RESOURCE_GROUP \
      --environment $ENVIRONMENT_NAME \
      --image nginx \
      --min-replicas 1 \
      --max-replicas 1 \
      --target-port 80 \
      --ingress external \
      --query properties.configuration.ingress.fqdn
    

    此命令會顯示新容器應用程式的URL。

  4. 複製 URL 並貼到網頁瀏覽器中,以瀏覽至網站。

    頁面載入之後,您會看到「歡迎使用 nginx!」訊息。 請保持此瀏覽器分頁開啟。 您會在儲存體掛接驗證步驟中返回網站。

    既然您已確認容器應用程式已設定,您可以使用存儲掛載定義來更新應用程式。

  5. 匯出容器應用程式的設定。

    az containerapp show \
      --name $CONTAINER_APP_NAME \
      --resource-group $RESOURCE_GROUP \
      --output yaml > app.yaml
    

    備註

    雖然此應用程式沒有秘密,但許多應用程式都有秘密。 根據預設,當您匯出應用程式的組態時,產生的 YAML 中不會包含秘密的值。

    如果您不需要變更秘密值,則可以移除 secrets 區段,而您的秘密仍維持不變。 或者,如果您需要變更某個祕密的值,請務必在嘗試更新應用程式之前,為檔案中的所有祕密同時提供name與value。 在secrets區段中省略某個祕密,就會刪除該祕密。

  6. 在程式代碼編輯器中開啟 app.yaml 。

  7. 將volumes: null定義(位於template 區段中)替換為參考儲存體磁碟區的volumes:定義。 範本區段看起來應該如下所示:

    template:
      containers:
      - image: nginx
        imageType: ContainerImage
        name: my-container-app
        resources:
          cpu: 0.5
          ephemeralStorage: 2Gi
          memory: 1Gi
        volumeMounts:
        - volumeName: my-azure-file-volume
          mountPath: /var/log/nginx
      initContainers: null
      revisionSuffix: ''
      scale:
        cooldownPeriod: 300
        maxReplicas: 1
        minReplicas: 1
        pollingInterval: 30
        rules: null
      serviceBinds: null
      terminationGracePeriodSeconds: null
      volumes:
      - name: my-azure-file-volume
        storageName: mystoragemount
        storageType: AzureFile
    

    新的 template.volumes 區段包含下列屬性。

    房產 說明
    name 此值用以識別應用程式層級的磁碟區,並在容器的磁碟區掛載中由 volumeName 參考。
    storageName 此值與呼叫 az containerapp env storage set 指令所建立的儲存定義名稱相符。
    storageType 這個值會決定為環境定義的記憶體磁碟區類型。 在此情況下,會宣告 Azure 檔案儲存體掛接。

    The volumes區段會在應用程式層級定義磁碟區,您的應用程式容器或 Sidecar 容器可透過與容器相關聯的volumeMounts區段來參考這些磁碟區。

    受控身分識別驗證不會變更應用程式層級的磁碟區設定。 繼續用 storageType: AzureFile 來做 SMB 掛載。

  8. 在volumeMounts區段的nginx容器中新增一個containers區段。

    containers:
      - image: nginx
        name: my-container-app
        volumeMounts:
        - volumeName: my-azure-file-volume
          mountPath: /var/log/nginx
    

    新的 volumeMounts 區段包含下列屬性:

    房產 說明
    volumeName 此值必須符合定義中 volumes 定義的名稱。
    mountPath 此值會定義容器中掛接記憶體的路徑。
  9. 使用新的記憶體掛接組態更新容器應用程式。

    az containerapp update \
      --name $CONTAINER_APP_NAME \
      --resource-group $RESOURCE_GROUP \
      --yaml app.yaml \
      --output table
    

驗證儲存體掛接

現在已建立儲存掛接,您可以從容器操作 Azure 儲存體中的檔案。 使用下列命令來觀察儲存體掛接的運作情形。

  1. 啟動容器應用程式內的互動式命令行,在正在運行的容器中執行命令。

    az containerapp exec \
      --name $CONTAINER_APP_NAME \
      --resource-group $RESOURCE_GROUP
    

    此命令可能需要一些時間才能開啟遠端命令行介面。 指令介面準備就緒後,您可以透過檔案系統指令與存儲掛接互動。 如需詳細資訊,請參閱 連線到 Azure 容器應用程式 中的容器控制台。

  2. 變更為 nginx /var/log/nginx 資料夾。

    cd /var/log/nginx
    
  3. 返回瀏覽器、導覽至網站,並將頁面重新整理幾次。

    對網站提出的要求會產生一連串記錄串流項目。

  4. 返回終端機並列出/var/log/nginx資料夾中的項目。

    ls
    

    請注意 access.log 和 error.log 檔案如何出現在這個資料夾中。 這些檔案會寫入 Azure 檔案儲存體掛接,也就是您在前述步驟中於 Azure 儲存體共用建立的掛接。

  5. 檢視 access.log 檔案的內容。

    cat access.log
    
  6. 離開容器的互動式 Shell,回到您的本機終端機工作階段。

    exit
    
  7. 現在,您可以檢視 Azure 入口網站中的檔案,以確認檔案存在於您的 Azure 記憶體帳戶中。 列印隨機產生的記憶體帳戶名稱。

    echo $STORAGE_ACCOUNT_NAME
    
  8. 流覽至 Azure 入口網站,並開啟在此程式中建立的記憶體帳戶。

  9. 在 [資料記憶體] 底下,選取 [ 檔案共享]。

  10. 選擇 myfileshare 以查看 access.log 和 error.log 檔案。

清理資源

如果您不打算繼續使用此應用程式,請執行下列命令來刪除資源群組以及本文中建立的所有資源。

az group delete \
  --name $RESOURCE_GROUP

後續步驟