mergermarket/cdflow-commands

CDFlow 命令镜像 (mergermarket/cdflow-commands)

镜像概述

mergermarket/cdflow-commands 是 CDFlow 工具链的核心命令实现镜像。它封装了用于软件服务持续交付的各项底层命令，支持服务的发布（Release）、部署（Deploy）以及销毁/退役（Destroy/Decommission）。该镜像通常配合 https://github.com/mergermarket/cdflow/ 使用，以确保在发布时获取最新版本，并保证整个 CI/CD 流水线中执行环境的一致性。

核心功能与特性

• 服务发布 (Release)：构建并打包软件服务，生成可部署的版本产物。
• 服务部署 (Deploy)：将指定版本的服务部署到目标环境中。
• 环境销毁 (Destroy)：清理和销毁指定环境中的服务资源。
• 流水线一致性：通过 Docker 镜像封装命令，确保本地开发与 CI/CD 流水线中的执行行为完全一致。
• 版本控制：支持动态获取最新版本或通过 Wrapper 脚本固定特定版本。

使用场景和适用范围

• 持续交付/持续部署 (CI/CD)：作为 Jenkins、GitLab CI、GitHub Actions 等流水线中的执行节点。
• 微服务生命周期管理：管理复杂微服务架构下的多环境发布与部署。
• 基础设施即代码 (IaC)：结合平台配置（Platform Config）进行云资源的自动化编排与管理。

详细的使用方法和配置说明

基础命令

通常建议通过 https://github.com/mergermarket/cdflow/ 来调用此镜像。基础用法如下：

bash
cdflow release --platform-config <platform_config> <version> [options]
cdflow deploy <environment> <version> [options]
cdflow destroy <environment> [options]

参数说明

Docker 部署与运行示例

虽然推荐使用 Wrapper 脚本，但您也可以直接通过 docker run 调用该镜像。在直接运行时，通常需要挂载当前工作目录、Docker Socket（若需在内部构建镜像）以及云平台凭证。

Docker Run 示例

bash
docker run --rm -it \
  -v $(pwd):/src \
  -w /src \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID \
  -e AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY \
  mergermarket/cdflow-commands \
  release --platform-config platform-config.yaml 1.0.0

Docker Compose 示例 (用于 CI/CD 流水线)

在 CI/CD 环境中，可以将其定义为一次性任务服务：

yaml
version: '3.8'
services:
  cdflow-deploy:
    image: mergermarket/cdflow-commands:latest
    volumes:
      - ./:/src
      - /var/run/docker.sock:/var/run/docker.sock
    working_dir: /src
    environment:
      - AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID}
      - AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY}
    command: ["deploy", "staging", "1.0.0", "-v"]

测试与开发

如果您需要克隆源码并进行本地测试，可以运行仓库中提供的测试脚本：

bash
./test.sh

更多详细文档与高级配置，请参阅 https://mergermarket.github.io/cdflow/%E3%80%82