atlassian/docker-release-maker

镜像概述

Atlassian Docker Release Maker是一款自动化工具，专为Atlassian Server产品的Docker镜像生命周期管理设计。它能够自动执行镜像构建、测试、版本标记和发布流程，通过集成Atlassian Marketplace和Docker Hub API获取版本信息，支持复杂的标签策略、自定义构建参数传递及指定Dockerfile构建。该镜像包含Python测试依赖等工具和依赖项，适用于作为Atlassian产品Docker镜像构建与测试流水线的运行时环境。

核心功能与特性

• 自动化版本管理：通过API检测未发布产品版本，自动创建新镜像或更新已发布镜像
• 灵活标签策略：支持版本标签（如6.5.4、6.5）、默认标签（latest）及后缀标签（如6.5.4-ubuntu）
• 自定义构建参数：允许传递构建参数（如基础镜像、制品名称）以定制镜像构建
• 集成测试支持：内置默认测试脚本，可执行容器安全测试（Snyk）和功能测试
• CI/CD兼容：无缝集成Bitbucket Pipelines，支持EAP版本创建

使用场景与适用范围

• 新产品版本发布：在Bitbucket Pipelines中触发，为未发布版本创建Docker镜像
• 镜像批量更新：重建并更新所有已发布版本的Docker镜像
• 多变体镜像管理：通过后缀标签区分不同基础镜像（如JDK版本、OS类型）的镜像变体
• EAP版本支持：使用--create-eap标志创建早期访问版本（EAP）镜像

使用方法与配置说明

基本运行方式

通过命令行参数配置工具行为，核心命令包括：

• make-releases.py --create：创建未发布版本的新镜像
• make-releases.py --update：更新所有已发布版本的镜像
• make-releases.py --create-eap：创建EAP版本镜像（若可用）

典型Bitbucket Pipelines配置

yaml
image: atlassian/docker-release-maker:latest

pipelines:
  custom:
    new-releases:
      - step:
          name: Jira Software
          services:
            - docker
          script:
            - echo ${DOCKER_PASSWORD} | docker login --username ${DOCKER_USERNAME} --password-stdin
            - >
              python make-releases.py 
                --update
                --start-version='7.13'
                --end-version='9'
                --default-release
                --dockerfile-buildargs='ARTEFACT_NAME=atlassian-jira-software,BASE_IMAGE=adoptopenjdk:8-hotspot'
                --dockerfile-version-arg='JIRA_VERSION'
                --mac-product-key='jira-software'
                --tag-suffixes=''
                --concurrent-builds='1'
                --job-offset='0'
                --jobs-total='12'
                --docker-repos='atlassian/jira-software'
                --push

配置参数说明

必填参数

可选参数

集成测试脚本

脚本参数

测试脚本接收以下参数：

1. 本地构建镜像的哈希值（必填）
2. 发布上下文标志（"true"表示发布构建，非发布构建为其他值）
3. 测试候选标志（默认false，可选）

默认测试脚本功能

默认脚本integration_test.sh执行以下操作：

• 使用Snyk对镜像进行容器安全测试
• 若为发布构建（第二个参数为true），将镜像注册到Snyk进行持续监控
• 若测试候选标志为true且产品仓库中存在可执行的func-tests/run-functests脚本，执行功能测试（可通过FUNCTEST_SCRIPT环境变量覆盖脚本路径）

标签策略详解

默认发布标签（--default-release=true）

当启用默认发布时，针对版本6.5.4将生成以下标签（根据版本最新性判断）：

• 完整版本标签：6.5.4（始终生成）
• 次要版本标签：6.5（仅当6.5.4是6.5.x系列最新版本时生成）
• 主版本标签：6（仅当6.5.4是6.x系列最新版本时生成）
• 默认标签：latest（仅当6.5.4是产品最新版本时生成）

后缀标签（--tag-suffixes指定）

当指定--tag-suffixes=ubuntu时，针对版本6.5.4将生成以下标签：

• 完整版本后缀标签：6.5.4-ubuntu（始终生成）
• 次要版本后缀标签：6.5-ubuntu（仅当6.5.4是6.5.x系列最新版本时生成）
• 主版本后缀标签：6-ubuntu（仅当6.5.4是6.x系列最新版本时生成）
• 后缀默认标签：ubuntu（仅当6.5.4是产品最新版本时生成）

注意：所有标签对应同一镜像哈希，确保同一版本仅存在一个发布制品。