coinwebltd/circleci-image

Docker镜像文档

镜像概述

本系列镜像专为CI/CD（持续集成/持续部署）流程设计，提供多个标签版本，每个版本预装特定工具组合，以简化自动化构建、部署及相关操作流程。镜像设计轻量高效，可直接集成至各类CI/CD平台。

核心功能与特性

标签说明

• alpine

  • ENTRYPOINT设置为bash
  • 预装工具：git、ssh（支持通过SSH协议使用git）、kustomize
  • 用途：专门用于通过kustomize构建Kubernetes manifest文件，并推送至远程git仓库

• alpine-dbmate

  • 基础配置与alpine标签一致
  • 工具差异：将kustomize替换为dbmate二进制工具
  • 用途：适用于需要dbmate工具的场景（如数据库迁移管理）

• ami2-dbmate

  • 基于aws/aws-cli镜像构建
  • 预装工具：包含aws二进制工具（核心用途为从AWS Secrets Manager拉取凭证），同时集成dbmate
  • 用途：支持与AWS服务集成的CI/CD流程，需AWS凭证管理的场景

使用场景与适用范围

• alpine标签：Kubernetes manifest自动化构建流程，需通过kustomize处理配置并提交至git仓库的CI/CD任务
• alpine-dbmate标签：需要使用dbmate进行数据库版本控制或迁移的CI/CD流程，无需额外安装dbmate依赖
• ami2-dbmate标签：AWS环境下的CI/CD任务，需从AWS Secrets Manager获取凭证并使用dbmate进行数据库操作的场景

使用方法与配置说明

基本使用

通过指定标签拉取并运行镜像：

bash
# 使用alpine标签
docker run --rm your-registry/image-name:alpine

# 使用alpine-dbmate标签
docker run --rm your-registry/image-name:alpine-dbmate

# 使用ami2-dbmate标签
docker run --rm your-registry/image-name:ami2-dbmate

环境配置

• 可根据需求挂载 volumes 以持久化数据或共享文件（如git仓库目录、kustomize配置文件）
• 对于ami2-dbmate，需配置AWS凭证（如通过环境变量AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY或IAM角色挂载）以访问AWS Secrets Manager

典型示例（kustomize构建流程）

使用alpine标签执行kustomize构建并推送至git：

bash
# 假设已挂载包含kustomize配置的目录至/app
docker run --rm -v $(pwd):/app your-registry/image-name:alpine bash -c "
  cd /app && \
  kustomize build . > manifest.yaml && \
  git add manifest.yaml && \
  git commit -m 'Update k8s manifest' && \
  git push origin main
"