バインドマウント - Amazon Elastic Container Service

バインドマウント

バインドマウントにより、ホストマシン上のファイルやディレクトリがコンテナにマウントされます。バインドマウントのホストボリュームを使用するには、タスク定義で sourcePath およびオプションの 値を使用します。詳細については、「Use bind mounts」を参照してください。

注記

Fargate 上のタスクの Amazon ECS のタスクストレージについては、「Fargate タスクストレージ」を参照してください。

バインドマウントの一般的ユースケースは以下のとおりです。

  • コンテナで使用する永続データボリュームを提供する

  • 空の非永続データボリュームを定義し、同じコンテナインスタンス上の複数のコンテナにマウントする

  • 定義したデータボリュームを同じコンテナインスタンス上の異なるコンテナにある別々の場所で共有する

タスク定義でバインドマウントを指定する

コンテナでバインドマウントのホストボリュームを使用するには、ボリュームとマウントポイント設定をタスク定義で指定する必要があります。このセクションでは、コンテナのボリューム設定について説明します。バインドマウントのホストボリュームを使用するタスクで、host 値とオプションの sourcePath 値を指定します。

次のタスク定義の JSON スニペットは、コンテナの volumesmountPoints オブジェクトの構文を示します。

{ "family": "", ... "containerDefinitions" : [ { "mountPoints" : [ { "containerPath" : "/path/to/mount_volume", "sourceVolume" : "string" } ], "name" : "string" } ], ... "volumes" : [ { "host" : { "sourcePath" : "string" }, "name" : "string" } ] }
name

型: 文字列

必須: いいえ

ボリュームの名前。最大 255 文字の英字 (大文字と小文字)、数字、ハイフン、アンダースコアを使用できます。この名前は、コンテナの定義 mountPoints オブジェクトの sourceVolume パラメータで参照されます。

host

必須: いいえ

バインドマウントを使用する場合、このパラメータが指定されます。Docker ボリュームを使用するには、代わりに dockerVolumeConfiguration を指定します。host パラメータの内容により、バインドマウントのデータボリュームがホストコンテナインスタンスで保持されるかどうかと、その保存場所が決まります。host パラメーターが空の場合、Docker デーモンはデータボリュームのホストパスを割り当てますが、関連付けられたコンテナの実行が停止した後にデータが保持されるとは限りません。

バインドマウントのホストボリュームは、EC2 起動タイプ、または Fargate 起動タイプ使用時にサポートされています。

Windows コンテナは $env:ProgramData と同じドライブに全部のディレクトリをマウントできます。

sourcePath

型: 文字列

必須: いいえ

host パラメータを使用する場合は、sourcePath を指定して、コンテナに表示されるホストコンテナインスタンスのパスを宣言します。このパラメータが空の場合は、Docker デーモンによってホストパスが割り当てられています。host パラメータに sourcePath の場所が含まれている場合、データボリュームは手動で削除するまでホストコンテナインスタンスの指定された場所に保持されます。sourcePath の場所がホストコンテナインスタンスに存在しない場は、Docker デーモンによって作成されます。その場所が存在する場合は、ソースパスフォルダーの内容がエクスポートされます。

mountPoints

タイプ: オブジェクト配列

必須: いいえ

コンテナでのデータボリュームのマウントポイント。

このパラメータは、Docker Remote APIコンテナを作成する セクションの Volumes にマッピングし、--volume オプションを docker run にマッピングします。

Windows コンテナは $env:ProgramData と同じドライブに全部のディレクトリをマウントできます。Windows コンテナは、別のドライブにディレクトリをマウントできません。また、マウントポイントは複数のドライブにまたがることはできません。

sourceVolume

タイプ: 文字列

必須: はい (mountPoints を使用する場合)

マウントするボリュームの名前。

containerPath

タイプ: 文字列

必須: はい (mountPoints を使用する場合)

ボリュームをマウントするコンテナ上のパス。

readOnly

タイプ: ブール値

必須: いいえ

この値が true の場合、コンテナはボリュームへの読み取り専用アクセスを許可されます。この値が false の場合、コンテナはボリュームに書き込むことができます。デフォルト値は false です。

バインドマウントを使用してコンテナの空の非永続ストレージを提供するには

場合によっては、コンテナで同じ空のデータボリュームを共有する必要があるが、タスクが終了した後にデータが保持されなくても構わないことがあります。たとえば、タスクの実行中に同じスクラッチファイルの保存場所にアクセスする必要のある 2 つのデータベースコンテナがあるとします。このタスクは、Docker ボリューム、またはバインドマウントのホストボリュームを使用して行うことができます。

  1. タスク定義の volumes セクションで、名前を database_scratch としてバインドマウントを定義します。

    注記

    database_scratch バインドマウントではソースパスを指定しないため、バインドマウントは Docker デーモンによって管理されます。このバインドマウントを参照しているコンテナがないと、そのボリュームは Amazon ECS コンテナエージェントのタスククリーンアップサービスによって、最終的に削除されます (デフォルトでは、コンテナが終了してから 3 時間後に削除されますが、この期間はエージェント変数 ECS_ENGINE_TASK_CLEANUP_WAIT_DURATION で設定できます)。詳細については、「Amazon ECS コンテナエージェントの設定」を参照してください。このデータを保持する必要がある場合は、バインドマウントに値 sourcePath を指定します。

    "volumes": [ { "name": "database_scratch", "host": {} } ]
  2. containerDefinitions セクションで、非永続ストレージをマウントするようにデータベースのコンテナの定義を作成します。

    "containerDefinitions": [ { "name": "database1", "image": "my-repo/database", "cpu": 100, "memory": 100, "essential": true, "mountPoints": [ { "sourceVolume": "database_scratch", "containerPath": "/var/scratch" } ] }, { "name": "database2", "image": "my-repo/database", "cpu": 100, "memory": 100, "essential": true, "mountPoints": [ { "sourceVolume": "database_scratch", "containerPath": "/var/scratch" } ] } ]

バインドマウントを使用してコンテナの永続的ストレージを提供するには

バインドマウントを使用する際、sourcePath 値を指定していると、データボリュームは、そのボリュームを参照しているコンテナがすべて停止した後も保持されます。sourcePath に存在するファイルは、containerPath 値のコンテナに渡され、containerPath 値に書き込まれたファイルは、コンテナインスタンスの sourcePath 値に書き込まれます。

重要

Amazon ECS は、コンテナインスタンス間でストレージを同期しません。永続的ストレージを使用するタスクは、使用可能なキャパシティーのあるクラスター内のコンテナインスタンスに配置できます。タスクを停止して再び開始した後に永続的ストレージが必要な場合は、タスクの開始時に毎回、AWS CLI の start-task コマンドを使用して同じコンテナインスタンスを指定する必要があります。

  1. タスク定義の volumes セクションで、name および sourcePath 値を使用して、バインドマウントを定義します。

    "volumes": [ { "name": "webdata", "host": { "sourcePath": "/ecs/webdata" } } ]
  2. containerDefinitions セクションで、定義したバインドマウントの名前を参照する mountPoints 値と、コンテナにバインドマウントをマウントするための containerPath 値を使用して、コンテナを定義します。

    "containerDefinitions": [ { "name": "web", "image": "nginx", "cpu": 99, "memory": 100, "portMappings": [ { "containerPort": 80, "hostPort": 80 } ], "essential": true, "mountPoints": [ { "sourceVolume": "webdata", "containerPath": "/usr/share/nginx/html" } ] } ]

定義したボリュームを複数のコンテナにマウントするには

タスク定義でデータボリュームを定義し、そのボリュームをさまざまなコンテナのさまざまな場所にマウントできます。たとえば、ホストコンテナにウェブサイトのデータフォルダ /data/webroot があり、さまざまなドキュメントルートのある 2 つの異なるウェブサーバーに、そのデータボリュームを読み取り専用としてマウントするとします。

  1. タスク定義の volumes セクションで、名前を webroot、ソースパスを /data/webroot としてデータボリュームを定義します。

    "volumes": [ { "name": "webroot", "host": { "sourcePath": "/data/webroot" } } ]
  2. containerDefinitions セクションで、各ウェブサーバーのコンテナを定義しています。各コンテナの mountPoints で、webroot ボリュームを、そのコンテナのドキュメントルートを参照する containerPath 値に関連付けます。

    "containerDefinitions": [ { "name": "web-server-1", "image": "my-repo/ubuntu-apache", "cpu": 100, "memory": 100, "portMappings": [ { "containerPort": 80, "hostPort": 80 } ], "essential": true, "mountPoints": [ { "sourceVolume": "webroot", "containerPath": "/var/www/html", "readOnly": true } ] }, { "name": "web-server-2", "image": "my-repo/sles11-apache", "cpu": 100, "memory": 100, "portMappings": [ { "containerPort": 8080, "hostPort": 8080 } ], "essential": true, "mountPoints": [ { "sourceVolume": "webroot", "containerPath": "/srv/www/htdocs", "readOnly": true } ] } ]

volumesFrom を使用して別のコンテナからボリュームをマウントするには

あるコンテナに 1 つ以上のボリュームを定義し、同じタスクの異なるコンテナ定義で volumesFrom パラメータを使用して、sourceContainer のすべてのボリュームを、最初に定義されていたマウントポイントにマウントできます。volumesFrom パラメータは、タスク定義で定義されたボリューム、および Dockerfile でイメージに組み込まれたボリュームに適用されます。

  1. (オプション) イメージに組み込まれたボリュームを共有するには、そのボリュームを VOLUME 命令で宣言してイメージを構築する必要があります。次の例では、Dockerfile は httpd イメージを使用し、ボリュームを追加して、Apache ドキュメントルート (httpd ウェブサーバーで使用されるフォルダ) の dockerfile_volume にマウントします。

    FROM httpd VOLUME ["/usr/local/apache2/htdocs/dockerfile_volume"]

    この Dockerfile を使用してイメージを構築し、Docker ハブなどのレポジトリにプッシュして、タスク定義で使用できます。以下の手順で例として使用する my-repo/httpd_dockerfile_volume イメージは上記の Dockerfile から構築しました。

  2. コンテナの他のボリュームとマウントポイントを定義するタスク定義を作成します。この例の volumes セクションでは、Docker デーモンによって管理される空のボリューム empty を作成します。また、ホストコンテナインスタンスに /etc をエクスポートするホストボリューム host_etc も定義しています。

    { "family": "test-volumes-from", "volumes": [ { "name": "empty", "host": {} }, { "name": "host_etc", "host": { "sourcePath": "/etc" } } ],

    コンテナ定義セクションで、先ほど定義したボリュームをマウントするコンテナを作成します。この例の web コンテナ (Dockerfile で指定されたボリュームで構築されたイメージを使用) は empty ボリュームと host_etc ボリュームをマウントします。

    "containerDefinitions": [ { "name": "web", "image": "my-repo/httpd_dockerfile_volume", "cpu": 100, "memory": 500, "portMappings": [ { "containerPort": 80, "hostPort": 80 } ], "mountPoints": [ { "sourceVolume": "empty", "containerPath": "/usr/local/apache2/htdocs/empty_volume" }, { "sourceVolume": "host_etc", "containerPath": "/usr/local/apache2/htdocs/host_etc" } ], "essential": true },

    volumesFrom を使用して、web コンテナに関連付けられているすべてのボリュームをマウントする、別のコンテナを作成します。web コンテナのすべてのボリュームは busybox コンテナ (my-repo/httpd_dockerfile_volume イメージの構築に使用された Dockerfile で指定されたボリュームを含む) にも同様にマウントされます。

    { "name": "busybox", "image": "busybox", "volumesFrom": [ { "sourceContainer": "web" } ], "cpu": 100, "memory": 500, "entryPoint": [ "sh", "-c" ], "command": [ "echo $(date) > /usr/local/apache2/htdocs/empty_volume/date && echo $(date) > /usr/local/apache2/htdocs/host_etc/date && echo $(date) > /usr/local/apache2/htdocs/dockerfile_volume/date" ], "essential": false } ] }

    このタスクが実行されると、2 つのコンテナでボリュームがマウントされ、busybox コンテナで command が各ボリュームフォルダの date という名前のファイルに日付と時刻を書き込みます。その後、フォルダは web コンテナによって表示されるウェブサイトで見ることができます。

    注記

    busybox コンテナはクイックコマンドを実行して終了するため、コンテナ定義で "essential": false として設定する必要があります。そうしなければ、終了時にタスク全体が停止します。