Azure ポータルを使った Azure Container Apps のボリュームマウント手順について

Azure Container Apps で使用されるストレージは、通常エフェメラルストレージが使用されており、コンテナー (もしくはレプリカ) が再起動/シャットダウンすると、ストレージに格納されている内容は消失してしまいます。

アプリケーションによっては、他システムとの連携でストレージに格納された内容が消失されては困るケースがあるかと思いますが、Azure Container Apps には Azure Files を使ってボリュームをマウントする機能が備わっています。

Microsoft Learn のドキュメントには、Azure ポータル/Azure CLI/ARM テンプレートを使った作成手順が簡潔に説明されていますが、実施する際のイメージがしにくかったので、本ブログにて操作画面を含めた形で手順を纏めてみました。

Use storage mounts in Azure Container Apps

Learn to use temporary and permanent storage mounts in Azure Container Apps

Azure ポータルを使った Azure Container Apps のボリュームマウントについて
関連サイト/リンク
1. 焦げlog

Azure ポータルを使った Azure Container Apps のボリュームマウントについて

手順の確認で使用したリソースについて

※以下のリソースは、すべて同一リソース内に作成しています。リソース名については、確認用で作成したものであるため、作成する際は適時変更してください。

コンテナーアプリ :
- コンテナーアプリ名 : kogaacademoapp
- デプロイ元 : コンテナーイメージ (クイックスタートイメージ)
コンテナーアプリ環境 :
- コンテナーアプリ環境名 : kogaacademoenv
- SKU : ワークロード (Consumption)
- 監視 (ログの出力先) : ログを保存しない
- パブリックネットワークアクセス : 有効
- 仮想ネットワーク (VNet 統合) : いいえ (使用しない)
Azure Files (ストレージアカウント) :
- アカウント名 : kogaacademostorage
  - SKU : 汎用v2 (Azure Files Standard)
  - レプリケーション : ローカル冗長ストレージ (LRS)
  - ファイル共有名 : azurefileshare
    - アクセス層 : トランザクションが最適化されました

Azure Container Apps のボリュームマウント機能は、Azure NetApp Files や Azure Blob Storage からのファイル共有のマウントはサポートされていないため、Azure Files を作成する際はこの点を注意してください。

手順の流れ

コンテナーアプリが動作しているコンテナーアプリ環境に Azure Files のファイル共有を追加した後で、コンテナーアプリにボリュームマウントやマウントパスを設定して新しいリビジョンを作成します。

コンテナーアプリ環境とコンテナーアプリの両方で設定する点に注意してください。

また、Azure Files (ストレージアカウント) のファイル共有名とストレージアカウントキーを事前に確認しておく必要があります。

手順

Azure Files (ストレージアカウント) のファイル共有名とストレージアカウントキーの確認

Azure Files (ストレージアカウント) の管理ブレード内、ナビゲーションウィンドウから [データストレージ] – [ファイル共有] をクリックし、ボリュームマウントに使用するファイル共有名を確認します。
続けてナビゲーションウィンドウから [セキュリティとネットワーク] – [アクセスキー] をクリック、[Key1] – [キー] の [表示] をクリックし、ストレージアカウント名とストレージアカウントキーの内容を確認します。

コンテナーアプリ環境での操作

コンテナーアプリ環境の管理ブレード内、ナビゲーションウィンドウから [設定] – [Azure Files] をクリックします。
[+ 追加] を選択、[Server message Block (SMB)] を選択します。

Network File System (NFS) もサポートしていますが、NFS での Azure Container Apps のボリュームマウント機能は投稿時点でパブリックプレビューであること、Azure Files (Premium SKU) が必要となるため、本手順では SMB を選択しています。
[サーバーメッセージブロック (SMB) ファイル共有の追加] コンテキストペインで、確認した情報を元に、以下の情報を入力、[追加] をクリックします。
- 名前 : volume-mount
- ストレージアカウント名 : 手順「Azure Files (ストレージアカウント) のファイル共有名とストレージアカウントキーの確認」の項番 2. で確認したストレージアカウント名 (kogaacademostorage)
- ストレージアカウントキー : 手順「Azure Files (ストレージアカウント) のファイル共有名とストレージアカウントキーの確認」の項番 2. で確認したストレージアカウントキー
- ファイル共有名 : 手順「Azure Files (ストレージアカウント) のファイル共有名とストレージアカウントキーの確認」の項番 1. で確認したファイル共有名 (azurefileshare)
- アクセスモード : 読み取り/書き込み
  コンテナーアプリに Azure Files がボリュームマウントされているとともにファイルが書き込めるかどうかの確認を行うため、「読み取り/書き込み」を選択しています。
Azure Files のファイル共有が追加されていることを確認し、[保存] をクリックします。

コンテナーアプリ操作

コンテナーアプリ環境の管理ブレード内、ナビゲーションウィンドウから [アプリケーション] – [リビジョンとレプリカ] をクリックします。
[新しいリビジョン] をクリックします。
[新しいリビジョンの作成とデプロイ] ページで [ボリューム] タブを選択、[+ 追加] をクリックします。
[ボリュームの追加] コンテキストペインで、以下の設定を入力、[追加] をクリックします。
- ボリュームの種類 : Azure ファイルボリューム
- 名前 : smb-mount-volume
- ファイル共有名 : 手順「コンテナーアプリ環境での操作」で設定したファイル共有名 (volume-mount)
- マウントオプション : (空のまま)
[新しいリビジョンの作成とデプロイ] ページで [コンテナー] タブを選択、ボリュームマウントするコンテナー (simple-hello-world-contianer) をクリックします。
[コンテナーの編集] コンテキストペインで、[ボリュームマウント] タブを選択、以下の設定を入力、[保存] をクリックします。
- ボリューム名 : この手順の項番 4. で作成したボリューム名 (smb-mount-volume)
- マウントパス : /smbvolumemount
- サブパス (省略可能) : (空のまま)
[作成] をクリックし、新しいリビジョンを作成します。
、正常にアクティブ化が完了し、「実行中」になることを確認します。

ボリュームマウントできているかどうかの確認

コンテナーアプリ環境の管理ブレード内、ナビゲーションウィンドウから [監視] – [コンソール] をクリックします。
[App container console] タブを選択、コンソール画面上に表示される [スタートアップコマンドの選択] で「/bin/bash」を入力、[接続] をクリックします。
以下のコマンドを入力、実行し、ボリュームマウントされていることを確認します。
```
 ls / 
```
touch コマンドを用いて、ボリュームマウントしたディレクトリ内にファイルを作成できることも確認できます。