macstab/semantic-release-maven-gradle-nodejs-python-git-jq

Docker镜像：语义化发布多语言支持平台

镜像概述和主要用途

本Docker镜像作为使用semantic-release进行自动化版本管理和发布的基础平台，专为支持多种编程环境设计，包括JavaScript、Java（含Maven和Gradle）及Python。它基于Debian Bookworm发行版，整合了多种开发工具和运行时环境，为跨语言项目提供统一的发布工作流支持。

核心功能和特性

多语言环境支持

• 集成JavaScript/Node.js、Java（含Maven和Gradle构建工具）、Python运行时环境
• 支持Git版本控制和JQ JSON处理工具，满足构建和发布流程中的各类需求

语义化发布自动化

• 内置semantic-release 22.0.10，实现基于语义化版本（SemVer）的自动化版本管理
• 自动分析提交消息、生成更新日志、创建版本标签并发布到相应仓库

灵活的配置机制

• 通过SEMANTIC_RELEASE_CONFIG环境变量支持自定义配置
• 提供5种预定义配置文件，分别针对Gradle、Maven、JavaScript、Python及无构建工具项目（如Docker镜像、配置文件、基础设施即代码等）

依赖组件和版本信息

基础镜像组件

基于macstab/node-python-git-jq-bookworm:latest构建，包含以下核心组件：

额外开发工具

semantic-release核心功能

核心能力

• 自动化版本管理：基于提交消息分析确定版本变更类型（主版本、次版本或补丁版本）
• 更新日志生成：自动创建和更新包含发布说明的变更日志
• 包发布自动化：集成多种包仓库（npm、PyPI、Maven等）的发布流程

关键插件

使用场景和适用范围

• 多语言项目：同时使用JavaScript、Java和Python的复杂项目
• CI/CD流水线：集成到持续集成/持续部署流程中实现自动化发布
• 标准化发布：需要统一版本管理策略的团队或组织
• 跨平台项目：包含Docker镜像、配置文件等非代码资产的发布管理

使用方法和配置说明

选择预定义配置

可通过两种方式选择预定义配置文件：

1. 环境变量方式：设置SEMANTIC_RELEASE_CONFIG环境变量

   bash
   docker run -e SEMANTIC_RELEASE_CONFIG=/configs/.releaserc-gradle.json your-image semantic-release
   

2. 命令行参数方式：使用--config参数指定配置文件

   bash
   docker run your-image semantic-release --config /configs/.releaserc-maven.json
   

预定义配置文件说明

Gradle项目配置

• 路径：/configs/.releaserc-gradle.json
• 功能：针对Gradle构建的Java项目，包含版本更新、变更日志生成和Git操作
• 使用示例：

  bash
  docker run -e SEMANTIC_RELEASE_CONFIG=/configs/.releaserc-gradle.json your-image semantic-release
  

Maven项目配置

• 路径：/configs/.releaserc-maven.json
• 功能：支持Maven项目的版本管理和发布流程
• 使用示例：

  bash
  docker run your-image semantic-release --config /configs/.releaserc-maven.json
  

JavaScript项目配置

• 路径：/configs/.releaserc-js.json（默认配置）
• 功能：适用于npm/yarn管理的JavaScript项目，支持npm包发布
• 使用示例：

  bash
  docker run -e SEMANTIC_RELEASE_CONFIG=/configs/.releaserc-js.json your-image semantic-release
  

Python项目配置

• 路径：/configs/.releaserc-python.json
• 功能：支持Poetry管理的Python项目，集成PyPI发布
• 使用示例：

  bash
  docker run your-image semantic-release --config /configs/.releaserc-python.json
  

无构建工具项目配置

• 路径：/configs/.releaserc-docker.json
• 功能：适用于Docker镜像、配置文件、基础设施即代码等无构建工具的项目
• 使用示例：

  bash
  docker run your-image semantic-release --config /configs/.releaserc-docker.json
  

Docker Compose示例

yaml
version: '3'
services:
  release:
    image: your-image
    environment:
      - SEMANTIC_RELEASE_CONFIG=/configs/.releaserc-maven.json
      - GITHUB_TOKEN=your_github_token
      - NPM_TOKEN=your_npm_token
    volumes:
      - ./your-project:/workspace
    working_dir: /workspace
    command: semantic-release

最佳实践

1. 提交消息规范：遵循Conventional Commits标准，使用fix:、feat:、BREAKING CHANGE:等前缀
2. 环境变量管理：确保配置必要的认证令牌（如GitHub、npm、PyPI等仓库访问令牌）
3. 版本控制策略：在CI/CD流程中使用专用用户账户执行发布操作，确保权限控制
4. 测试配置：在正式环境使用前，通过--dry-run参数测试发布配置

相关资源

• GitHub仓库：https://github.com/macstab/semantic-release-maven-gradle-nodejs-python-git-jq
• semantic-release官方文档：[***]