Azure Container Apps でストレージマウントを使用する

[アーティクル]
04/19/2024

コンテナーアプリは、さまざまな種類のストレージにアクセスできます。必要に応じて、1 つのアプリで複数の種類のストレージを利用できます。

ストレージの種類	説明	永続化	使用例
コンテナースコープのストレージ	実行中のコンテナーで使用できるエフェメラルストレージ	データはコンテナーがシャットダウンするまで使用できます	ローカルアプリキャッシュを作成する。
レプリカスコープのストレージ	同じレプリカ内のコンテナー間でファイルを共有するためのエフェメラルストレージ	データはレプリカがシャットダウンするまで使用できます	サイドカーコンテナーによって処理されるログファイルを書き込むメインアプリコンテナー。
Azure Files	永続的なストレージ	データは Azure Files に保存されます	ファイル共有にファイルを書き込んで、他のシステムからデータにアクセスできるようにする。

エフェメラルストレージ

コンテナーアプリは、エフェメラルストレージとの間で一時データを読み書きできます。エフェメラルストレージのスコープは、コンテナーまたはレプリカに設定できます。各レプリカで使用できるコンテナースコープおよびレプリカスコープのストレージの合計量は、レプリカに割り当てられた vCPU の合計量によって異なります。

vCPU 数	エフェメラルストレージの合計
0.25 以下	1 GiB
0.5 以下	2 GiB
1 以下	4 GiB
1 より大	8 GiB

コンテナースコープのストレージ

コンテナーは、独自のファイルシステムに書き込むことができます。

コンテナーファイルシステムのストレージには、次の特性があります。

ストレージは一時的であり、コンテナーがシャットダウンまたは再起動されると消失します。
このストレージに書き込まれるファイルは、現在のコンテナーで実行されているプロセスにのみ表示されます。

レプリカスコープのストレージ

Kubernetes の EmptyDir (空のディレクトリ) と同等の一時的なエフェメラルボリュームをマウントできます。このストレージは単一のレプリカにスコープされます。 EmptyDir ボリュームを使って、同じレプリカ内のコンテナー間でデータを共有します。

レプリカスコープのストレージには、次の特性があります。

ファイルはレプリカの有効期間中保持されます。
- レプリカ内のコンテナーが再起動された場合、ボリューム内のファイルはそのまま残されます。
レプリカ内のすべての init コンテナーまたはアプリコンテナーが、同じボリュームをマウントできます。
1 つのコンテナーで、複数の EmptyDir ボリュームをマウントできます。

レプリカスコープのストレージを構成するには、最初にリビジョンで EmptyDir ボリュームを定義します。次に、リビジョン内の 1 つ以上のコンテナーでボリュームマウントを定義します。

前提条件

要件	手順
Azure アカウント	お持ちでない場合は、無料のアカウントを作成してください。
Azure Container Apps 環境	コンテナーアプリ環境を作成します。

構成

Azure CLI を使ってレプリカスコープのストレージを構成するときは、YAML 定義を使ってコンテナーアプリを作成または更新する必要があります。

レプリカスコープのストレージを使うように既存のコンテナーアプリを更新するには、app.yaml という名前の YAML ファイルにアプリの仕様をエクスポートします。
```
az containerapp show -n <APP_NAME> -g <RESOURCE_GROUP_NAME> -o yaml > app.yaml
```
コンテナーアプリの仕様に次の変更を加えます。
- コンテナーアプリ定義の template セクションに volumes 配列を追加して、ボリュームを定義します。既に 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
```

YAML ファイルを使用して、コンテナーアプリを更新します。

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

完全な例については、YAML の仕様に関する記事をご覧ください。

レプリカスコープのボリュームを作成し、コンテナーでそれをマウントするには、ARM テンプレートでコンテナーアプリリソースを次のように変更します。

コンテナーアプリ定義の template セクションに volumes 配列を追加して、ボリュームを定義します。既に 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 portal を使ってコンテナーアプリの新しいリビジョンをデプロイします。

Azure portal で、コンテナーアプリに移動します。
左側のメニューで [Revision management] (リビジョン管理) を選びます。
[新しいリビジョンの作成] を選択します。
ボリュームをマウントするコンテナーを選びます。
[コンテナーの編集] コンテキストペインで、[ボリュームマウント] タブを選びます。
[エフェメラルストレージ] セクションで、次の情報を使って新しいボリュームを作成します。
- [ボリューム名]: エフェメラルボリュームの名前。
- [マウントパス]: ボリュームをマウントするコンテナー内の絶対パス。
[保存] を選んで変更を保存し、コンテキストウィンドウを終了します。
[作成] を選んで新しいリビジョンを作成します。

Azure Files ボリューム

コンテナー内のボリュームとして Azure Files からファイル共有をマウントできます。

Azure Files ストレージには、次の特性があります。

マウント場所の下に書き込まれたファイルは、ファイル共有に永続化されます。
共有内のファイルは、マウントの場所から使用できます。
複数のコンテナーで同じファイル共有をマウントできます。これには、別のレプリカ、リビジョン、またはコンテナーアプリにあるものも含まれます。
共有をマウントするすべてのコンテナーは、他のコンテナーまたはメソッドによって書き込まれたファイルにアクセスできます。
1 つのコンテナーに複数のAzure Files ボリュームをマウントできます。

Azure Files は、SMB と NFS の両プロトコルをサポートしています。どちらのプロトコルを使っても Azure Files 共有をマウントできます。環境で定義するファイル共有は、ストレージアカウントのファイル共有に使うものと同じプロトコルで構成する必要があります。

Note

Azure Container Apps で NFS 共有をマウントすることのサポートはプレビュー段階です。

コンテナーで Azure Files ストレージを有効にするには、環境とコンテナーアプリを次のように設定する必要があります。

Container Apps 環境でストレージの定義を作成します。
NFS を使っている場合は、環境をカスタム VNet で構成し、VNet からのアクセスを許可するようにストレージアカウントを構成する必要があります。詳細については、「Azure Files での NFS ファイル共有」を参照してください。
カスタム VNet を使って環境が構成されている場合は、サブネットに関連付けられたネットワークセキュリティグループ (NSG) でポート 445 と 2049 を許可する必要があります。
リビジョンで種類 AzureFile (SMB) または NfsAzureFile (NFS) のボリュームを定義します。
リビジョン内の 1 つ以上のコンテナーでボリュームマウントを定義します。
使う Azure Files ストレージアカウントは、コンテナーアプリの仮想ネットワークからアクセスできる必要があります。詳細については、仮想ネットワークからのアクセスの許可に関するページを参照してください。
- NFS を使っている場合は、セキュリティで保護された転送も無効にする必要があります。詳細については、「Azure Files での NFS ファイル共有」とこのチュートリアルの「NFS Azure ファイル共有を作成する」セクションを参照してください。

前提条件

要件	手順
Azure アカウント	お持ちでない場合は、無料のアカウントを作成してください。
Azure ストレージアカウント	ストレージアカウントの作成。
Azure Container Apps 環境	コンテナーアプリ環境を作成します。

構成

Azure CLI を使って Azure Files ボリュームをマウントするようにコンテナーアプリを構成するときは、YAML 定義を使ってコンテナーアプリを作成または更新する必要があります。

SMB ファイル共有をマウントする方法の詳細なチュートリアルについては、「Azure Container Apps で Azure Files ストレージマウントを作成する」を参照してください。

Container Apps 環境にストレージの定義を追加します。
- SMB
- NFS
```
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 です。
```
az containerapp env storage set --name my-env --resource-group my-group \
    --storage-name mystorage \
    --storage-type NfsAzureFile \
    --server <NFS_SERVER> \
    --azure-file-share-name <STORAGE_SHARE_NAME> \
    --access-mode ReadWrite
```
<NFS_SERVER> を <STORAGE_ACCOUNT_NAME>.file.core.windows.net 形式の NFS サーバーアドレスに置き換えます。たとえば、ストレージアカウント名が mystorageaccount の場合、NFS サーバーアドレスは mystorageaccount.file.core.windows.net です。

<STORAGE_SHARE_NAME> を、/<STORAGE_ACCOUNT_NAME>/<STORAGE_SHARE_NAME> 形式のファイル共有の名前に置き換えます。たとえば、ストレージアカウント名が mystorageaccount であり、ファイル共有名が myshare の場合、共有名は /mystorageaccount/myshare です。

--access-mode の有効な値は、ReadWrite と ReadOnly です。

Note

NFS Azure Files をマウントするには、カスタム VNet を備えた Container Apps 環境を使う必要があります。 VNet からのアクセスを許可するようにストレージアカウントを構成する必要があります。
ファイル共有をマウントするように既存のコンテナーアプリを更新するには、app.yaml という名前の YAML ファイルにアプリの仕様をエクスポートします。
```
az containerapp show -n <APP_NAME> -g <RESOURCE_GROUP_NAME> -o yaml > app.yaml
```
コンテナーアプリの仕様に次の変更を加えます。
- コンテナーアプリ定義の template セクションに volumes 配列を追加して、ボリュームを定義します。既に volumes 配列がある場合は、新しいボリュームを配列に追加します。
  - name はボリュームの識別子です。
  - storageType の場合、SMB には AzureFile、NFS には NfsAzureFile を使います。この値は、環境で定義したストレージの種類と一致する必要があります。
  - storageName では、環境内で定義したストレージの名前を使用します。
- Azure Files ストレージをマウントするテンプレート内のコンテナーごとに、コンテナー定義の volumeMounts 配列でボリュームマウントを定義します。
  - volumeName は、volumes 配列で定義されている名前です。
  - mountPath は、ボリュームをマウントするコンテナー内のパスです。
- SMB
- NFS
```
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
    volumes:
    - name: azure-files-volume
      storageType: AzureFile
      storageName: mystorage
```
```
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
    volumes:
    - name: azure-files-volume
      storageType: NfsAzureFile
      storageName: mystorage
```

YAML ファイルを使用して、コンテナーアプリを更新します。

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

完全な例については、YAML の仕様に関する記事をご覧ください。

次の ARM テンプレートスニペットは、Container Apps 環境に Azure Files 共有を追加して、コンテナーアプリで使用する方法を示しています。

storages 子リソースを Container Apps 環境に追加します。

{
  "type": "Microsoft.App/managedEnvironments",
  "apiVersion": "2022-03-01",
  "name": "[parameters('environment_name')]",
  "location": "[parameters('location')]",
  "properties": {
    "daprAIInstrumentationKey": "[parameters('dapr_ai_instrumentation_key')]",
    "appLogsConfiguration": {
      "destination": "log-analytics",
      "logAnalyticsConfiguration": {
        "customerId": "[parameters('log_analytics_customer_id')]",
        "sharedKey": "[parameters('log_analytics_shared_key')]"
      }
    }
  },
  "resources": [
    {
      "type": "storages",
      "name": "myazurefiles",
      "apiVersion": "2022-03-01",
      "dependsOn": [
        "[resourceId('Microsoft.App/managedEnvironments', parameters('environment_name'))]"
      ],
      "properties": {
        "azureFile": {
          "accountName": "[parameters('storage_account_name')]",
          "accountKey": "[parameters('storage_account_key')]",
          "shareName": "[parameters('storage_share_name')]",
          "accessMode": "ReadWrite"
        }
      }
    }
  ]
}

{
  "type": "Microsoft.App/managedEnvironments",
  "apiVersion": "2023-05-01",
  "name": "[parameters('environment_name')]",
  "location": "[parameters('location')]",
  "properties": {
    "daprAIInstrumentationKey": "[parameters('dapr_ai_instrumentation_key')]",
    "appLogsConfiguration": {
      "destination": "log-analytics",
      "logAnalyticsConfiguration": {
        "customerId": "[parameters('log_analytics_customer_id')]",
        "sharedKey": "[parameters('log_analytics_shared_key')]"
      }
    },
    "workloadProfiles": [
      {
        "name": "Consumption",
        "workloadProfileType": "Consumption"
      }
    ],
    "vnetConfiguration": {
      "infrastructureSubnetId": "[parameters('custom_vnet_subnet_id')]",
      "internal": false
    },
  },
  "resources": [
    {
      "type": "storages",
      "name": "myazurefiles",
      "apiVersion": "2023-11-02-preview",
      "dependsOn": [
        "[resourceId('Microsoft.App/managedEnvironments', parameters('environment_name'))]"
      ],
      "properties": {
        "nfsAzureFile": {
          "server": "[concat(parameters('storage_account_name'), '.file.core.windows.net')]",
          "shareName": "[concat('/', parameters('storage_account_name'), '/', parameters('storage_share_name'))]",
          "accessMode": "ReadWrite"
        }
      }
    }
  ]
}

Note

NFS Azure Files をマウントするには、カスタム VNet を備えた Container Apps 環境を使う必要があります。 VNet からのアクセスを許可するようにストレージアカウントを構成する必要があります。

コンテナーアプリリソースを更新して、ボリュームとボリュームマウントを追加します。

{
  "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"
            }
          ]
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 3
      },
      "volumes": [
        {
          "name": "azure-files-volume",
          "storageType": "AzureFile",
          "storageName": "myazurefiles"
        }
      ]
    }
  }
}

{
  "apiVersion": "2023-11-02-preview",
  "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"
            }
          ]
        }
      ],
      "scale": {
        "minReplicas": 1,
        "maxReplicas": 3
      },
      "volumes": [
        {
          "name": "azure-files-volume",
          "storageType": "NfsAzureFile",
          "storageName": "myazurefiles"
        }
      ]
    }
  }
}

コンテナーアプリ定義の template セクションに volumes 配列を追加して、ボリュームを定義します。既に volumes 配列がある場合は、新しいボリュームを配列に追加します。
- name はボリュームの識別子です。
- storageType の場合、SMB には AzureFile、NFS には NfsAzureFile を使います。この値は、環境で定義したストレージの種類と一致する必要があります。
- storageName では、環境内で定義したストレージの名前を使用します。
Azure Files ストレージをマウントするテンプレート内のコンテナーごとに、コンテナー定義の volumeMounts 配列でボリュームマウントを定義します。
- volumeName は、volumes 配列で定義されている名前です。
- mountPath は、ボリュームをマウントするコンテナー内のパスです。

完全な例については、ARM テンプレートの API 仕様に関する記事を参照してください。

Azure portal で Azure Files ストレージ用のボリュームマウントを構成するには、Container Apps 環境にファイル共有を追加してから、新しいリビジョンを作成してコンテナーアプリにボリュームマウントを追加します。

Azure portal で、Container Apps インスタンスに移動します。
左側メニューから [Azure Files] を選びます。
[追加] を選択します。
[ファイル共有の追加] コンテキストメニューで、次の情報を入力します。
- [名前]: ファイル共有の名前。
- [ストレージアカウント名]: ファイル共有を含むストレージアカウントの名前。
- [ストレージアカウントキー]: ストレージアカウントのアクセスキー。
- [ファイル共有]: ファイル共有の名前。
- [アクセスモード]: ファイル共有のアクセスモード。有効な値は、[読み書き可能] と [読み取り専用] です。
[追加] を選んでコンテキストペインを終了します。
[保存] を選んで変更をコミットします。
コンテナーアプリに移動します。
左側のメニューで [Revision management] (リビジョン管理) を選びます。
[新しいリビジョンの作成] を選択します。
ボリュームをマウントするコンテナーを選びます。
[コンテナーの編集] コンテキストペインで、[ボリュームマウント] タブを選びます。
[ファイル共有] セクションで、次の情報を使って新しいボリュームを作成します。
- [ファイル共有名]: 追加したファイル共有。
- [マウントパス]: ボリュームをマウントするコンテナー内の絶対パス。
[保存] を選んで変更を保存し、コンテキストウィンドウを終了します。
[作成] を選んで新しいリビジョンを作成します。

Azure Container Apps でストレージ マウントを使用する

エフェメラル ストレージ

コンテナー スコープのストレージ

レプリカ スコープのストレージ

前提条件

構成

Azure Files ボリューム

前提条件

構成

その他のリソース

Azure Container Apps でストレージマウントを使用する

エフェメラルストレージ

コンテナースコープのストレージ

レプリカスコープのストレージ