vizuri/train

Train镜像说明

概述

Train是一套封装在Docker容器中的AWS CLI工具集，用于管理AWS用户、VPC、密钥/安全配置、AMI、自定义实验室（按标签分组的AWS实例集合）及实验室集合，适用于演示、测试和培训场景。

核心功能

• train: 主工具，管理所有VPC对象和实例
• train-users: 管理允许使用train的额外用户
• train-images: 管理与自定义实验室关联的AMI

工具支持快速创建、管理和销毁以下资源：

VPC对象

• VPC、IAM角色/策略、网关、路由表、网络ACL、子网
• 默认安全组及规则、多用户密钥对
• 实验室（多实例分组配置）
• 所有创建对象/文件的终止与清理

AWS IAM用户

• 创建、列出、删除AWS IAM用户

AMI管理

• 创建、列出、删除与自定义实验室关联的AMI

培训/测试注册

• 批量注册（为文本文件中的用户启动实验室）
• 注册模式：自助式注册，提示输入***以启动实验室

环境要求

AWS权限

建议使用独立于生产环境的AWS账户，train需要创建/列出/销毁VPC、EC2实例、IAM用户等权限。通过train-users创建的用户将拥有预设策略。

环境变量

可通过Docker环境文件、运行时参数或容器内直接导出设置环境变量。

必选变量

# 用户名（仅用于标签）
TRAINER=jbaker
# AWS认证信息
AWS_ACCESS_KEY_ID=<你的密钥ID>
AWS_SECRET_ACCESS_KEY=<你的密钥>
# AWS区域
AWS_REGION=<ec2区域>

可选变量

# AWS SES配置
SES_REGION=<ses区域>
SES_FROM_EMAIL=<发件邮箱>
SES_FROM_NAME=<发件人名称>
# 实验室根目录
LAB_DIR=<目录路径>
# 用户配置文件路径
USER_FILE=<文件路径>
# VPC标签（区分环境）
VPC=<标签名>
# 邮件模板路径
EMAIL_TEMPLATE=<容器内路径>
# 自定义标签
USERTAG=<字符串>

主机卷挂载

运行容器时需将本地目录挂载到容器内/host，用于存储用户密钥和实例信息。

Docker部署示例

拉取镜像

bash
docker pull vizuri/train

运行容器（个人使用）

1. 创建环境文件train.env：

TRAINER=jbaker
VPC=demo
AWS_REGION=us-east-1
AWS_ACCESS_KEY_ID=<你的密钥ID>
AWS_SECRET_ACCESS_KEY=<你的密钥>

2. 启动容器：

bash
docker run -ti --rm --env-file='train.env' -v $(pwd):/host vizuri/train

使用场景

个人演示

• 创建VPC：train -vk
• 列出可用实验室：train -a
• 启动实验室：train -x <实验室名称>
• 查看运行实例：train -l
• 清理环境：train -t

批量注册培训用户

1. 创建users.cfg文件（每行格式：用户名,***）
2. 启动容器并运行train -x <实验室名称>批量创建实例
3. 发送邮件：train -e

AMI管理

• 创建实验室AMI：train-images -c <实验室标签>
• 列出AMI：train-images -l
• 注销AMI：train-images -d <实验室名称>

用户管理

使用train-users工具管理AWS IAM用户，执行train-users查看帮助文档。