hashieducation/vault-bootstrap

Vault Docker容器启动脚本镜像

镜像概述

该镜像包含一个Go语言编写的脚本工具，旨在简化Vault Docker容器的启动与初始化过程。通过自动化配置流程，帮助用户快速部署Vault服务，减少手动操作步骤，提高Vault容器的部署效率和一致性。

核心功能和特性

• 自动化启动：自动处理Vault容器的启动参数配置，无需手动编写复杂的启动命令
• 初始化简化：简化Vault的初始化流程，包括生成初始密钥、解锁Vault等步骤
• 配置灵活性：支持自定义Vault镜像版本、端口映射、存储后端等关键参数
• 轻量级设计：基于Go语言构建，脚本体积小，执行效率高，对系统资源占用低

使用场景和适用范围

• 开发环境快速搭建：开发人员需要快速部署Vault服务进行本地测试和开发
• CI/CD流程集成：在自动化部署流程中集成Vault容器的启动步骤
• 测试环境标准化：确保测试环境中Vault服务的配置一致性
• Vault初学者使用：帮助不熟悉Vault部署流程的用户快速上手

使用方法和配置说明

基本使用步骤

1. 确保本地已安装Docker环境
2. 拉取该启动脚本镜像
3. 通过环境变量配置Vault容器参数
4. 运行脚本镜像，自动启动并配置Vault容器

环境变量配置

部署示例

Docker Run命令

bash
docker run -e VAULT_IMAGE=hashicorp/vault:1.14.0 \
           -e VAULT_PORT=8200 \
           -e VAULT_CONTAINER_NAME=my-vault \
           -e STORAGE_BACKEND=file \
           -v /var/run/docker.sock:/var/run/docker.sock \
           --name vault-bootstrap \
           your-image-name:latest

注意：需挂载Docker socket（/var/run/docker.sock）以允许脚本操作Docker守护进程

开发模式快速启动

bash
docker run -e VAULT_DEV_MODE=true \
           -e VAULT_PORT=8200 \
           -v /var/run/docker.sock:/var/run/docker.sock \
           --name vault-bootstrap-dev \
           your-image-name:latest

输出说明

脚本执行成功后，将输出：

• Vault容器ID和名称
• Vault服务访问地址（如http://localhost:8200）
• 初始Root Token（仅非开发模式下）
• unseal密钥（仅非开发模式下，需妥善保存）

注意事项

• 生产环境中不建议使用开发模式（VAULT_DEV_MODE=true）
• 非开发模式下生成的 unseal 密钥和 Root Token 需安全存储，丢失将导致无法访问Vault
• 确保Docker权限足够，脚本需要能够创建和管理容器
• 如需持久化Vault数据，需额外配置数据卷挂载（可通过STORAGE_BACKEND相关参数实现）