dockette/hashicorp

Dockette工具集成镜像文档

镜像概述和主要用途

Dockette工具集成镜像是一款预装多种DevOps与云原生核心工具的集成环境镜像，包含Nomad、Consul、Levant、Vault、Terraform、Packer和Waypoint。该镜像旨在提供一站式工具链解决方案，简化多工具协同场景下的安装配置与版本管理，适用于开发调试、CI/CD流水线集成、测试环境搭建等场景，帮助团队快速构建标准化工具环境。

核心功能和特性

预装工具清单

• Nomad：容器编排与调度工具，支持微服务部署与批处理任务管理
• Consul：服务发现与配置管理平台，提供分布式系统的服务网格能力
• Levant：Nomad作业模板渲染工具，简化动态配置与部署流程
• Vault：密钥与敏感信息管理工具，支持加密存储与访问控制
• Terraform：基础设施即代码（IaC）工具，实现多云资源自动化编排
• Packer：跨平台镜像构建工具，支持一致化环境镜像生成
• Waypoint：应用全生命周期管理工具，简化构建、部署与发布流程

镜像核心特性

• 工具链一体化：集成完整DevOps工具链，避免多工具独立安装与版本冲突
• 即开即用：容器启动后无需额外配置，直接调用所有工具命令
• 轻量高效：基于Dockette精简基础镜像，平衡功能与资源占用
• 灵活扩展：支持环境变量注入与配置文件挂载，适配个性化需求

使用场景和适用范围

典型使用场景

• 本地开发环境：开发者无需在本地安装多工具，通过容器快速获得标准化工具链
• CI/CD流水线：作为构建/部署节点，统一执行基础设施编排、镜像构建等任务
• 测试环境部署：快速搭建包含服务编排、密钥管理的完整测试栈
• 团队协作支持：统一团队工具版本与配置，消除"环境差异"问题

适用人群

• DevOps工程师与SRE
• 云原生应用开发者
• 基础设施自动化团队
• 需要跨工具协同的技术团队

使用方法和配置说明

前提条件

• Docker Engine 20.10+
• 网络连接（用于拉取镜像及工具运行时依赖）

镜像拉取

bash
# 假设镜像仓库地址为dockette/tools（实际地址请以官方为准）
docker pull docker.xuanyuan.run/dockette/tools:latest

基础使用方式

交互式运行

启动容器并进入命令行，直接使用工具：

bash
docker run -it --rm docker.xuanyuan.run/dockette/tools:latest /bin/bash

# 验证工具安装（示例）
terraform --version  # 查看Terraform版本
nomad version        # 查看Nomad版本
vault --version      # 查看Vault版本

挂载本地目录（数据共享）

挂载本地项目目录至容器，实现文件双向交互：

bash
docker run -it --rm -v $(pwd):/workspace docker.xuanyuan.run/dockette/tools:latest /bin/bash
# 容器内/workspace目录与本地当前目录双向同步

工具配置与高级使用

环境变量配置

通过-e参数注入环境变量，自定义工具行为：

示例：指定外部Consul服务端

bash
docker run -it --rm -e CONSUL_HTTP_ADDR=http://consul-server:8500 docker.xuanyuan.run/dockette/tools:latest

配置文件挂载

通过-v参数挂载本地配置文件，覆盖默认配置：

bash
# 挂载Consul配置文件
docker run -it --rm -v $(pwd)/consul-config:/etc/consul.d docker.xuanyuan.run/dockette/tools:latest

# 挂载Vault策略文件
docker run -it --rm -v $(pwd)/vault-policies:/etc/vault/policies docker.xuanyuan.run/dockette/tools:latest

典型工具链协同示例

Terraform+Packer环境部署流程：

bash
# 1. 启动容器并挂载项目目录
docker run -it --rm -v $(pwd):/workspace docker.xuanyuan.run/dockette/tools:latest /bin/bash

# 2. 使用Packer构建应用镜像
cd /workspace/packer
packer build app-image.pkr.hcl

# 3. 使用Terraform部署基础设施
cd /workspace/terraform
terraform init   # 初始化工作目录
terraform plan   # 预览执行计划
terraform apply  # 应用基础设施配置

注意事项

• 镜像默认配置为开发模式，生产环境使用前需通过挂载配置文件强化安全性（如Vault启用TLS、Consul配置持久化存储）
• 工具运行依赖网络连接，离线环境需提前配置本地镜像仓库与依赖缓存
• 容器内数据默认非持久化，重要配置与项目文件需通过-v挂载本地目录保存

版本信息

• 基础镜像：Dockette（基于Alpine或Debian，具体以官方为准）
• 工具版本：包含各工具最新稳定版（具体版本可通过docker run --rm dockette/tools:latest <工具名> --version查询）