CDK部署ECS TaskDefinition失败报Unknown volume 'null'错误

问题根源 #

你遇到的Unknown volume: 'null'报错由CloudFormation模板中的非法配置直接导致：ContainerDefinitions下的MountPoints字段配置为[{}]，空挂载对象没有指定关联的卷名与容器内路径，ECS解析该配置时会读取到空的卷引用，触发对应报错。
仅添加1个卷时部署成功属于偶发兼容情况，当卷数量≥2时，ECS的配置校验逻辑会直接识别到非法的空挂载配置并拦截部署。你通过ECS控制台手动添加卷不会触发该问题，是因为控制台会自动为新增卷生成合法的挂载点配置，不会生成空挂载对象。

另外你提供的模板中Tags数组末尾存在多余尾逗号，也可能引发CloudFormation校验异常，建议同步修正。

修复方案 #

1. 直接修改CloudFormation模板 #

将MountPoints字段替换为以下合法配置，匹配你定义的3个卷与Datadog Agent的挂载要求：

"MountPoints": [
  {
    "SourceVolume": "docker_sock",
    "ContainerPath": "/var/run/docker.sock",
    "ReadOnly": true
  },
  {
    "SourceVolume": "proc",
    "ContainerPath": "/host/proc",
    "ReadOnly": true
  },
  {
    "SourceVolume": "cgroup",
    "ContainerPath": "/host/sys/fs/cgroup",
    "ReadOnly": true
  }
]

同时删除Tags数组中最后一个元素后的多余逗号。

2. CDK代码层面修复（从根源避免错误） #

在CDK中定义容器后，必须显式调用挂载点添加方法关联预先定义的卷，不要留空的挂载点配置。以TypeScript CDK为例参考写法：

// 定义EC2类型任务定义
const datadogTask = new ecs.Ec2TaskDefinition(this, 'MonitoringTask', {
  family: 'datadog-agent-task',
  networkMode: ecs.NetworkMode.BRIDGE
});

// 添加3个宿主机绑定卷
datadogTask.addVolume({ name: 'docker_sock', host: { sourcePath: '/var/run/docker.sock' } });
datadogTask.addVolume({ name: 'proc', host: { sourcePath: '/proc/' } });
datadogTask.addVolume({ name: 'cgroup', host: { sourcePath: '/sys/fs/cgroup/' } });

// 添加Datadog Agent容器
const agentContainer = datadogTask.addContainer('datadog', {
  image: ecs.ContainerImage.fromRegistry('datadog/agent:latest'),
  essential: true,
  cpu: 10,
  memoryReservationMiB: 256,
  environment: { DD_SITE: 'datadoghq.com' },
  logging: ecs.LogDrivers.awsLogs({ logGroup: yourLogGroup, region: 'eu-west-1' })
});

// 核心步骤：为容器关联所有挂载点，不可遗漏
agentContainer.addMountPoints(
  { sourceVolume: 'docker_sock', containerPath: '/var/run/docker.sock', readOnly: true },
  { sourceVolume: 'proc', containerPath: '/host/proc', readOnly: true },
  { sourceVolume: 'cgroup', containerPath: '/host/sys/fs/cgroup', readOnly: true }
);

内容的提问来源于stack exchange，提问作者Simon Gill