nemerosa/ontrack

Ontrack Docker镜像文档

镜像概述

Ontrack Docker镜像是用于快速部署Ontrack的容器化解决方案。Ontrack是一款由Nomad Labs开发的CI/CD质量跟踪工具，旨在帮助开发团队监控软件开发生命周期中构建、测试和部署环节的质量指标，通过集中化的质量数据展示，提升开发流程的透明度和质量控制能力。Docker镜像提供了便捷的部署方式，简化环境配置，确保跨平台一致性。

核心功能与特性

质量指标跟踪

• 实时监控构建状态、测试覆盖率、静态代码分析结果等关键质量指标
• 支持自定义质量规则，定义通过/失败阈值
• 可视化展示质量趋势，帮助识别潜在问题

广泛集成能力

• 与主流CI/CD工具集成：Jenkins、GitHub Actions、GitLab CI、Travis CI等
• 支持与代码仓库集成：Git、SVN等
• 兼容测试报告格式：JUnit、Jacoco、SonarQube等

灵活的配置与扩展

• 支持通过环境变量、配置文件或API自定义系统行为
• 可扩展的数据存储选项（内置H2数据库，支持外部MySQL/PostgreSQL）
• 提供REST API和Web UI，满足不同使用场景需求

容器化优势

• 简化部署流程，无需手动配置依赖环境
• 支持版本控制，便于环境一致性管理
• 轻量级部署，资源占用可控

使用场景与适用范围

适用团队

• 中小型开发团队：需要低成本实现CI/CD质量监控
• DevOps团队：希望整合现有CI/CD工具链，提升质量可见性
• QA团队：需要集中化管理测试结果和质量指标

典型应用场景

• 监控每日构建质量，及时发现回归问题
• 跟踪测试覆盖率变化，确保代码质量不下降
• 集成静态代码分析工具，实时查看代码质量问题
• 生成版本发布质量报告，支持决策评审

使用方法与配置说明

基本部署（Docker Run）

bash
# 基本运行（使用内置H2数据库，适合测试环境）
docker run -d -p 8080:8080 --name ontrack nomadlabs/ontrack:latest

访问 http://localhost:8080 即可打开Ontrack Web UI，初始管理员账号：admin/admin。

持久化数据配置

bash
# 使用外部卷存储数据（推荐生产环境）
docker run -d \
  -p 8080:8080 \
  -v ontrack-data:/app/data \
  --name ontrack \
  nomadlabs/ontrack:latest

自定义数据库配置（MySQL/PostgreSQL）

bash
# 使用MySQL数据库（生产环境推荐）
docker run -d \
  -p 8080:8080 \
  -e SPRING_DATASOURCE_URL=jdbc:mysql://mysql-host:3306/ontrack \
  -e SPRING_DATASOURCE_USERNAME=ontrackuser \
  -e SPRING_DATASOURCE_PASSWORD=ontrackpass \
  -e SPRING_JPA_HIBERNATE_DDL_AUTO=update \
  --name ontrack \
  nomadlabs/ontrack:latest

Docker Compose配置示例

yaml
version: '3'
services:
  ontrack:
    image: nomadlabs/ontrack:latest
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=prod
      - SPRING_DATASOURCE_URL=jdbc:postgresql://db:5432/ontrack
      - SPRING_DATASOURCE_USERNAME=ontrack
      - SPRING_DATASOURCE_PASSWORD=securepassword
    depends_on:
      - db
    volumes:
      - ontrack-data:/app/data

  db:
    image: postgres:14
    environment:
      - POSTGRES_DB=ontrack
      - POSTGRES_USER=ontrack
      - POSTGRES_PASSWORD=securepassword
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  ontrack-data:
  postgres-data:

关键环境变量配置

集成CI/CD工具示例（Jenkins）

1. 在Jenkins Pipeline中添加Ontrack报告步骤：

groovy
stage('Publish to Ontrack') {
  steps {
    script {
      ontrackPublisher(
        url: 'http://ontrack:8080',
        project: 'my-project',
        branch: 'main',
        build: env.BUILD_NUMBER,
        description: 'Jenkins Build',
        validationStamps: [
          [
            name: 'unit-tests',
            type: 'TEST',
            data: [file: 'target/surefire-reports/TEST-*.xml']
          ],
          [
            name: 'code-coverage',
            type: 'COVERAGE',
            data: [file: 'target/jacoco-report/jacoco.xml']
          ]
        ]
      ]
    }
  }
}

2. 在Ontrack Web UI中查看构建详情和质量指标。

注意事项

• 生产环境建议使用外部数据库（PostgreSQL/MySQL）替代内置H2数据库，提升数据可靠性
• 定期备份数据卷，防止数据丢失
• 根据实际负载调整容器资源限制（--memory、--cpus参数）
• 生产环境建议配置HTTPS，可通过反向代理（如Nginx）实现

版本更新

bash
# 拉取最新镜像并重启
docker pull nomadlabs/ontrack:latest
docker stop ontrack
docker rm ontrack
docker run -d -p 8080:8080 -v ontrack-data:/app/data --name ontrack nomadlabs/ontrack:latest

更多详细配置请参考官方文档：Ontrack Documentation