使用CloudFormation为AWS Batch作业定义挂载EFS卷的正确配置方法

AWS Batch CloudFormation 作业定义的属性校验规则和ECS任务定义不通用，直接照搬ECS教程里的EfsVolumeConfiguration配置块，会因为Batch的Volumes schema未收录该属性触发校验失败。

前置准备 #

• 核对计算环境启动类型：分EC2/SPOT节点型、Fargate无服务器型，两类环境的EFS挂载逻辑完全不同
• 确认目标EFS（fs-9999999）的挂载目标和计算环境子网对齐，安全组规则放行计算节点/Fargate任务访问EFS的2049 NFS端口

节点型（EC2/SPOT）计算环境配置 #

这类环境不支持在作业定义内直接声明EFS卷，需要先在主机层完成挂载，再通过主机路径映射给容器：

1. 修改计算环境关联的启动模板，在用户数据中添加EFS自动挂载逻辑，把fs-9999999固定挂载到所有节点的指定路径，比如 /mnt/efs/EFS-000
2. 在CloudFormation的AWS::Batch::JobDefinition资源的ContainerProperties块中，替换原来的EFS配置为Host路径映射，示例：

   ContainerProperties:
    # 其他原有配置省略
    Volumes:
      - Name: EFS-000
        Host:
          SourcePath: /mnt/efs/EFS-000
    MountPoints:
      - ContainerPath: /app/data  # 容器内可访问EFS的路径
        SourceVolume: EFS-000     # 和Volumes的Name一一对应
        ReadOnly: false
   

3. 该场景下不要在Volumes条目内添加EfsVolumeConfiguration块，否则会再次触发属性校验错误。

Fargate无服务器型计算环境配置 #

这类环境支持作业定义内嵌EFS配置，需匹配CloudFormation的属性schema，正确配置如下：

1. 确认作业定义关联的Fargate平台版本为1.4.0及以上（该版本开始支持EFS挂载）
2. 在ContainerProperties块中按结构配置卷和挂载点，示例：

   ContainerProperties:
    # 其他原有配置省略
    PlatformCapabilities:
      - FARGATE
    FargatePlatformConfiguration:
      PlatformVersion: 1.4.0
    Volumes:
      - Name: EFS-000
        EfsVolumeConfiguration:
          FileSystemId: fs-9999999
          TransitEncryption: ENABLED
          RootDirectory: /  # 可选，指定EFS上映射到容器的根路径
    MountPoints:
      - ContainerPath: /app/data
        SourceVolume: EFS-000
        ReadOnly: false
   

3. 若依然触发EfsVolumeConfiguration属性不支持的报错，说明当前区域的CloudFormation Batch服务尚未同步该属性的schema，可通过自定义资源调用Batch CreateJobDefinition API绕过CFN校验，或等待服务版本更新后重试。

• 不要把ECS任务定义的配置结构直接套用到Batch作业定义：Batch的所有容器相关配置都嵌套在ContainerProperties内部，不存在ECS任务定义里和容器定义平级的独立volumes根配置块
• 确保MountPoints的SourceVolume和对应Volumes的Name完全一致，否则容器启动后会找不到指定挂载卷
• 节点型计算环境下，作业定义的Host路径映射只是引用主机上已存在的文件系统路径，不会自动完成EFS的网络挂载动作

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