base2/awsenv

base2/awsenv 镜像文档

镜像概述

base2/awsenv是一个安全处理Docker环境变量的工具镜像，Fork自https://github.com/Droplr/aws-env%EF%BC%8C%E9%80%9A%E8%BF%87%E8%AF%BB%E5%8F%96AWS SSM参数存储中的参数生成.env文件，实现环境变量的安全管理。

核心功能

1. 按指定路径检索AWS SSM参数并生成.env文件
2. 支持参数层级覆盖（高层级参数覆盖低层级同名参数）
3. 提供多格式输出（带export、shell、无引号shell）
4. 可输出到文件或标准输出（适用于只读文件系统）
5. 支持Sidecar容器模式或二进制提取集成

使用场景

• Sidecar容器：与主应用共享卷，动态提供环境变量文件
• 自定义镜像集成：将二进制复制到自有镜像，直接嵌入启动流程

配置说明

环境变量

• SSM_PATH [必填]：SSM参数存储的完整路径（如/my-app/production/prod1）
• AWS_REGION [必填]：参数所在的AWS区域（如ap-southeast-2）
• DIRECTORY [可选]：.env文件输出目录，默认/ssm（Sidecar模式不可修改）
• LOG_LEVEL [可选]：日志级别（fatal/error/warn/info/debug/disable），默认info
• TO_STDOUT [可选]：是否输出到标准输出（布尔值），需配合LOG_LEVEL≥warn
• FORMAT [可选]：输出格式（shell/unquoted-shell，默认带export）

命令行参数

• -v：显示版本信息并退出

部署示例

Sidecar容器（Docker Compose）

yaml
services:
  awsenv:
    image: base2/awsenv
    environment:
      SSM_PATH: /my-app/production/prod1
      AWS_REGION: ap-southeast-2
  
  app:
    image: your-app-image
    volumes_from: [awsenv]
    entrypoint: sh -c "eval $(cat /ssm/.env) && ./start-app"

二进制集成（Dockerfile）

Dockerfile
FROM base2/awsenv as awsenv
FROM debian:jessie
COPY --from=awsenv /awsenv /bin/
ENTRYPOINT sh -c "awsenv && eval $(cat /ssm/.env) && ./your-app"