仮想ファイルシステムを Batch プールにマウントする

Azure Batch は、Batch プール内の Windows または Linux 計算ノードへのクラウドストレージまたは外部ファイルシステムのマウントをサポートします。計算ノードがプールに参加すると、仮想ファイルシステムがマウントされ、そのノードのローカルドライブとして動作します。この記事では、Batch (Azure) 用の Azure Resource Manager クライアントライブラリを使用して、コンピューティングノードのプールに仮想ファイルシステムをマウントする方法について説明します。ResourceManager.Batch)。

ファイルシステムをプールにマウントすると、データへのアクセスが容易になり、タスクでタスク自体のデータを大規模な共有データセットから取得しなければならない場合より、効率が向上します。ムービーのレンダリングなど、一般的なデータセットへのアクセスを必要とするタスクが複数あるシナリオについて考えてみます。各タスクで、シーンファイルから一度に 1 つ以上のフレームをレンダリングします。シーンファイルが格納されているドライブをマウントすると、計算ノードから共有データに簡単にアクセスできるようになります。

また、パフォーマンス、スループット、1 秒あたりの入出力操作 (IOPS) の要件を満たすために、基になるファイルシステムを選ぶこともできます。データに同時にアクセスする計算ノードの数に基づいて、ファイルシステムを個別にスケーリングできます。

たとえば、Avere vFXT の分散型メモリ内キャッシュを使用すると、オンプレミスのソースデータにアクセスする、数千単位の同時レンダリングノードを使用する大規模な映画規模のレンダリングをサポートできます。または、既にクラウドベースの BLOB ストレージに存在するデータの場合は、BlobFuse を使用して、このデータをローカルファイルシステムとしてマウントできます。 Azure Files には BlobFuse と同様のワークフローが用意されており、Windows と Linux の両方で使用できます。

サポートされている構成

マウントできるファイルシステムの種類は次のとおりです。

Azure Files
Azure BLOB ストレージ
Avere vFXT キャッシュを含むネットワークファイルシステム (NFS)
共通インターネットファイルシステム (CIFS)

Batch では、それぞれのパブリッシャーとオファー用に生成されるノードエージェントに対して、次の種類の仮想ファイルシステムをサポートします。

OS の種類	Azure Files ファイル共有	Azure BLOB コンテナー	NFS マウント	CIFS マウント
Linux	✔️	✔️	✔️	✔️
Windows	✔️	❌	❌	❌

注意

仮想ファイルシステムのマウントは、2019 年 8 月 8 日より前に作成された Batch プールではサポートされません。

ネットワーク要件

仮想ネットワーク内の Batch プールで仮想ファイルマウントを使用するときは、次の要件を考慮して、必要なトラフィックがブロックされないようにしてください。詳細については、仮想ネットワーク内の Batch プールに関する記事をご覧ください。

Azure Files 共有では、storage サービスタグとの間のトラフィック用に TCP ポート 445 を開く必要があります。詳細については、Windows での Azure ファイル共有の使用に関する記事を参照してください。
Azure BLOB コンテナーでは、storage サービスタグとの間のトラフィック用に TCP ポート 443 を開く必要があります。 https://packages.microsoft.com および blobfuse パッケージをダウンロードするために、仮想マシン (VM) から gpg にアクセスできる必要があります。構成によっては、他の URL にアクセスすることが必要になる場合があります。
ネットワークファイルシステム (NFS) では、既定でポート 2049 にアクセスできる必要があります。お使いの構成に他の要件がある場合もあります。 nfs-common (Debian または Ubuntu 用) パッケージをダウンロードするには、VM が適切なパッケージマネージャーにアクセスできる必要があります。 URL は、使用している OS バージョンによって異なる場合があります。構成によっては、他の URL にアクセスすることが必要になる場合もあります。

NFS 経由で Azure BLOB または Azure Files をマウントする場合は、さらにネットワーク要件が増える場合があります。たとえば、計算ノードでストレージアカウントと同じ仮想ネットワークサブネットを使用する必要が生じる場合があります。
共通インターネットファイルシステム (CIFS) では、TCP ポート 445 にアクセスできる必要があります。 cifs-utils パッケージをダウンロードするには、VM が適切なパッケージマネージャーにアクセスできる必要があります。 URL は、使用している OS バージョンによって異なる場合があります。

マウントの構成と実装

プールに仮想ファイルシステムをマウントすると、プール内のすべての計算ノードでファイルシステムを使用できるようになります。ファイルシステムの構成は、計算ノードがプールに参加するか、再起動するか、再イメージ化されると発生します。

プールにファイルシステムをマウントするには、仮想ファイルシステム (、BatchBlobFileSystemConfiguration、BatchFileShareConfiguration、またはBatchNfsMountConfiguration) に一致する BatchCifsMountConfiguration オブジェクトを作成します。

すべてのマウント構成オブジェクトには、次の基本パラメーターが必要です。一部のマウント構成には、特定のファイルシステム用の特定のパラメーターがあり、これについてはコード例で詳しく説明します。

ストレージアカウントのアカウント名またはソース。
相対的なマウントパスまたはソース、計算ノードにマウントされるファイルシステムの場所で、標準の \fsmounts ディレクトリに対する相対的な場所です。これは AZ_BATCH_NODE_MOUNTS_DIR を介してアクセスできます。

\fsmounts ディレクトリの正確な場所は、ノードの OS によって異なります。たとえば、Ubuntu ノード上の場所は、mnt\batch\tasks\fsmounts に対応します。
ファイルシステムをマウントするための特定のパラメーターを示す、マウントオプションまたは BlobFuse オプション。

プールを作成するときは、BatchMountConfigurationのMountConfiguration コレクションに各BatchAccountPoolDataを追加します。ファイルシステムのマウントは、ノードがプールに参加するか、再起動するか、再イメージ化されると行われます。

Batch エージェントは、Windows や Linux と異なる方法でマウントを実装します。

Linux では、Batch によってパッケージ cifs-utils がインストールされます。次に、Batch によってマウントコマンドが発行されます。
Windows では、Batch が cmdkey を使用して Batch アカウントの資格情報を追加します。次に、Batch で net use によってマウントコマンドが発行されます。次に例を示します。
```
net use S: \\<storage-account-name>.file.core.windows.net\<fileshare> /u:AZURE\<storage-account-name> <storage-account-key>
```

ファイルシステムをマウントすると、環境変数 AZ_BATCH_NODE_MOUNTS_DIR が作成されます。この環境変数は、マウントされたファイルシステムとログファイルの場所を指しています。ログファイルは、トラブルシューティングとデバッグに使用できます。

Azure PowerShell を使用して、Windows または Linux の Batch プールに Azure Files 共有をマウントできます。次の手順では、Azure ファイル共有ファイルシステムを構成し、Batch プールにマウントする方法について説明します。

重要

プールにマウントされるファイルシステムの最大数は 10 です。詳細とその他の制限については、「Batch サービスのクォータと制限」を参照してください。

前提条件

アクティブなサブスクリプションが含まれる Azure アカウント。
Azure PowerShell がインストールされていること。そうでない場合は、Azure Cloud Shell を使用してインターフェイスとして PowerShell を選択します。
ファイル共有がある、リンクされた Azure Storage アカウントを持つ既存の Batch アカウント。

Windows
Linux

プレースホルダーをお使いのサブスクリプション ID に置き換えて、Azure サブスクリプションにサインインします。
```
Connect-AzAccount -Subscription "<subscription-ID>"
```
Batch アカウントのコンテキストを取得します。プレースホルダー <batch-account-name> を実際の Batch アカウント名に置き換えます。
```
$context = Get-AzBatchAccount -AccountName <batch-account-name>
```

次の設定を使用して Batch プールを作成します。プレースホルダー <storage-account-name>、<storage-account-key>、<file-share-name> を、Batch アカウントにリンクされているストレージアカウントの値に置き換えます。プレースホルダー <pool-name> をプールに使用する名前に置き換えます。

次のスクリプトでは、Windows Server 2016 Datacenter の Standard_D2_V2 サイズのノードを 1 つ含むプールを作成し、そのノードの S ドライブに Azure ファイル共有をマウントします。

$fileShareConfig = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSAzureFileShareConfiguration" -ArgumentList @("<storage-account-name>", "https://<storage-account-name>.file.core.windows.net/batchfileshare1", "S", "<storage-account-key>")

$mountConfig = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSMountConfiguration" -ArgumentList @($fileShareConfig)

$imageReference = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSImageReference" -ArgumentList @("WindowsServer", "MicrosoftWindowsServer", "2016-Datacenter", "latest")

$configuration = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSVirtualMachineConfiguration" -ArgumentList @($imageReference, "batch.node.windows amd64")

New-AzBatchPool -Id "<pool-name>" -VirtualMachineSize "STANDARD_D2_V2" -VirtualMachineConfiguration $configuration -TargetDedicatedComputeNodes 1 -MountConfiguration @($mountConfig) -BatchContext $context

ノードに接続し、出力ファイルが正しいことを確認します。

マウントされたファイルにアクセスする

Azure Batch タスクでは、次の例のようなドライブの直接パスを使用して、マウントされたファイルにアクセスできます。

cmd /c "more S:\folder1\out.txt & timeout /t 90 > NULL"

Azure Batch エージェントでは、Azure Batch タスクに対してのみアクセス権を付与します。リモートデスクトッププロトコル (RDP) を使用してノードに接続する場合、ユーザーアカウントではマウントしているドライブに自動的にアクセスできません。 RDP 経由でノードに接続する場合、ストレージアカウントで S ドライブに直接アクセスするには資格情報を追加する必要があります。

資格情報を追加するには、cmdkey を使用します。プレースホルダー <storage-account-name> および <storage-account-key> を独自の情報に置き換えます。

cmdkey /add:"<storage-account-name>.file.core.windows.net" /user:"Azure\<storage-account-name>" /pass:"<storage-account-key>"

プレースホルダーをお使いのサブスクリプション ID に置き換えて、Azure サブスクリプションにサインインします。
```
Connect-AzAccount -Subscription "<subscription-ID>"
```
プレースホルダーを Batch アカウント名に置き換えて、Batch アカウントのコンテキストを取得します。
```
$context = Get-AzBatchAccount -AccountName <batch-account-name>
```

次のスクリプトでは、Ubuntu 20.04 の Standard_DS1_v2 サイズのノードを 1 つ含むプールを作成し、そのノードの S ドライブに Azure ファイル共有をマウントします。

$fileShareConfig = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSAzureFileShareConfiguration" -ArgumentList @("<storage-account-name>", https://<storage-account-name>.file.core.windows.net/<file-share-name>, "S", "<storage-account-key>", "-o vers=3.0,dir_mode=0777,file_mode=0777,sec=ntlmssp")

$mountConfig = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSMountConfiguration" -ArgumentList @($fileShareConfig)

$imageReference = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSImageReference" -ArgumentList @("0001-com-ubuntu-server-focal", "canonical", "20_04-lts", "latest")

$configuration = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSVirtualMachineConfiguration" -ArgumentList @($imageReference, "batch.node.ubuntu 20.04")

New-AzBatchPool -Id "<pool-name>" -VirtualMachineSize "Standard_DS1_v2" -VirtualMachineConfiguration $configuration -TargetDedicatedComputeNodes 1 -MountConfiguration @($mountConfig) -BatchContext $Context

ノードに接続し、出力ファイルが正しいことを確認します。

マウントされたファイルにアクセスする

マウントされたファイルにアクセスするには、環境変数 AZ_BATCH_NODE_MOUNTS_DIR を使用します。次に例を示します。

/bin/bash -c 'more $AZ_BATCH_NODE_MOUNTS_DIR/S/folder1/out.txt; sleep 20s'

必要に応じて、直接パスを使用してマウントファイルにアクセスすることもできます。 SSH を使用してノードに接続する場合は、手動で S ドライブに直接アクセスできます。パス /mnt/batch/tasks/fsmounts/S を使用します。

マウントに関する問題のトラブルシューティング

マウント構成が失敗した場合、計算ノードは失敗し、ノードの状態は使用不可になります。マウント構成エラーを診断するには、ComputeNodeError プロパティでエラーの詳細を調べます。

デバッグ用のログファイルを取得する場合は、OutputFiles API を使用して *.log ファイルをアップロードできます。 *.log ファイルには、AZ_BATCH_NODE_MOUNTS_DIR の場所にあるファイルシステムのマウントに関する情報が含まれています。マウントログファイルの形式は、マウントごとに <type>-<mountDirOrDrive>.log となります。たとえば、test というマウントディレクトリの CIFS マウントの場合、cifs-test.log という名前のマウントログファイルが作成されます。

マウントエラーを調査する

ノードに RDP または SSH で接続して、ファイルシステムのマウントに関連するログファイルを確認できます。 Azure ファイル共有を Batch ノードにマウントしようとすると、次の例のようなエラーメッセージが表示されます。

Mount Configuration Error | An error was encountered while configuring specified mount(s)
Message: System error (out of memory, cannot fork, no more loop devices)
MountConfigurationPath: S

このエラーが発生した場合は、関連するログファイルを確認するためにノードに RDP または SSH 接続します。 Batch エージェントは、Azure ファイル共有に対して Windows と Linux で異なるマウントを実装しています。 Linux では、Batch によってパッケージ cifs-utils がインストールされます。次に、Batch によってマウントコマンドが発行されます。 Windows では、Batch が cmdkey を使用して Batch アカウントの資格情報を追加します。次に、Batch で net use によってマウントコマンドが発行されます。次に例を示します。

net use S: \\<storage-account-name>.file.core.windows.net\<fileshare> /u:AZURE\<storage-account-name> <storage-account-key>

Windows
Linux

RDP 経由でノードに接続します。
D:\batch\tasks\fsmounts のログファイル fshare-S.log を開きます。

エラーメッセージを確認します。次に例を示します。

CMDKEY: Credential added successfully.
System error 86 has occurred.

The specified network password is not correct.

Azure ファイル共有のトラブルシューティングツールを使用して問題のトラブルシューティングを行います。

SSH 経由でノードに接続します。
/mnt/batch/tasks/fsmounts のログファイル fshare-S.log を開きます。
エラーメッセージ (mount error(13): Permission denied など) を確認します。
「Azure Files の接続とアクセスの問題 (SMB) のトラブルシューティング」を利用して、問題のトラブルシューティングを行います。

RDP または SSH を使用してノード上のログファイルを確認できない場合は、Azure ストレージアカウントにログをアップロードできます。この方法は、Windows と Linux の両方のログに使用できます。

Azure portal で、プールを含む Batch アカウントを検索して選択します。
Batch アカウントページで、左側のナビゲーションから [プール] を選択します。
[プール] ページで、プールの名前を選択します。
プールのページで、左側のナビゲーションから [ノード] を選択します。
[ノード] ページで、ノードの名前を選択します。
ノードのページで、[Batch ログのアップロード] を選択します。
[Batch ログのアップロード] ペインで、[ストレージコンテナーを選択します] を選択します。
[ストレージアカウント] ページで、ストレージアカウントを選択します。
[コンテナー] ページで、ファイルのアップロード先のコンテナーを選択または作成し、[選択] を選択します。
[アップロードの開始] を選択します。
アップロードが完了したら、ファイルをダウンロードし、agent-debug.log を開きます。

エラーメッセージを確認します。次に例を示します。

..20210322T113107.448Z.00000000-0000-0000-0000-000000000000.ERROR.agent.mount.filesystems.basefilesystem.basefilesystem.py.run_cmd_persist_output_async.59.2912.MainThread.3580.Mount command failed with exit code: 2, output:

CMDKEY: Credential added successfully.

System error 86 has occurred.

The specified network password is not correct.

Azure ファイル共有のトラブルシューティングツールを使用して問題のトラブルシューティングを行います。

マウントエラーを診断または修正できない場合は、代わりに PowerShell を使用してファイル共有を手動でマウントできます。

Windows
Linux

マウント構成を使用せずにプールを作成します。次に例を示します。

$imageReference = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSImageReference" -ArgumentList @("WindowsServer", "MicrosoftWindowsServer", "2016-Datacenter", "latest")

$configuration = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSVirtualMachineConfiguration" -ArgumentList @($imageReference, "batch.node.windows amd64")

New-AzBatchPool -Id "<pool-name>" -VirtualMachineSize "STANDARD_D2_V2" -VirtualMachineConfiguration $configuration -TargetDedicatedComputeNodes 1  -BatchContext $Context

ノードがアイドル状態になるまで待ちます。
Azure portal で、ファイル共有を含むストレージアカウントを検索して選択します。
ストレージアカウントページのメニューで、左側のナビゲーションから [ファイル共有] を選択します。
[ファイル共有] ページで、マウントするファイル共有を選択します。
ファイル共有のページで [接続] を選択します。
[接続] ペインで、 [Windows] タブを選択します。
[ドライブ文字] に、使用するドライブを入力します。既定値は Z です。
[認証方法] で、ファイル共有への接続方法を選択します。
[Show Script] (スクリプトの表示) を選択し、ファイル共有をマウントするための PowerShell スクリプトをコピーします。
RDP 経由でノードに接続します。
コピーしたコマンドを実行して、ファイル共有をマウントします。
出力でエラーメッセージを確認します。この情報を使用して、ネットワーク関連の問題のトラブルシューティングを行います。

マウント構成を使用せずにプールを作成します。次に例を示します。

$imageReference = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSImageReference" -ArgumentList @("0001-com-ubuntu-server-focal", "canonical", "20_04-lts", "latest")

$configuration = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSVirtualMachineConfiguration" -ArgumentList @($imageReference, "batch.node.ubuntu 20.04")

New-AzBatchPool -Id "<pool-name>" -VirtualMachineSize "Standard_DS1_v2" -VirtualMachineConfiguration $configuration -TargetDedicatedComputeNodes 1 -BatchContext $Context

ノードがアイドル状態になるまで待ちます。
Azure portal で、ファイル共有を含むストレージアカウントを検索して選択します。
ストレージアカウントページのメニューで、左側のナビゲーションから [ファイル共有] を選択します。
[ファイル共有] ページで、マウントするファイル共有を選択します。
ファイル共有のページで [接続] を選択します。
[接続] ペインで、 [Linux] タブを選択します。
使用するマウントポイントを入力します。
ファイル共有をマウントするための Linux スクリプトをコピーします。
SSH 経由でノードに接続します。
コピーしたコマンドを実行して、ファイル共有をマウントします。
出力でエラーメッセージを確認します。この情報を使用して、ネットワーク関連の問題のトラブルシューティングを行います。

マウント構成の例

次のコード例の構成は、さまざまなファイル共有システムを計算ノードのプールにマウントする方法を示しています。

Azure Files は、標準の Azure クラウドファイルシステムオファリングです。次の構成では、<file-share-name> という名前の Azure Files 共有を S ドライブにマウントします。この例のパラメーターの詳細については、「SMB Azure ファイル共有を Windows でマウントする」または「Azure portal を使用して NFS Azure ファイル共有を作成し、Linux VM にマウントする」を参照してください。

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Batch;
using Azure.ResourceManager.Batch.Models;

internal static class Program
{
    private static async Task Main()
    {
        await CreatePoolWithAzureFilesMountAsync(
            subscriptionId: "<subscription-id>",
            resourceGroupName: "<resource-group>",
            batchAccountName: "<batch-account-name>",
            poolId: "<pool-name>");
    }

    private static async Task CreatePoolWithAzureFilesMountAsync(
        string subscriptionId,
        string resourceGroupName,
        string batchAccountName,
        string poolId)
    {
        BatchAccountPoolData pool = new BatchAccountPoolData()
        {
            VmSize = "standard_d1_v2",
            DeploymentConfiguration = new BatchDeploymentConfiguration()
            {
                VmConfiguration = new BatchVmConfiguration(
                    imageReference: new BatchImageReference()
                    {
                        Publisher = "MicrosoftWindowsServer",
                        Offer = "WindowsServer",
                        Sku = "2019-datacenter-core",
                        Version = "latest",
                    },
                    nodeAgentSkuId: "batch.node.windows amd64"),
            },
        };

        pool.MountConfiguration.Add(new BatchMountConfiguration
        {
            FileShareConfiguration = new BatchFileShareConfiguration(
                accountName: "<storage-account-name>",
                fileUri: new Uri("https://<storage-account-name>.file.core.windows.net/<file-share-name>"),
                accountKey: "<storage-account-key>",
                relativeMountPath: "S")
            {
                MountOptions = "-o vers=3.0,dir_mode=0777,file_mode=0777,sec=ntlmssp",
            },
        });

        var armClient = new ArmClient(new DefaultAzureCredential());
        BatchAccountResource batchAccount = armClient.GetBatchAccountResource(
            BatchAccountResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, batchAccountName));

        await batchAccount.GetBatchAccountPools()
            .CreateOrUpdateAsync(WaitUntil.Completed, poolId, pool);

        Console.WriteLine($"Created pool '{poolId}' with an Azure Files mount.");
    }
}

Azure BLOB コンテナー

もう 1 つの選択肢は、BlobFuse を介して Azure Blob Storage を使用することです。 BLOB ファイルシステムをマウントするには、アカウントキー、Shared Access Signature (SAS) キー、またはストレージアカウントへのアクセス権を持つマネージド ID が必要です。

これらのキーまたは ID の取得については、次の記事を参照してください。

ストレージアカウントアクセスキーを管理する
共有アクセス署名 (SAS) を使用して Azure Storage リソースへの制限付きアクセスを許可する
Batch プールでマネージド ID を構成する

ヒント

マネージド ID を使用する場合は、マウントを実行する VM で使用できるように、ID が確実にプールに割り当てられているようにします。その ID には、Storage Blob Data Contributor ロールも必要です。

次の構成では、BlobFuse オプションを使用して BLOB ファイルシステムをマウントします。説明のために、この例では AccountKey、 SasKey、および IdentityResourceIdを示していますが、実際にはこれらのメソッドのうち 1 つだけを指定できます。

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Batch;
using Azure.ResourceManager.Batch.Models;

internal static class Program
{
    private static async Task Main()
    {
        await CreatePoolWithAzureBlobMountAsync(
            subscriptionId: "<subscription-id>",
            resourceGroupName: "<resource-group>",
            batchAccountName: "<batch-account-name>",
            poolId: "<pool-name>");
    }

    private static async Task CreatePoolWithAzureBlobMountAsync(
        string subscriptionId,
        string resourceGroupName,
        string batchAccountName,
        string poolId)
    {
        BatchAccountPoolData pool = new BatchAccountPoolData()
        {
            VmSize = "standard_d1_v2",
            DeploymentConfiguration = new BatchDeploymentConfiguration()
            {
                VmConfiguration = new BatchVmConfiguration(
                    imageReference: new BatchImageReference()
                    {
                        Publisher = "canonical",
                        Offer = "0001-com-ubuntu-server-focal",
                        Sku = "20_04-lts",
                        Version = "latest",
                    },
                    nodeAgentSkuId: "batch.node.ubuntu 20.04"),
            },
        };

        pool.MountConfiguration.Add(new BatchMountConfiguration
        {
            BlobFileSystemConfiguration = new BatchBlobFileSystemConfiguration(
                accountName: "<storage-account-name>",
                containerName: "<container-name>",
                relativeMountPath: "<relative-mount-path>")
            {
                // Use only one of the following three lines:
                AccountKey = "<storage-account-key>",
                SasKey = "<sas-key>",
                IdentityResourceId = new ResourceIdentifier(
                    "/subscriptions/<subscription>/resourceGroups/<resource-group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity-name>"),
                BlobfuseOptions = "-o attr_timeout=240 -o entry_timeout=240 -o negative_timeout=120",
            },
        });

        var armClient = new ArmClient(new DefaultAzureCredential());
        BatchAccountResource batchAccount = armClient.GetBatchAccountResource(
            BatchAccountResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, batchAccountName));

        await batchAccount.GetBatchAccountPools()
            .CreateOrUpdateAsync(WaitUntil.Completed, poolId, pool);

        Console.WriteLine($"Created pool '{poolId}' with an Azure Blob (BlobFuse) mount.");
    }
}

BlobFuse でマウントされたディレクトリへの既定のアクセスを取得するには、管理者としてタスクを実行します。 BlobFuse を使ってディレクトリがユーザー空間にマウントされ、プールの作成時にそのディレクトリがルートとしてマウントされます。 Linux では、すべての管理者タスクがルートになります。 FUSE のリファレンスページで、FUSE モジュールのすべてのオプションを説明しています。

BlobFuse の使用に関する詳細とヒントについては、次のリファレンスを参照してください。

大規模データセットにおけるストリーミングモードとキャッシュモードの比較

BlobFuse2は2つのデータ転送モードをサポートしており、それぞれ BlobfuseOptionsで設定できます。

ストリーミング(ブロックキャッシュ)は ダウンロード中にデータをブロック単位でストリーミングします。 AI/MLのトレーニングデータセット、ゲノムシーケンス、HPCシミュレーションデータなどの 大規模なファイルに使うと、Blobから大量の入力を読み取る高スループットのバッチワークロードでよく見られるパターンです。
キャッシュ(ファイルキャッシュ)は、使用前に各ファイル全体をローカルキャッシュにダウンロードします。ノードのローカルディスクに収まるファイルを繰り返し読み込むワークロードに使うと良いでしょう。

どのモードがあなたのワークロードに合うかを判断し、ブロックサイズ、メモリ、ディスクキャッシュの設定については、 BlobFuseマウントのストリーミングとキャッシュモードの比較、ストリーミングモードのBlobFuseの設定を参照してください。

NFS

NFS 共有をプールノードにマウントすると、Batch で従来のファイルシステムにアクセスできます。この設定は、クラウドにデプロイされる単一の NFS サーバー、または仮想ネットワーク経由でアクセスされるオンプレミスの NFS サーバーの場合があります。 NFS マウントは、データ集中型ハイパフォーマンスコンピューティング (HPC) タスク用の分散インメモリキャッシュである Avere vFXT に対応しています。また、NFS マウントは、Azure BLOB の NFS や Azure Files の NFS など、他の標準的な NFS 準拠インターフェイスにも対応しています。

次の例は、NFS ファイルシステムマウントの構成を示しています。

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Batch;
using Azure.ResourceManager.Batch.Models;

internal static class Program
{
    private static async Task Main()
    {
        await CreatePoolWithNfsMountAsync(
            subscriptionId: "<subscription-id>",
            resourceGroupName: "<resource-group>",
            batchAccountName: "<batch-account-name>",
            poolId: "<pool-name>");
    }

    private static async Task CreatePoolWithNfsMountAsync(
        string subscriptionId,
        string resourceGroupName,
        string batchAccountName,
        string poolId)
    {
        BatchAccountPoolData pool = new BatchAccountPoolData()
        {
            VmSize = "standard_d1_v2",
            DeploymentConfiguration = new BatchDeploymentConfiguration()
            {
                VmConfiguration = new BatchVmConfiguration(
                    imageReference: new BatchImageReference()
                    {
                        Publisher = "canonical",
                        Offer = "0001-com-ubuntu-server-focal",
                        Sku = "20_04-lts",
                        Version = "latest",
                    },
                    nodeAgentSkuId: "batch.node.ubuntu 20.04"),
            },
        };

        pool.MountConfiguration.Add(new BatchMountConfiguration
        {
            NfsMountConfiguration = new BatchNfsMountConfiguration(
                source: "<source>",
                relativeMountPath: "<relative-mount-path>")
            {
                MountOptions = "options ver=3.0",
            },
        });

        var armClient = new ArmClient(new DefaultAzureCredential());
        BatchAccountResource batchAccount = armClient.GetBatchAccountResource(
            BatchAccountResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, batchAccountName));

        await batchAccount.GetBatchAccountPools()
            .CreateOrUpdateAsync(WaitUntil.Completed, poolId, pool);

        Console.WriteLine($"Created pool '{poolId}' with an NFS mount.");
    }
}

CIFS

プールノードへの CIFS のマウントは、従来のファイルシステムへのアクセスを提供するもう 1 つの方法です。 CIFS は、ネットワークサーバーのファイルとサービスを要求するためのオープンなクロスプラットフォームメカニズムを提供するファイル共有プロトコルです。 CIFS は、インターネットおよびイントラネットファイル共有用の SMB プロトコルの拡張バージョンに基づいています。

次の例は、CIFS ファイルマウントの構成を示しています。

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Batch;
using Azure.ResourceManager.Batch.Models;

internal static class Program
{
    private static async Task Main()
    {
        await CreatePoolWithCifsMountAsync(
            subscriptionId: "<subscription-id>",
            resourceGroupName: "<resource-group>",
            batchAccountName: "<batch-account-name>",
            poolId: "<pool-name>");
    }

    private static async Task CreatePoolWithCifsMountAsync(
        string subscriptionId,
        string resourceGroupName,
        string batchAccountName,
        string poolId)
    {
        BatchAccountPoolData pool = new BatchAccountPoolData()
        {
            VmSize = "standard_d1_v2",
            DeploymentConfiguration = new BatchDeploymentConfiguration()
            {
                VmConfiguration = new BatchVmConfiguration(
                    imageReference: new BatchImageReference()
                    {
                        Publisher = "canonical",
                        Offer = "0001-com-ubuntu-server-focal",
                        Sku = "20_04-lts",
                        Version = "latest",
                    },
                    nodeAgentSkuId: "batch.node.ubuntu 20.04"),
            },
        };

        pool.MountConfiguration.Add(new BatchMountConfiguration
        {
            CifsMountConfiguration = new BatchCifsMountConfiguration(
                username: "<storage-account-name>",
                source: "<source>",
                password: "<storage-account-key>",
                relativeMountPath: "<relative-mount-path>")
            {
                MountOptions = "-o vers=3.0,dir_mode=0777,file_mode=0777,serverino,domain=<domain-name>",
            },
        });

        var armClient = new ArmClient(new DefaultAzureCredential());
        BatchAccountResource batchAccount = armClient.GetBatchAccountResource(
            BatchAccountResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, batchAccountName));

        await batchAccount.GetBatchAccountPools()
            .CreateOrUpdateAsync(WaitUntil.Completed, poolId, pool);

        Console.WriteLine($"Created pool '{poolId}' with a CIFS mount.");
    }
}

注意

C# ではなく PowerShell を使用する例をお探しの場合は、これに適した別の例: Azure ファイルの Azure Batch プールへのマウントに関するページを参照してください。

次のステップ

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-07-30

仮想ファイル システムを Batch プールにマウントする

サポートされている構成

ネットワーク要件

マウントの構成と実装

PowerShell を使用して Azure Files 共有をマウントする

前提条件

マウントされたファイルにアクセスする

マウントに関する問題のトラブルシューティング

マウント エラーを調査する

PowerShell を使用してファイル共有を手動でマウントする

マウント構成の例

Azure Files ファイル共有

Azure BLOB コンテナー

大規模データセットにおけるストリーミングモードとキャッシュモードの比較

NFS

CIFS

次のステップ

フィードバック

その他のリソース

仮想ファイルシステムを Batch プールにマウントする

マウントエラーを調査する