配置Gitlab CI/CD后本地Docker Compose无法构建Django项目的问题

问题根源是：CI_REGISTRY、CI_ENVIRONMENT_SLUG、CI_COMMIT_SHA 是GitLab CI的预定义变量，仅在GitLab Runner执行流水线时自动注入，本地环境不存在这些变量，导致docker-compose解析.env时因变量未定义报错。

以下是几种可行的解决思路：

1. 给镜像地址设置本地默认值 #

修改docker-compose.yml中的镜像引用，使用Shell变量默认值语法，当本地无NEW_VAR时自动使用本地镜像名：

services:
  app:
    image: ${NEW_VAR:-local-django-app:dev}
    # 其他配置...
  bot:
    image: ${NEW_VAR:-local-django-bot:dev}
    # 其他配置...

本地运行时，docker-compose会自动使用冒号后的默认镜像名；CI流水线中，GitLab会注入NEW_VAR对应的完整镜像地址，覆盖默认值。

2. 本地.env添加占位符变量 #

在本地的.env文件中，给GitLab CI相关变量添加本地用的占位值，避免变量未定义：

# 本地开发用的占位值，CI时会被GitLab预定义变量覆盖
CI_REGISTRY=localhost:5000
CI_ENVIRONMENT_SLUG=local
CI_COMMIT_SHA=dev

NEW_VAR=$CI_REGISTRY/<gitlab username>/<repository name>/custom_image:$CI_ENVIRONMENT_SLUG-$CI_COMMIT_SHA

注意：将这个本地.env添加到.gitignore中，不要提交到仓库，避免和CI环境配置冲突。

3. CI流水线动态生成.env文件 #

不在本地.env中写入带CI变量的NEW_VAR，而是在.gitlab-ci.yml中动态生成CI专用的.env配置：

1. 创建.env.base文件，存放本地和CI共用的基础变量（如数据库配置等）。
2. 在.gitlab-ci.yml的before_script中生成CI专用变量并合并到.env：

before_script:
  - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
  # 复制基础配置
  - cp .env.base .env
  # 动态添加CI专用的NEW_VAR
  - echo "NEW_VAR=$CI_REGISTRY/<gitlab username>/<repository name>/custom_image:$CI_ENVIRONMENT_SLUG-$CI_COMMIT_SHA" >> .env

本地开发时直接使用.env.base（或复制为.env），里面仅保留本地所需变量，不会包含CI相关的未定义变量。

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