vzvu3k6k/redmine

Redmine Docker镜像文档

镜像概述

本镜像为Redmine项目管理系统的Docker化部署方案，基于https://github.com/docker-library/redmine%E5%88%86%E5%8F%89%E5%BC%80%E5%8F%91%EF%BC%8C%E7%89%B9%E7%82%B9%E6%98%AF%E6%AF%8F%E6%97%A5%E5%90%8C%E6%AD%A5Redmine%E6%9C%80%E6%96%B0%E4%B8%BB%E5%B9%B2%E4%BB%A3%E7%A0%81%E6%9B%B4%E6%96%B0%EF%BC%8C%E7%A1%AE%E4%BF%9D%E7%94%A8%E6%88%B7%E8%83%BD%E8%8E%B7%E5%8F%96%E6%9C%80%E6%96%B0%E5%8A%9F%E8%83%BD%E5%92%8C%E4%BF%AE%E5%A4%8D%E3%80%82Redmine%E6%98%AF%E4%B8%80%E6%AC%BE%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE%E7%AE%A1%E7%90%86%E5%92%8C%E9%97%AE%E9%A2%98%E8%B7%9F%E8%B8%AA%E5%B7%A5%E5%85%B7%EF%BC%8C%E6%94%AF%E6%8C%81%E5%A4%9A%E9%A1%B9%E7%9B%AE%E7%AE%A1%E7%90%86%E3%80%81%E4%BB%BB%E5%8A%A1%E8%B7%9F%E8%B8%AA%E3%80%81%E6%96%87%E6%A1%A3%E7%AE%A1%E7%90%86%E3%80%81%E7%89%88%E6%9C%AC%E6%8E%A7%E5%88%B6%E9%9B%86%E6%88%90%E7%AD%89%E5%8A%9F%E8%83%BD%E3%80%82

核心功能与特性

• 每日更新：自动同步Redmine官方主干代码，每日构建最新版本镜像
• 兼容性：基于官方Redmine镜像构建，保持与标准Redmine部署的兼容性
• 功能完整：包含Redmine核心功能，如项目管理、问题跟踪、用户权限管理、时间跟踪、文档管理等
• 轻量部署：通过Docker容器化部署，简化环境配置，降低部署复杂度

使用场景

• 开发环境：需要测试Redmine最新功能的开发团队
• 测试环境：验证Redmine新特性或修复的QA环境
• 动态更新需求：对Redmine功能迭代有较高要求的生产环境

使用方法

基本运行

使用以下命令快速启动Redmine容器（默认使用SQLite数据库，适用于测试环境）：

bash
docker run -d -p 3000:3000 --name redmine vzvu3k6k/redmine

启动后，通过http://localhost:3000访问Redmine，默认管理员账号：admin，密码：admin。

连接外部数据库（推荐生产环境）

Redmine支持MySQL、PostgreSQL等外部数据库，需通过环境变量配置数据库连接信息：

MySQL示例

bash
docker run -d \
  -p 3000:3000 \
  --name redmine \
  -e DB_ADAPTER=mysql2 \
  -e DB_HOST=mysql-host \
  -e DB_PORT=3306 \
  -e DB_NAME=redmine \
  -e DB_USER=redmine_user \
  -e DB_PASSWORD=redmine_password \
  vzvu3k6k/redmine

PostgreSQL示例

bash
docker run -d \
  -p 3000:3000 \
  --name redmine \
  -e DB_ADAPTER=postgresql \
  -e DB_HOST=postgres-host \
  -e DB_PORT=5432 \
  -e DB_NAME=redmine \
  -e DB_USER=redmine_user \
  -e DB_PASSWORD=redmine_password \
  vzvu3k6k/redmine

数据持久化

为避免容器重启导致数据丢失，需挂载持久化卷存储Redmine文件和配置：

bash
docker run -d \
  -p 3000:3000 \
  --name redmine \
  -v /path/to/redmine/files:/usr/src/redmine/files \
  -v /path/to/redmine/plugins:/usr/src/redmine/plugins \
  -v /path/to/redmine/themes:/usr/src/redmine/public/themes \
  vzvu3k6k/redmine

Docker Compose配置示例

创建docker-compose.yml文件，整合Redmine与PostgreSQL：

yaml
version: '3'

services:
  redmine:
    image: vzvu3k6k/redmine
    ports:
      - "3000:3000"
    environment:
      - DB_ADAPTER=postgresql
      - DB_HOST=db
      - DB_NAME=redmine
      - DB_USER=redmine
      - DB_PASSWORD=secret
    volumes:
      - redmine_files:/usr/src/redmine/files
      - redmine_plugins:/usr/src/redmine/plugins
    depends_on:
      - db

  db:
    image: postgres:14
    environment:
      - POSTGRES_DB=redmine
      - POSTGRES_USER=redmine
      - POSTGRES_PASSWORD=secret
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  redmine_files:
  redmine_plugins:
  postgres_data:

启动服务：

bash
docker-compose up -d

环境变量配置

注：更多配置可参考https://github.com/docker-library/redmine%EF%BC%8C%E6%9C%AC%E9%95%9C%E5%83%8F%E4%BF%9D%E6%8C%81%E9%85%8D%E7%BD%AE%E5%85%BC%E5%AE%B9%E6%80%A7%E3%80%82