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

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

1. レプリカ スコープのストレージを使うように既存のコンテナー アプリを更新するには、app.yaml という名前の YAML ファイルにアプリの仕様をエクスポートします。

   az containerapp show -n <APP_NAME> -g <RESOURCE_GROUP_NAME> -o yaml > app.yaml
   

2. コンテナー アプリの仕様に次の変更を加えます。

   • コンテナー アプリ定義の 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
   

3. 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 を使ってコンテナー アプリの新しいリビジョンをデプロイします。

1. Azure portal で、コンテナー アプリに移動します。

2. 左側のメニューで [Revision management] (リビジョン管理) を選びます。

3. [新しいリビジョンの作成] を選択します。

4. ボリュームをマウントするコンテナーを選びます。

5. [コンテナーの編集] コンテキスト ペインで、[ボリューム マウント] タブを選びます。

6. [エフェメラル ストレージ] セクションで、次の情報を使って新しいボリュームを作成します。

   • [ボリューム名]: エフェメラル ボリュームの名前。
   • [マウント パス]: ボリュームをマウントするコンテナー内の絶対パス。

7. [保存] を選んで変更を保存し、コンテキスト ウィンドウを終了します。

8. [作成] を選んで新しいリビジョンを作成します。

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

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

1. 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 です。

2. ファイル共有をマウントするように既存のコンテナー アプリを更新するには、app.yaml という名前の YAML ファイルにアプリの仕様をエクスポートします。

   az containerapp show -n <APP_NAME> -g <RESOURCE_GROUP_NAME> -o yaml > app.yaml
   

3. コンテナー アプリの仕様に次の変更を加えます。

   • コンテナー アプリ定義の 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
   

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

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

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

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

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

   • SMB
   • NFS

   {
     "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"
           }
         }
       }
     ]
   }
   

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

   • SMB
   • NFS

   {
     "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"
           }
         ]
       }
     }
   }
   

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

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