docker-compose build时GPU配置报错：devices不匹配正则'^x-'

问题根源 #

你的错误来自两个核心点：

1. docker-compose build 会校验整个Compose文件的语法合法性，但你使用的docker-compose 1.29.2版本不支持deploy.resources.reservations.devices这个Swarm集群专属字段，所以构建时触发了正则匹配错误（该版本只允许deploy下以x-开头的自定义字段）。
2. docker-compose up 在非Swarm模式下会自动忽略Swarm专属的deploy资源配置，所以你先移除deploy构建镜像、再加回配置后能正常启动并使用GPU。

解决方案 #

方案1：拆分构建与运行的配置文件

创建两个配置文件，分别处理构建和运行逻辑：

• 新建docker-compose.build.yml（仅用于构建，移除Swarm专属字段）：

services:
  notebook:
    build: .
    ports:
      - 8887:8887
    volumes:
      - ./:/home/pae/
      - ./models:/home/pae/models
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
      - /mnt/zdisk:/home/pae/data/zdisk
    stdin_open: true
    tty: true
    command: " jupyter-notebook --allow-root --no-browser --ip=0.0.0.0 --port=8887"
    restart: always
    image: pae_notebook:latest

• 保留原docker-compose.yml不变，执行命令：
  • 构建镜像：docker-compose -f docker-compose.build.yml build
  • 启动容器：docker-compose up -d

方案2：升级docker-compose到兼容版本

将docker-compose升级到v2.10及以上版本，新版本在非Swarm模式下执行build时会自动忽略Swarm专属的deploy资源配置，不会触发语法校验错误。

方案3：改用非Swarm模式的GPU配置

替换Swarm风格的deploy字段为传统的runtime配置（需提前安装nvidia-docker2），这样构建和启动都能正常执行：
修改后的docker-compose.yml：

services:
  notebook:
    build: .
    ports:
      - 8887:8887
    volumes:
      - ./:/home/pae/
      - ./models:/home/pae/models
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
      - /mnt/zdisk:/home/pae/data/zdisk
    stdin_open: true
    tty: true
    command: " jupyter-notebook --allow-root --no-browser --ip=0.0.0.0 --port=8887"
    restart: always
    image: pae_notebook:latest
    runtime: nvidia

注意：此方案需要确保已安装nvidia-docker2，且Docker daemon已配置nvidia runtime支持。

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