单容器参数化运行多项目的最佳实践实现方案问询

这里有一套经过验证的方案，能完美实现你的需求——用单个Docker容器打包所有小型项目，通过命令行参数指定目标项目和运行环境（prod/dev），自动调用对应项目的run.sh脚本执行。

1. 编写容器入口脚本（entrypoint.sh） #

首先创建一个入口脚本，作为容器启动后的核心逻辑处理程序，负责解析传入的参数、定位项目目录、校验参数合法性并执行对应脚本。将这个脚本放在你的MAIN_PROJECT_FOLDER根目录下：

#!/bin/bash
set -euo pipefail

# 解析命令行参数：第一个参数是项目名，第二个是环境模式（默认dev）
PROJECT_NAME="$1"
ENV_MODE="${2:-dev}"

# 容器内的项目根目录（和Dockerfile中WORKDIR对应）
PROJECT_ROOT="/app"

# 遍历所有子分类目录，查找目标项目的路径
PROJECT_PATH=""
for CATEGORY_DIR in "$PROJECT_ROOT"/*; do
    if [ -d "$CATEGORY_DIR/$PROJECT_NAME" ]; then
        PROJECT_PATH="$CATEGORY_DIR/$PROJECT_NAME"
        break
    fi
done

# 校验：检查目标项目是否存在
if [ -z "$PROJECT_PATH" ]; then
    echo "❌ 错误：未找到项目 '$PROJECT_NAME'"
    echo "📋 可用项目列表："
    # 列出所有项目名称
    find "$PROJECT_ROOT" -mindepth 2 -maxdepth 2 -type d | awk -F/ '{print "  - " $NF}' | sort
    exit 1
fi

# 校验：检查环境模式是否合法
if [[ "$ENV_MODE" != "prod" && "$ENV_MODE" != "dev" ]]; then
    echo "❌ 错误：环境参数只能是 'prod' 或 'dev'，当前传入的是 '$ENV_MODE'"
    exit 1
fi

# 执行目标项目的run.sh脚本
echo "🚀 开始运行项目：$PROJECT_NAME，模式：$ENV_MODE"
cd "$PROJECT_PATH"
./run.sh "$ENV_MODE"

说明：

• set -euo pipefail开启严格模式，避免脚本因隐藏错误继续执行
• 自动遍历所有子分类目录查找项目，无需硬编码分类路径
• 提供友好的错误提示和项目列表，方便排查问题
• 支持省略环境参数，默认使用dev模式

2. 编写Dockerfile #

接下来编写Dockerfile，将所有项目和入口脚本打包到容器中，配置好运行环境：

# 选择适合的基础镜像（你的项目基于Python，这里用官方轻量镜像）
FROM python:3.9-slim

# 设置容器内的工作目录
WORKDIR /app

# 复制所有项目子分类目录到容器内
COPY PROJECT_SUB_CATEGORY1 /app/PROJECT_SUB_CATEGORY1
COPY PROJECT_SUB_CATEGORY2 /app/PROJECT_SUB_CATEGORY2

# 复制入口脚本到容器
COPY entrypoint.sh /app/entrypoint.sh

# 添加执行权限：给入口脚本和所有项目的run.sh赋予执行权限
RUN chmod +x /app/entrypoint.sh \
    && find /app -name "run.sh" -exec chmod +x {} \;

# 可选：如果项目有Python依赖，提前安装（示例：遍历每个项目的requirements.txt）
# RUN find /app -name "requirements.txt" -exec pip install -r {} \;

# 设置容器的入口点为我们的脚本
ENTRYPOINT ["/app/entrypoint.sh"]

关键要点：

• 使用轻量级基础镜像减少镜像体积
• 严格保持本地项目目录结构和容器内一致
• 提前设置所有脚本的执行权限，避免运行时权限错误
• 如果项目有依赖，可在Dockerfile中提前安装，提升运行效率

3. 构建与运行容器 #

构建镜像 #

在MAIN_PROJECT_FOLDER根目录下执行构建命令：

sudo docker build -t test_container .

运行示例 #

按照你需求的格式执行命令即可：

# 运行test_project1的prod模式
sudo docker run test_container test_project1 prod

# 运行test_project2的dev模式（可省略第二个参数，默认dev）
sudo docker run test_container test_project2

# 运行test_project1的dev模式（显式指定）
sudo docker run test_container test_project1 dev

额外优化建议 #

• 添加.dockerignore文件：排除.git、__pycache__、*.log等不需要打包的文件，减少镜像体积
• 环境变量支持：如果项目需要自定义环境变量，可在Dockerfile中用ENV声明，或运行时用-e参数传递
• 日志持久化：如果需要保留项目日志，可通过-v参数挂载本地目录到容器内的日志目录
• 健康检查：可在Dockerfile中添加HEALTHCHECK指令，监控项目运行状态

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