gdcc/dataverse

Dataverse 应用容器镜像

1. 镜像概述

1.1 主要用途

"application image" 提供部署就绪的 Dataverse 应用，运行于由 https://hub.docker.com/r/gdcc/base 提供的应用服务器之上。其核心用途是打包 Dataverse 应用及成功启动应用所需的全部额外材料，实现快速部署。

1.2 维护者

该镜像由 Dataverse 社区以尽力而为的方式创建、维护和支持。

2. 核心功能与特性

2.1 部署就绪

预配置完整的 Dataverse 应用环境，无需额外手动配置即可启动。

2.2 启动配置支持

在所有 JVM 选项完全支持 MicroProfile Config 前，提供必要的脚本胶水代码，在应用服务器启动阶段完成应用域配置（详见 https://guides.dataverse.org/en/latest/container/app-image.html#app-tunables%EF%BC%89%E3%80%82

2.3 多架构支持

作为"多架构镜像"构建，支持 Dataverse 常规运行的主流架构：

• AMD64（Windows/Linux 等系统）
• ARM64（Apple M1/M2 等系统）

3. 使用场景与适用范围

3.1 适用用户

需快速部署 Dataverse 应用的开发者、系统管理员或研究机构 IT 团队。

3.2 环境建议

• 开发/测试环境：可使用 latest 或 unstable 等滚动标签获取最新特性
• 生产环境：强烈建议使用以 -r<number> 结尾的不可变标签（如 6.8-noble-r2），确保部署版本一致性

4. 支持的镜像标签

4.1 标签列表

该镜像源自 Dataverse 软件的上游主代码库（https://github.com/IQSS/dataverse%EF%BC%89%EF%BC%8C%E9%95%9C%E5%83%8F%E4%BB%A3%E7%A0%81%E7%9A%84%E5%BC%80%E5%8F%91%E4%B8%8E%E7%BB%B4%E6%8A%A4%E4%BD%8D%E4%BA%8E <git root>/src/main/docker 目录。当前维护的标签如下：

• latest, 6.8-noble, 6.8-noble-r2（https://github.com/IQSS/dataverse/blob/v6.8/src/main/docker/Dockerfile%EF%BC%8Chttps://github.com/IQSS/dataverse/blob/develop/src/backports/v6.8%EF%BC%89
• 6.7.1-noble, 6.7.1-noble-r3（https://github.com/IQSS/dataverse/blob/v6.7.1/src/main/docker/Dockerfile%EF%BC%8Chttps://github.com/IQSS/dataverse/blob/develop/src/backports/v6.7.1%EF%BC%89
• 6.7-noble, 6.7-noble-r3（https://github.com/IQSS/dataverse/blob/v6.7/src/main/docker/Dockerfile%EF%BC%8Chttps://github.com/IQSS/dataverse/blob/develop/src/backports/v6.7%EF%BC%89
• unstable, 6.9-noble（https://github.com/IQSS/dataverse/blob/develop/src/main/docker/Dockerfile%EF%BC%8Chttps://github.com/IQSS/dataverse/blob/develop/src/backports/develop%EF%BC%89

4.2 标签说明

• 滚动标签：未以 -r<number> 结尾的标签（如 latest, 6.8-noble），会随更新自动指向最新版本
• 不可变标签：以 -r<number> 结尾的标签（如 6.8-noble-r2），指向特定版本，版本号中的 r<number> 表示补丁修订次数

5. 使用方法与配置说明

5.1 前提条件

• 熟悉 Docker 基本操作
• 参考 https://guides.dataverse.org/en/latest/container/base-image.html 了解可调参数、路径等基础配置

5.2 快速启动示例

Docker Run 命令

bash
docker run -d \
  --name dataverse-app \
  -p 8080:8080 \
  docker.xuanyuan.run/gdcc/application:6.8-noble-r2

Docker Compose 配置

yaml
version: '3.8'
services:
  dataverse:
    image: docker.xuanyuan.run/gdcc/application:6.8-noble-r2
    ports:
      - "8080:8080"
    environment:
      - DATAVERSE_DB_HOST=db
      - DATAVERSE_DB_USER=dataverse
      - DATAVERSE_DB_PASSWORD=securepassword
    depends_on:
      - db
  db:
    image: docker.xuanyuan.run/postgres:14
    environment:
      - POSTGRES_USER=dataverse
      - POSTGRES_PASSWORD=securepassword
      - POSTGRES_DB=dataverse

注意：上述环境变量仅为示例，实际配置需参考 https://guides.dataverse.org/en/latest/container/app-image.html 及基础镜像文档。

5.3 配置参数

该镜像的可调参数（如 JVM 选项、应用服务器配置等）需参考：

• https://guides.dataverse.org/en/latest/container/app-image.html
• https://guides.dataverse.org/en/latest/container/base-image.html

6. 文档与支持

6.1 官方文档

• https://guides.dataverse.org/en/latest/container/app-image.html%EF%BC%9A%E8%AF%A6%E7%BB%86%E4%BB%8B%E7%BB%8D%E9%95%9C%E5%83%8F%E5%86%85%E5%AE%B9%E3%80%81%E6%9E%84%E5%BB%BA%E3%80%81%E8%B0%83%E4%BC%98%E7%AD%89
• https://guides.dataverse.org/en/latest/container/base-image.html%EF%BC%9A%E5%8F%AF%E8%B0%83%E5%8F%82%E6%95%B0%E3%80%81%E8%B7%AF%E5%BE%84%E7%AD%89%E5%9F%BA%E7%A1%80%E9%85%8D%E7%BD%AE%E8%AF%A6%E6%83%85

6.2 帮助资源

IQSS 不提供部署或运行支持，如需帮助请联系社区：

• 社区聊天：https://chat.dataverse.org
• 邮件列表：https://groups.google.com/g/dataverse-community

7. 许可证信息

7.1 社区创建内容许可

社区创建的镜像内容采用 https://www.apache.org/licenses/LICENSE-2.0 许可，与 https://github.com/IQSS/dataverse/blob/develop/LICENSE.md 一致。

除非***要求或书面同意，根据本许可分发的软件按"原样"提供，不附带任何明示或暗示的担保或条件。详情参见许可协议。

7.2 第三方软件许可

与所有 Docker 镜像一样，本镜像可能包含其他软件（如 https://github.com/payara/Payara/blob/master/LICENSE.txt%E3%80%81Bash 等基础发行版组件，以及直接或间接的 Java 依赖），这些软件可能采用其他许可协议。

使用预构建镜像时，镜像用户有责任确保对本镜像的任何使用均符合其中包含的所有软件的相关许可要求。