fabriziomereu/snap4city_installation_generator

镜像概述

该Docker镜像专注于自动化版本发布流程管理，核心功能是在指定构建任务或流程完成后，自动触发并执行版本发布操作。旨在简化发布流程，减少人工干预，提升团队在CI/CD流水线中的发布效率与一致性，适用于各类需要自动化版本管理的开发场景。

核心功能与特性

• 自动触发机制：实时监控目标任务或流程的完成状态，满足预设条件后自动启动发布流程，无需手动触发
• 灵活集成能力：支持与主流CI/CD工具（Jenkins、GitLab CI、GitHub Actions等）及版本控制系统（Git）无缝集成
• 可配置发布策略：通过环境变量或配置文件自定义发布规则，包括版本号生成逻辑（如语义化版本、Git标签）、发布渠道（Docker Registry、npm、应用商店等）
• 发布状态追踪：提供详细的发布过程日志与状态反馈，支持发布结果校验与异常告警

使用场景与适用范围

• 开发团队CI/CD流水线：代码构建、测试通过后自动发布新版本，缩短从开发到交付的周期
• 多环境版本管理：针对开发、测试、生产等不同环境配置差异化发布策略，实现环境隔离的自动化发布
• 高频迭代项目：适用于需要快速迭代、频繁发布版本的应用（如Web服务、移动应用），降低手动操作成本
• 标准化发布流程：确保团队内所有项目遵循统一的发布规范，减少因人为操作导致的版本混乱或错误

使用方法与配置说明

基础使用（Docker Run）

bash
docker run -d \
  --name auto-release \
  -e TRIGGER_CONDITION=task_success \
  -e VERSION_STRATEGY=semver \
  -e TARGET_REGISTRY=https://index.docker.io/v1/ \
  [镜像名称]:[版本标签]

环境变量配置

高级配置（Docker Compose）

yaml
version: '3.8'
services:
  auto-release:
    image: docker.xuanyuan.run/[镜像名称]:[版本标签]
    container_name: auto-release-service
    environment:
      - TRIGGER_CONDITION=task_success
      - VERSION_STRATEGY=git_tag
      - TARGET_REGISTRY=https://npm.pkg.github.com
      - AUTH_TOKEN=${REGISTRY_TOKEN}  # 从宿主机环境变量注入仓库认证令牌
      - LOG_LEVEL=debug
    volumes:
      - ./release-config:/app/config  # 挂载自定义发布配置文件（如版本规则、渠道列表）
    restart: unless-stopped

注意事项

• 敏感信息（如仓库认证令牌、API密钥）需通过环境变量或加密配置文件注入，避免直接写入镜像或配置文件
• 首次使用前建议通过LOG_LEVEL=debug模式运行容器，验证配置正确性及与外部服务的连通性
• 根据目标发布渠道需求，需确保容器网络可访问对应服务端点（如开放Docker Registry、npm API的网络权限）