wonderlic/ebs-sidekick

wonderlic/ebs-sidekick

链接

• GitHub: https://github.com/wonderlic/docker-ebs-sidekick
• Docker Hub: https://registry.hub.docker.com/u/wonderlic/ebs-sidekick/

镜像概述

该Docker镜像用于将Amazon EBS卷挂载到Amazon EC2实例，并在收到SIGINT或SIGTERM信号时自动卸载该卷。它设计为CoreOS集群中的辅助容器（sidekick），为需要持久存储的其他容器提供EBS卷的自动管理功能。

核心功能

1. 自动挂载指定的Amazon EBS卷到EC2实例
2. 监听停止信号（SIGINT/SIGTERM）并触发卷卸载操作
3. 支持自动从EC2元数据服务获取当前实例ID（若未手动指定）

使用场景

适用于CoreOS集群中需要持久存储的容器场景，例如：

• 数据库容器（如MySQL、PostgreSQL）需要持久化数据存储时，作为辅助容器管理EBS卷的挂载与卸载
• 其他需要动态挂载EBS卷的应用容器场景

配置说明

运行镜像时需提供以下环境变量：

• AWS_ACCESS_KEY_ID: AWS访问密钥ID
• AWS_SECRET_ACCESS_KEY: AWS秘密访问密钥
• AWS_DEFAULT_REGION: AWS区域（如us-east-1）
• VOLUME_ID: 目标EBS卷的ID
• DEVICE: 挂载设备路径（如/dev/xvdf）
• INSTANCE_ID（可选）: 目标EC2实例ID，若未提供则自动从元数据服务获取

Docker部署示例

bash
docker run \
  -e AWS_ACCESS_KEY_ID=你的AWS访问密钥ID \
  -e AWS_SECRET_ACCESS_KEY=你的AWS秘密访问密钥 \
  -e AWS_DEFAULT_REGION=你的AWS区域 \
  -e VOLUME_ID=你的EBS卷ID \
  -e DEVICE=/dev/xvdf \
  wonderlic/ebs-sidekick

示例IAM政策

为确保镜像能正常操作EBS卷，需为EC2实例或IAM用户配置以下政策（替换占位符为实际值）：

json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["ec2:DescribeVolumes"],
      "Resource": "*"
    },
    {
      "Effect": "Allow",
      "Action": ["ec2:AttachVolume", "ec2:DetachVolume"],
      "Resource": "arn:aws:ec2:[REGION]:[ACCOUNT]:instance/*",
      "Condition": {"StringEquals": {"ec2:ResourceTag/Name": "[INSTANCE_NAME_TAG]"}}
    },
    {
      "Effect": "Allow",
      "Action": ["ec2:AttachVolume", "ec2:DetachVolume"],
      "Resource": "arn:aws:ec2:[REGION]:[ACCOUNT]:volume/*",
      "Condition": {"StringEquals": {"ec2:ResourceTag/Name": "[VOLUME_NAME_TAG]"}}
    }
  ]
}

替换[REGION]、[ACCOUNT]、[INSTANCE_NAME_TAG]和[VOLUME_NAME_TAG]为您环境中的对应值。