Redmine Docker镜像文档

镜像概述和主要用途

Redmine是一个基于Ruby on Rails框架开发的灵活项目管理Web应用程序，提供免费开源的项目管理和问题跟踪功能。本镜像是针对mips64le架构的Redmine官方镜像构建版本。

核心功能和特性

• 多项目和子项目管理
• 每个项目的Wiki和论坛
• 时间跟踪功能
• 灵活的基于角色的访问控制
• 日历和甘特图可视化项目进度
• 与多种版本控制系统集成
• 仓库浏览器和差异查看器

使用场景和适用范围

Redmine适用于各种规模的团队和组织，用于：

• 软件开发项目管理
• 任务跟踪和缺陷管理
• 团队协作和文档管理
• 项目进度可视化和报告
• 多项目并行管理

支持的标签和Dockerfile链接

• 6.0.7-bookworm, 6.0-bookworm
• 5.1.10-bookworm, 5.1-bookworm, 5-bookworm

支持的架构

• amd64
• arm32v5
• arm32v6
• arm32v7
• arm64v8
• i386
• mips64le (本镜像)
• ppc64le
• riscv64
• s390x

使用方法和配置说明

快速参考

• 维护者: Docker社区
• 获取帮助: Docker社区Slack, Server Fault, Unix & Linux, 或 Stack Overflow
• 提交问题: [***]

使用SQLite3运行Redmine

这是最简单的设置，仅需运行Redmine:

$ docker run -d --name some-redmine mips64le/redmine

注意：不建议用于多用户生产环境(Redmine维基)

使用数据库容器运行Redmine

推荐使用数据库服务器运行Redmine:

1. 启动数据库容器

   • PostgreSQL:

     $ docker run -d --name some-postgres --network some-network -e POSTGRES_PASSWORD=secret -e POSTGRES_USER=redmine postgres
     

   • MySQL (运行Redmine时将-e REDMINE_DB_POSTGRES=some-postgres替换为-e REDMINE_DB_MYSQL=some-mysql):

     $ docker run -d --name some-mysql --network some-network -e MYSQL_USER=redmine -e MYSQL_PASSWORD=secret -e MYSQL_DATABASE=redmine -e MYSQL_RANDOM_ROOT_PASSWORD=1 mysql:5.7
     

2. 启动Redmine:

   $ docker run -d --name some-redmine --network some-network -e REDMINE_DB_POSTGRES=some-postgres -e REDMINE_DB_USERNAME=redmine -e REDMINE_DB_PASSWORD=secret mips64le/redmine
   

使用Docker Compose运行

compose.yaml示例:

services:
  redmine:
    image: mips64le/redmine
    restart: always
    ports:
      - 8080:3000
    environment:
      REDMINE_DB_MYSQL: db
      REDMINE_DB_PASSWORD: example
      REDMINE_SECRET_KEY_BASE: supersecretkey

  db:
    image: mysql:8.0
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: example
      MYSQL_DATABASE: redmine

运行docker compose up，等待初始化完成后，访问http://localhost:8080或[***]。

访问应用程序

默认管理员账户信息:

• 用户名: admin
• 密码: admin

首次登录后建议立即更改密码。

数据存储

有多种方式存储Docker容器中运行的应用程序数据:

1. 让Docker管理文件存储，通过其内部卷管理将文件写入主机系统的磁盘。
2. 在主机系统上创建数据目录，并将其挂载到容器内可见的目录。

推荐第二种方式，示例:

$ docker run -d --name some-redmine -v /my/own/datadir:/usr/src/redmine/files --link some-postgres:postgres mips64le/redmine

-v /my/own/datadir:/usr/src/redmine/files部分将主机系统的/my/own/datadir目录挂载为容器内的/usr/src/redmine/files，Redmine将在此存储上传的文件。

端口映射

如需从主机访问容器实例，可使用端口映射:

$ docker run -d --name some-redmine -p 3000:3000 mips64le/redmine

然后通过浏览器访问http://localhost:3000或[***]。

以任意用户身份运行

可使用--user标志指定用户运行容器:

$ docker run -d --name some-redmine --user 1000:1000 mips64le/redmine

用户不需要在容器中预先存在。

Docker Secrets

除了通过环境变量传递敏感信息外，还可以在前面列出的环境变量后附加_FILE，使初始化脚本从容器中的文件加载这些变量的值，特别适用于从Docker Secrets加载密码:

$ docker run -d --name some-redmine -e REDMINE_DB_MYSQL_FILE=/run/secrets/mysql-host -e REDMINE_DB_PASSWORD_FILE=/run/secrets/mysql-root mips64le/redmine:tag

目前支持REDMINE_DB_MYSQL, REDMINE_DB_POSTGRES, REDMINE_DB_PORT, REDMINE_DB_USERNAME, REDMINE_DB_PASSWORD, REDMINE_DB_DATABASE, REDMINE_DB_ENCODING和REDMINE_SECRET_KEY_BASE。

环境变量

启动redmine镜像时，可以通过docker run命令行传递环境变量调整实例配置:

数据库连接设置

• REDMINE_DB_MYSQL, REDMINE_DB_POSTGRES, REDMINE_DB_SQLSERVER
  指定MySQL、PostgreSQL或Microsoft SQL主机的主机名或IP地址。这些值互斥，同时设置多个将导致未定义行为。如果未设置任何变量，镜像将回退使用SQLite。

• REDMINE_DB_PORT
  指定自定义数据库连接端口。未指定时，默认端口为:MySQL 3306，PostgreSQL 5432，SQLite为空字符串。

• REDMINE_DB_USERNAME
  Redmine和rake任务用于连接数据库的用户。未指定时，默认为:MySQL为root，PostgreSQL为postgres，SQLite为redmine。

• REDMINE_DB_PASSWORD
  指定用户连接数据库时使用的密码。无默认值。

• REDMINE_DB_DATABASE
  Redmine将在指定数据库服务器中使用的数据库名称。未指定时，默认为:MySQL为redmine，PostgreSQL为REDMINE_DB_USERNAME的值，SQLite为sqlite/redmine.db。

• REDMINE_DB_ENCODING
  连接数据库服务器时使用的字符编码。未指定时，MySQL默认使用UTF-8，PostgreSQL默认使用utf8，SQLite默认使用utf8。

应用配置设置

• REDMINE_NO_DB_MIGRATE
  控制容器启动时是否运行rake db:migrate。设置为非空字符串(如1或true)将在容器启动时不自动运行迁移脚本。

• REDMINE_PLUGINS_MIGRATE
  控制容器启动时是否运行rake redmine:plugins:migrate。设置为非空字符串(如1或true)将在每次容器启动时自动运行迁移脚本，在db:migrate之后执行。

• SECRET_KEY_BASE
  Rails环境变量，用于负载均衡副本维护会话连接。用于Rails编码存储会话数据的cookie，防止篡改。如果未设置此变量，secret_key_base值将使用rake generate_secret_token生成。

  为保持向后兼容性，已弃用的Docker特定变量REDMINE_SECRET_KEY_BASE将自动填充SECRET_KEY_BASE环境变量。建议迁移到直接使用SECRET_KEY_BASE变量。

许可证信息

Redmine是开源软件，根据GNU通用公共许可证v2(GPL)条款发布。

与所有Docker镜像一样，此镜像可能还包含其他软件，这些软件可能具有其他许可证(如基础发行版中的Bash等，以及主要软件的任何直接或间接依赖项)。

可在repo-info仓库的redmine/目录中找到一些能够自动检测到的附加许可证信息。

对于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用符合其中包含的所有软件的相关许可证。

参考信息

• 镜像更新: official-images repo的library/redmine标签
• 问题反馈: [***]
• 镜像元数据: repo-info repo的repos/redmine/目录
• 源代码: docs repo的redmine/目录