使用 `sameersbn/docker-redmine` 部署 Redmine 的详细指南

1. 项目目录结构及介绍

在 sameersbn/docker-redmine 项目中，主要的目录和文件包括：

• Dockerfile: 定义了构建 Docker 镜像的指令。
• docker-compose.yml: 示例文件，用于通过 Docker Compose 快速启动 Redmine 及其依赖服务（如 PostgreSQL）。
• /scripts: 包含启动、初始化脚本等，用于容器内部自动化配置。
• /config: 提供默认配置示例，例如 database.yml.example 和 initializers/session_store.rb.example。

这些文件共同工作，使您能够快速部署一个完整的 Redmine 环境。

2. 项目启动文件介绍

Docker Compose 启动

要使用 docker-compose.yml 文件启动 Redmine 和 PostgreSQL，首先确保 Docker Compose 已安装，然后在项目根目录执行以下命令：

docker-compose up

这将自动创建并运行两个容器：一个作为 Redmine 应用服务器，另一个作为数据存储的 PostgreSQL 服务。

手动启动

如果您选择手动启动，可以分为两步：

步骤 1：启动 PostgreSQL 容器

docker run --name=postgresql-redmine -d \
    --env='DB_NAME=redmine_production' \
    --env='DB_USER=redmine' --env='DB_PASS=password' \
    --volume=/srv/docker/redmine/postgresql:/var/lib/postgresql \
    sameersbn/postgresql:14-20230628

步骤 2：启动 Redmine 容器

docker run --name=redmine -d \
    --link=postgresql-redmine:postgresql --publish=10083:80 \
    --env='REDMINE_PORT=10083' \
    sameersbn/redmine:5 1 3

这里，sameersbn/redmine:5 1 3 是 Redmine 版本号，可以根据需要更改到最新的可用版本。

3. 项目的配置文件介绍

• config/database.yml: 这个文件定义了 Redmine 数据库连接的参数。可以通过环境变量来覆盖它们，例如在上面的手动启动命令中设置 DB_NAME, DB_USER, DB_PASS。
• config/initializers/session_store.rb: 控制 Redmine 的会话存储机制。
• config/environments/*.rb: 不同环境（如 development, production）的特定配置。

注: 在实际生产环境中，通常不会直接修改镜像内的配置文件，而是使用 Docker 体积挂载将外部配置文件映射到容器内，以便于更新和持久化。

为了自定义配置，可以在主机上创建相应的配置文件副本，然后通过 -v 参数将它们挂载到容器内。例如：

-v /path/to/config/database.yml:/opt/redmine/config/database.yml \
-v /path/to/config/initializers/session_store.rb:/opt/redmine/config/initializers/session_store.rb

如此，任何对主机上配置文件的修改都会立即反映到运行中的 Redmine 实例中。