mergermarket/cdflow-build-docker-ecr 镜像文档

镜像概述和主要用途

mergermarket/cdflow-build-docker-ecr 是 cdflow2 的构建插件，用于构建 Docker 镜像并将其推送到 AWS ECR。该镜像需配合支持 ECR 配置的 cdflow2 配置容器使用，例如 mergermarket/cdflow2-config-acuris。

• DockerHub 地址：mergermarket/cdflow2-build-docker-ecr
• GitHub 地址：mergermarket/cdflow-build-docker-ecr

核心功能和特性

• ECR 认证管理：基于环境中的 IAM 凭证获取 ECR 认证令牌，并执行 docker login 以允许镜像推送
• 镜像构建：从项目根目录的 Dockerfile 执行 docker build 创建 Docker 镜像
• 镜像推送：执行 docker push 将构建的镜像推送到 ECR 仓库
• 元数据输出：提供 image 发布元数据键，使生成的 Docker 镜像可通过 Terraform 使用（通过与 cdflow.yaml 中 builds 键下名称对应的 Terraform 映射变量，如 "docker"）

使用场景和适用范围

适用于基于 cdflow2 进行 CI/CD 流程的场景，需构建 Docker 镜像并推送到 AWS ECR。需配合支持 ECR 配置的 cdflow2 配置容器（如 mergermarket/cdflow2-config-acuris），以提供 ECR 仓库配置及相关凭证。

详细使用方法和配置说明

前置要求

需使用支持 ECR 配置的 cdflow2 配置容器，例如 mergermarket/cdflow2-config-acuris。

cdflow2.yaml 配置示例

以下示例使用 mergermarket/cdflow2-config-acuris 作为配置容器（仅适用于 Acuris 内部开发），该容器支持创建 ECR 仓库并将配置以环境变量形式提供给构建流程。

version: 2
config:
  image: mergermarket/cdflow2-config-acuris  # 支持 ECR 配置的 cdflow2 配置容器
  params:
    account_prefix: myaccountprefix  # AWS 账户前缀
    team: myteam                     # 团队名称
builds:
  docker:                            # 构建名称（对应 Terraform 变量名）
    image: mergermarket/cdflow2-build-docker-ecr  # 当前构建插件镜像
terraform:
  image: hashicorp/terraform         # Terraform 镜像

Dockerfile 示例

项目根目录需包含 Dockerfile，用于构建目标镜像。以下为简单示例：

FROM hello-world  # 基础镜像，可替换为实际业务镜像

配置容器环境变量要求

配置容器需在 configureRelease 钩子中确保 ECR 仓库存在，并通过以下环境变量提供必要配置：

配置容器支持说明

当前支持此构建插件的配置容器为：

• mergermarket/cdflow2-config-acuris

扩展配置容器支持

如需自定义配置容器以支持此构建插件，需确保容器在 configureRelease 阶段满足：

1. 确保 ECR 仓库存在；
2. 通过环境变量提供上述必要配置（ECR_REPOSITORY、AWS 凭证等）。