le-docker-leverage 镜像文档

镜像概述和主要用途

le-docker-leverage是binbashar/leverage项目的***Docker镜像（镜像名称：binbash/leverage-toolbox），集成了Terraform及相关工具链，旨在为Leverage项目提供一致、可控的开发、部署和运维环境。通过标准化的版本管理机制，确保团队使用统一的工具版本，减少环境差异导致的问题。

核心功能和特性

版本管理机制

• 镜像标签格式：<TERRAFORM_VERSION>-<LEVERAGE_TOOLBOX_IMAGE_VERSION>，完整镜像名为binbash/leverage-toolbox:<TERRAFORM_VERSION>-<LEVERAGE_TOOLBOX_IMAGE_VERSION>
• 版本更新规则：
  • 若TERRAFORM_VERSION变更（如Terraform版本升级），则LEVERAGE_TOOLBOX_IMAGE_VERSION重置为0.0.1
  • 若TERRAFORM_VERSION不变（仅工具箱其他组件更新），则LEVERAGE_TOOLBOX_IMAGE_VERSION按语义化版本（semver）递增（如0.0.1→0.0.2为补丁更新，0.0.1→0.1.0为次要更新）

集成工具

• 核心：指定版本的Terraform
• 辅助工具：通过scripts/目录和Dockerfile定义的运维脚本及依赖组件

自动化发布

• 基于CircleCI管道实现自动化构建与发布
• 仅在修改Dockerfile、scripts/*或Makefile时触发镜像部署

使用场景和适用范围

• Leverage项目开发：为开发者提供统一的本地开发环境
• 部署流程自动化：作为CI/CD管道中的执行环境，确保部署工具版本一致性
• 版本化环境管理：通过明确的版本标签，追溯不同环境使用的工具版本

版本管理详情

标签示例解析

• binbash/leverage-toolbox:1.2.1-0.0.1：包含Terraform 1.2.1，工具箱初始版本（0.0.1）
• binbash/leverage-toolbox:1.2.1-0.0.2：Terraform版本不变，工具箱补丁更新
• binbash/leverage-toolbox:1.2.2-0.0.1：Terraform版本升级（1.2.2），工具箱版本重置

版本配置位置

版本定义在项目根目录的Makefile中：

shell
# ###############################################################
# TERRAFORM AND CLI VERSIONS                                    #
# ###############################################################
TERRAFORM_TAG    := 1.2.7  # Terraform版本
LEVERAGE_CLI_TAG := 0.0.2  # 工具箱版本

注意：已存在的镜像标签不得重复推送至仓库。

发布流程

CircleCI自动化管道

• 触发条件：合并PR后，若修改涉及Dockerfile、scripts/*或Makefile，则执行构建部署
• 相关链接：
  • CI流水线
  • 发布记录
  • 更新日志

发布产物

构建后的镜像发布至Docker Hub，可在binbash/leverage-toolbox标签页查看所有版本。

本地开发与使用

环境要求

• 已安装容器引擎（如Docker、Podman等）

基本操作步骤

1. 克隆仓库：

   shell
   git clone ***:binbashar/le-docker-leverage-toolbox.git
   cd le-docker-leverage-toolbox
   

2. 初始化Makefile配置：

   shell
   make init-makefiles
   

3. 构建本地镜像：

   shell
   make build-local
   

4. 本地测试：

   shell
   make test-local
   

TODO列表

• [2022/08/25] 检查CircleCI与Slack的连接配置