Chamber Docker镜像文档

镜像概述和主要用途

Chamber是一款专注于密钥管理的工具，其核心功能是将密钥安全存储在AWS SSM Parameter Store中，便于集中管理和访问控制。Docker镜像设计简洁，仅包含工具的二进制可执行文件，路径为/chamber，便于快速集成到各类容器化环境中。

核心功能和特性

• 密钥存储：利用AWS SSM Parameter Store作为后端存储，提供高可用性和安全性
• 轻量级设计：Docker镜像仅包含二进制文件，体积小巧，启动迅速
• 易于集成：可直接通过命令行调用，适合集成到CI/CD流程或应用部署中

使用场景和适用范围

• 适用于需要安全管理应用密钥、配置参数的场景，尤其适合基于AWS云平台的应用
• 可用于开发、测试和生产环境中的密钥分发与管理
• 适合容器化应用，通过Docker快速部署和使用密钥管理功能

使用方法和配置说明

前提条件

• 拥有AWS账号并配置正确的IAM权限，确保容器能够访问AWS SSM Parameter Store
• 需通过环境变量配置AWS凭证（如AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY）和区域（如AWS_REGION）

Docker运行示例

bash
# 查看Chamber帮助信息
docker run --rm \
  -e AWS_ACCESS_KEY_ID=your_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_secret_key \
  -e AWS_REGION=us-east-1 \
  chamber-image /chamber --help

# 存储密钥到SSM Parameter Store
docker run --rm \
  -e AWS_ACCESS_KEY_ID=your_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_secret_key \
  -e AWS_REGION=us-east-1 \
  chamber-image /chamber write myapp/db-password "secretpassword"

# 读取存储的密钥
docker run --rm \
  -e AWS_ACCESS_KEY_ID=your_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_secret_key \
  -e AWS_REGION=us-east-1 \
  chamber-image /chamber read myapp/db-password

docker-compose配置示例

yaml
version: '3'
services:
  chamber:
    image: chamber-image
    environment:
      - AWS_ACCESS_KEY_ID=your_access_key
      - AWS_SECRET_ACCESS_KEY=your_secret_key
      - AWS_REGION=us-east-1
    command: /chamber list myapp  # 列出myapp相关的所有密钥

常用命令

• write <service>/<key> <value>: 存储密钥到指定服务下
• read <service>/<key>: 读取指定密钥的值
• list <service>: 列出指定服务下的所有密钥
• delete <service>/<key>: 删除指定密钥
• help: 查看完整命令帮助