AWS::ECS::TaskDefinition Volume - AWS CloudFormation

AWS::ECS::TaskDefinition Volume

Volume プロパティは、タスク定義で使用されるデータボリュームを指定します。Docker ボリュームを使用するDockerVolumeConfiguration を指定します。バインドマウントのホストボリュームを使用するタスクで、host とオプションの sourcePath を指定します。詳細については、「タスクでのデータボリュームの使用」を参照してください。

構文

AWS CloudFormation テンプレートでこのエンティティを宣言するには、次の構文を使用します。

プロパティ

DockerVolumeConfiguration

このパラメータは、Docker ボリュームを使用する場合に指定します。Docker ボリュームは、EC2 起動タイプを使用する場合にのみサポートされます。Windows コンテナでは、local ドライバーの使用のみサポートされます。バインドマウントを使用するには、代わりに host パラメータを指定します。

必須: いいえ

タイプ: DockerVolumeConfiguration

Update requires: Replacement

EFSVolumeConfiguration

このパラメータは、タスクストレージに Amazon Elastic File System を使用している場合に指定します。

必須: いいえ

タイプ: EFSVolumeConfiguration

Update requires: Replacement

Host

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

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

必須: いいえ

タイプ: HostVolumeProperties

Update requires: Replacement

Name

ボリュームの名前。最大 255 文字の英字 (大文字と小文字)、数字、ハイフンを使用できます。この名前は、コンテナ定義 sourceVolumemountPoints パラメータで参照されます。

必須: いいえ

タイプ: 文字列

Update requires: Replacement