relaysh/aws-ec2-step-instances-terminate

aws-ec2-step-instances-terminate

镜像概述

aws-ec2-step-instances-terminate 是一个专为 CI/CD 流水线设计的步骤容器（Step Container），用于自动化终止指定的 Amazon EC2 实例。它通过调用 AWS EC2 API，帮助开发者和运维团队在部署、测试或资源清理阶段安全、高效地释放计算资源。

核心功能和特性

• 批量终止实例：支持通过实例 ID 列表一次性终止多个 EC2 实例。
• 流水线集成：专为 CI/CD 环境（如 Drone CI、Bitbucket Pipelines、GitHub Actions 等）设计，可作为自动化工作流中的一个独立步骤。
• 安全认证：支持通过环境变量或 IAM 角色注入 AWS 凭证，确保操作安全。
• 轻量级设计：镜像体积小，启动速度快，适合在流水线中频繁调用。

使用场景和适用范围

• 自动化测试清理：在集成测试或端到端测试完成后，自动销毁动态创建的测试环境 EC2 实例。
• 资源成本优化：在非工作时间或项目结束后，自动清理闲置的开发/测试环境实例。
• 基础设施即代码 (IaC) 辅助：配合 Terraform 或 CloudFormation 使用，处理无法通过常规 IaC 工具销毁的遗留或孤立实例。

配置参数与环境变量

在运行此容器时，通常需要通过环境变量传递 AWS 凭证和目标实例信息：

使用方法与部署示例

1. Docker CLI 运行示例

bash
docker run --rm \
  -e AWS_ACCESS_KEY_ID="your_access_key" \
  -e AWS_SECRET_ACCESS_KEY="your_secret_key" \
  -e AWS_DEFAULT_REGION="ap-northeast-1" \
  -e INSTANCE_IDS="i-0123456789abcdef0,i-0fedcba9876543210" \
  docker.xuanyuan.run/aws-ec2-step-instances-terminate

2. CI/CD 流水线集成示例 (以 Drone CI 为例)

yaml
kind: pipeline
type: docker
name: cleanup-environment

steps:
  - name: terminate-ec2-instances
    image: docker.xuanyuan.run/aws-ec2-step-instances-terminate
    environment:
      AWS_ACCESS_KEY_ID:
        from_secret: aws_access_key
      AWS_SECRET_ACCESS_KEY:
        from_secret: aws_secret_key
      AWS_DEFAULT_REGION: us-west-2
      INSTANCE_IDS: i-0123456789abcdef0
    when:
      status:
        - success
        - failure

3. Docker Compose 配置示例

yaml
version: '3.8'
services:
  ec2-terminator:
    image: docker.xuanyuan.run/aws-ec2-step-instances-terminate
    environment:
      - AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID}
      - AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY}
      - AWS_DEFAULT_REGION=eu-central-1
      - INSTANCE_IDS=i-0123456789abcdef0

注意事项

1. 权限控制：执行此操作的 AWS 凭证必须具备 ec2:TerminateInstances 权限。建议遵循最小权限原则，通过 IAM 策略限制可操作的实例范围（例如基于特定 Tag 进行条件限制）。
2. 数据丢失风险：终止 EC2 实例将导致实例存储（Instance Store）中的数据永久丢失，且默认情况下 EBS 根卷也会被删除。请在操作前确保已备份重要数据。
3. 保护机制：如果目标实例启用了“终止保护”（Termination Protection），API 调用将会失败。需先通过 API 或控制台禁用终止保护，才能成功终止实例。