Redmine (ppc64le架构) Docker镜像文档

镜像概述和主要用途

注意：此仓库是Redmine镜像的ppc64le架构专用仓库。有关多架构镜像的更多信息，请参见镜像文档中的“非amd64架构？”和***镜像FAQ中的“镜像源在Git中变更后如何处理？”。

Redmine是一个免费开源的基于Web的项目管理和问题跟踪工具。它支持多项目及子项目管理，提供每个项目的Wiki和论坛、时间跟踪功能、灵活的基于角色的访问控制，并包含日历和甘特图以可视化项目进度和截止日期。Redmine可与多种版本控制系统集成，内置仓库浏览器和差异查看器。

核心功能和特性

• 多项目管理：支持同时管理多个独立项目及子项目层级结构
• 协作工具：每个项目配备Wiki（知识库）和论坛（讨论区）
• 任务跟踪：灵活的问题（Issue）管理，支持自定义字段、状态和工作流
• 时间跟踪：记录任务耗时，生成工时报表
• 访问控制：基于角色的权限管理，细粒度控制用户操作范围
• 可视化工具：内置日历、甘特图和燃尽图，直观展示项目进度
• 版本控制集成：支持Git、SVN、Mercurial等，提供代码提交关联和仓库浏览
• 可扩展性：通过插件系统扩展功能，支持自定义主题和工作流

使用场景和适用范围

• 软件开发项目：跟踪bug、功能需求和任务分配
• 团队协作管理：中小型团队的项目进度监控和文档协作
• 敏捷开发：通过自定义工作流适配Scrum、Kanban等敏捷方法
• 多团队协作：支持跨部门项目管理，隔离不同团队的数据和权限
• 科研项目管理：跟踪实验进度、文献整理和团队沟通

支持的标签及对应Dockerfile链接

快速参考

• 维护者：Docker社区
• 获取帮助：Docker社区Slack、Server Fault、Unix & Linux 或 Stack Overflow
• 提交issue：redmine镜像GitHub仓库
• 支持的架构：amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x
• 镜像元数据：repo-info仓库的repos/redmine/目录（包含镜像元数据、传输大小等）
• 镜像更新：official-images仓库的library/redmine标签

使用方法

使用SQLite运行Redmine

最简单的部署方式，适合测试环境（不推荐生产环境多用户使用，详见Redmine***文档）：

bash
docker run -d --name some-redmine ppc64le/redmine

使用数据库容器运行Redmine

生产环境推荐使用独立数据库容器（PostgreSQL或MySQL），步骤如下：

1. 启动数据库容器

• PostgreSQL：

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

• MySQL（启动Redmine时需将REDMINE_DB_POSTGRES替换为REDMINE_DB_MYSQL）：

  bash
  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容器

bash
docker run -d --name some-redmine --network some-network \
  -e REDMINE_DB_POSTGRES=some-postgres \  # 若使用MySQL，替换为REDMINE_DB_MYSQL=some-mysql
  -e REDMINE_DB_USERNAME=redmine \
  -e REDMINE_DB_PASSWORD=secret \
  ppc64le/redmine

使用docker compose部署

创建compose.yaml文件：

yaml
services:
  redmine:
    image: ppc64le/redmine  # 注意指定ppc64le架构镜像
    restart: always
    ports:
      - "8080:3000"  # 主机端口:容器端口（Redmine默认端口3000）
    environment:
      REDMINE_DB_MYSQL: db  # 数据库服务名（与下方db服务对应）
      REDMINE_DB_PASSWORD: example  # 数据库密码
      REDMINE_SECRET_KEY_BASE: supersecretkey  # 会话加密密钥（生产环境需替换为随机字符串）

  db:
    image: mysql:8.0
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: example  # MySQL root密码
      MYSQL_DATABASE: redmine  # 数据库名

启动服务：

bash
docker compose up -d

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

数据持久化

Redmine上传的文件需持久化存储，推荐使用主机目录绑定挂载：

1. 在主机创建数据目录：

   bash
   mkdir -p /my/own/datadir
   

2. 启动容器时挂载目录：

   bash
   docker run -d --name some-redmine \
     -v /my/own/datadir:/usr/src/redmine/files \  # 主机目录:容器内文件存储路径
     ppc64le/redmine
   

端口映射

通过-p参数将容器端口映射到主机，实现外部访问：

bash
docker run -d --name some-redmine -p 3000:3000 ppc64le/redmine

访问http://localhost:3000或[***]即可打开Redmine。

环境变量配置

启动容器时可通过环境变量调整Redmine配置，常用变量说明如下：

使用Docker Secrets管理敏感信息

支持通过_FILE后缀从文件加载环境变量（适用于Docker Secrets），例如：

bash
docker run -d --name some-redmine \
  -e REDMINE_DB_MYSQL_FILE=/run/secrets/mysql-host \  # 从文件读取数据库主机
  -e REDMINE_DB_PASSWORD_FILE=/run/secrets/mysql-pass \  # 从文件读取密码
  ppc64le/redmine

支持的变量：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。

镜像变体

ppc64le/redmine:<version>

基于Debian系统的标准镜像，包含完整依赖，适合大多数场景。标签中的sid/bookworm等为Debian发行版代号，指定基础系统版本。

ppc64le/redmine:<version>-alpine

基于Alpine Linux的轻量级镜像，体积更小（约5MB基础镜像），适合对镜像大小敏感的场景。注意：Alpine使用musl libc而非glibc，部分依赖glibc的软件可能存在兼容性问题。

许可证

Redmine采用GNU通用公共许可证v2（GPLv2）开源协议。

Docker镜像可能包含其他软件（如Bash、基础系统库等），其许可证需由用户自行确认合规性。更多信息可参考repo-info仓库的redmine目录。