如何通过GitLab CI/CD变量设置Docker容器资源限制？

问题背景 #

已能在docker-compose.yml中固定配置Docker容器资源限制：

resources:
  limits:
    cpus: '2'
    memory: 4GB
  reservations:
    cpus: '1'
    memory: 4GB

希望像之前通过GitLab变量覆盖Java堆内存（java_xmx=${JAVA_XMX_OVERRIDE}，变量值JAVA_XMX_OVERRIDE: "-Xmx2048m"）一样，将Docker资源限制参数通过GitLab流水线变量动态传递。

实现步骤 #

1. 修改docker-compose.yml引入变量 #

将固定的资源限制值替换为GitLab变量，可添加默认值（防止未传变量时容器启动失败）：

resources:
  limits:
    cpus: '${DOCKER_CPU_LIMIT:-2}'
    memory: ${DOCKER_MEM_LIMIT:-4GB}
  reservations:
    cpus: '${DOCKER_CPU_RESERVATION:-1}'
    memory: ${DOCKER_MEM_RESERVATION:-4GB}

注意：cpus的值需要用单引号包裹变量，避免YAML解析时将数字格式的变量识别为数值类型（Docker要求cpus为字符串格式）。

2. 在GitLab中配置流水线变量 #

有两种方式设置变量：

方式一：项目CI/CD设置页面配置

进入项目的Settings > CI/CD > Variables，添加以下变量：

• DOCKER_CPU_LIMIT：值如'2'或'1.5'
• DOCKER_MEM_LIMIT：值如4GB或2048m
• DOCKER_CPU_RESERVATION：值如'1'
• DOCKER_MEM_RESERVATION：值如4GB

方式二：在.gitlab-ci.yml中定义变量

如果需要针对特定流水线阶段设置变量，可直接在流水线配置文件中定义：

variables:
  DOCKER_CPU_LIMIT: '2'
  DOCKER_MEM_LIMIT: 4GB
  DOCKER_CPU_RESERVATION: '1'
  DOCKER_MEM_RESERVATION: 4GB

# 流水线任务示例
deploy:
  script:
    - docker-compose up -d

3. 验证变量生效 #

流水线执行时，Docker Compose会自动替换变量值，启动容器时应用对应的资源限制。可通过docker stats命令查看容器的资源限制是否符合预期。

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