如何使用Docker Compose声明变量修改Django模板及文件夹名称等内容

Docker Compose完全支持该需求，你可以通过环境变量传参+模板渲染的方式实现执行docker-compose run时动态修改配置、自定义文件夹名称的效果，具体实现步骤如下：

1. 定义环境变量传递规则 #

你可以选择两种方式传递变量，执行docker-compose run时传入的变量优先级最高，会覆盖默认配置：

• 执行命令时直接传参，示例：

  docker-compose run -e PROJECT_NAME=my_custom_django -e EXTRA_APPS=rest_framework,debug_toolbar django_template
  

• 在docker-compose.yml中配置默认变量，示例：

  version: '3.8'
  services:
    django_template:
      build: .
      environment:
        # 预设默认值，执行run命令时传参会自动覆盖
        - PROJECT_NAME=default_django
        - EXTRA_APPS=debug_toolbar
      volumes:
        # 挂载本地目录方便直接获取生成的模板文件
        - ./output:/app/output
  

2. 编写模板文件 #

你需要把需要动态修改的Django配置、文件夹命名规则提前写成带占位符的模板文件，两种常用方案可选：

方案A：envsubst轻量渲染（适合简单替换场景） #

不需要额外安装依赖，直接用系统自带的envsubst工具实现占位符替换，模板示例（settings.py.template）：

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    # 占位符和环境变量名保持一致
    ${EXTRA_APPS}
]

方案B：Jinja2模板渲染（适合复杂逻辑场景） #

如果需要实现多APP批量插入、条件判断等复杂逻辑，可以安装j2cli工具渲染Jinja2模板，模板示例（settings.py.j2）：

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    {% for app in EXTRA_APPS.split(',') %}
    '{{ app.strip() }}',
    {% endfor %}
]

3. 配置启动脚本实现自动处理 #

编写entrypoint启动脚本，在容器启动时自动完成变量替换、文件夹创建、文件生成的逻辑，示例entrypoint.sh：

#!/bin/bash
# 1. 动态创建项目文件夹
mkdir -p /app/output/${PROJECT_NAME}
# 2. 渲染配置文件（二选一即可）
# 方案A渲染命令
envsubst < /app/templates/settings.py.template > /app/output/${PROJECT_NAME}/settings.py
# 方案B渲染命令
# j2 /app/templates/settings.py.j2 > /app/output/${PROJECT_NAME}/settings.py
# 3. 复制其他固定模板文件到目标目录
cp -r /app/templates/static /app/templates/urls.py /app/output/${PROJECT_NAME}/
# 4. 执行后续传入的命令
exec "$@"

在Dockerfile中配置启动脚本权限：

# 省略其他镜像构建步骤
COPY entrypoint.sh /entrypoint.sh
RUN chmod +x /entrypoint.sh
ENTRYPOINT ["/entrypoint.sh"]

4. 效果验证 #

执行自定义参数的run命令后，挂载的本地./output目录下会生成对应名称的Django项目文件夹，settings.py中的INSTALLED_APPS会自动填入你传入的配置项。

注意：如果替换内容包含引号、特殊字符，优先使用Jinja2渲染方案，避免envsubst转义异常。

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