aws-secretsmanager-agent是一个本地HTTP服务,可在计算环境中安装使用,用于从AWS Secrets Manager读取密钥并将其缓存在内存中。
aws-secretsmanager-agent Docker镜像文档
镜像概述和主要用途
aws-secretsmanager-agent是一个轻量级的本地HTTP服务,专为在计算环境中安全高效地管理AWS Secrets Manager密钥而设计。该镜像允许用户轻松部署此服务,实现从AWS Secrets Manager读取密钥并将其缓存在内存中,从而减少对AWS API的直接调用,提升应用访问密钥的性能和可靠性。
核心功能和特性
- 本地HTTP服务:提供简单的HTTP接口,便于应用程序访问密钥
- 密钥读取能力:直接与AWS Secrets Manager集成,安全读取存储的密钥
- 内存缓存:将读取的密钥缓存在内存中,减少重复API调用,降低延迟
- 轻量级设计:基于Alpine Linux构建,镜像体积小,资源占用低
使用场景和适用范围
- 容器化应用:在Docker或Kubernetes等容器环境中运行,为应用提供密钥访问服务
- 微服务架构:作为独立服务部署,为多个微服务提供集中式密钥管理
- 需要频繁访问密钥的应用:通过内存缓存减少API调用次数,优化性能
- AWS云环境:适用于部署在AWS EC2、ECS、EKS等计算服务中的应用
使用方法和配置说明
镜像获取
该镜像托管在Docker Hub,可通过以下链接查看可用标签:
https://hub.docker.com/repository/docker/alpine/asma/tags
拉取最新版本镜像:
bashdocker pull docker.xuanyuan.run/alpine/asma:latest
基本运行示例
bashdocker run -d \ --name aws-secretsmanager-agent \ -p 8080:8080 \ # 默认HTTP端口,可根据需要修改 -e AWS_REGION=us-east-1 \ # AWS区域配置 alpine/asma:latest
配置参数说明
目前详细配置参数可参考Dockerfile源码:
https://github.com/alpine-docker/multi-arch-docker-images/blob/master/asma/Dockerfile
通常需要配置的环境变量包括:
AWS_REGION:AWS区域(必填)PORT:服务监听端口(默认8080)CACHE_TTL:密钥缓存时间(默认根据密钥配置)
安全注意事项
- 确保容器具有适当的AWS IAM权限,建议通过IAM角色(如EC2实例角色、EKS服务账户角色)授予访问Secrets Manager的权限
- 生产环境中建议启用HTTPS加密传输(可通过反向代理实现)
- 限制容器网络访问,仅允许授权应用访问该服务端口
构建信息
- Dockerfile源码:https://github.com/alpine-docker/multi-arch-docker-images/blob/master/asma/Dockerfile
- 每日CI构建日志:N/A
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull alpine/asma:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务