heroku/buildpack-release-phase

镜像概述

该Docker镜像专注于增强软件发布阶段的流程管理，核心功能是支持用户配置并执行多个有序的发布命令（release command）和发布构建命令（release-build command），解决传统发布流程中多步骤命令执行无序或难以统一管理的问题，提升发布过程的可控性和自动化水平。

核心功能与特性

1. 多命令支持

• 支持配置多个独立的发布命令，满足复杂发布流程的多步骤需求。
• 支持配置多个独立的发布构建命令，适配需多轮构建的场景。

2. 命令有序执行

• 所有配置的发布命令和发布构建命令均按预设顺序依次执行，确保流程的线性依赖关系（如先执行构建命令，再执行发布命令）。

使用场景

• 需分阶段执行发布流程的项目（如"构建→测试→打包→部署"多步骤场景）。
• 发布命令存在明确执行顺序依赖的场景（如必须先完成资源准备命令，才能执行推送命令）。
• 需统一管理多环境发布命令的场景（如开发、测试、生产环境的差异化发布流程）。

使用方法与配置说明

基础使用示例

通过docker run命令启动容器，需指定发布命令和发布构建命令的有序列表（以下示例中命令间用逗号分隔，按顺序执行）：

bash
docker run -it --rm \
  -e RELEASE_COMMANDS="build:./scripts/build.sh,test:./scripts/test.sh,deploy:./scripts/deploy.sh" \
  -e RELEASE_BUILD_COMMANDS="compile:go build,package:tar -czf app.tar.gz ./bin" \
  [镜像名称]:[标签]

核心配置参数

高级配置（配置文件方式）

若命令列表较长，可通过挂载配置文件（如commands.yaml）指定命令顺序，配置文件格式示例：

yaml
release_commands:
  - name: build
    command: ./scripts/build.sh
  - name: test
    command: ./scripts/test.sh
release_build_commands:
  - name: compile
    command: go build -o app ./cmd
  - name: package
    command: docker build -t myapp:v1 .

启动容器时挂载配置文件：

bash
docker run -it --rm \
  -v $(pwd)/commands.yaml:/app/config/commands.yaml \
  [镜像名称]:[标签] --config /app/config/commands.yaml

执行逻辑说明

容器启动后，将按以下顺序执行命令：

1. 依次执行RELEASE_BUILD_COMMANDS中配置的所有命令（若存在）。
2. 所有发布构建命令执行成功后，依次执行RELEASE_COMMANDS中配置的所有命令（若存在）。
3. 任一命令执行失败时，整个发布流程终止并返回错误码。