ampedandwired/rancher-reaper

Rancher AWS终止主机清理服务（Rancher Reaper）

注意：本服务会删除Rancher中在AWS已终止的主机。请先在测试环境使用“干运行”模式验证功能，开发者不承担任何责任。

镜像概述

这是一个Docker服务，用于自动删除Rancher中在AWS已终止的主机。当Rancher环境使用AWS自动扩展主机时，Rancher不会自动清理已终止的主机，导致UI/API混乱，且无健康检查的容器无法重新调度到健康主机。本服务通过检查Rancher中“reconnecting”状态的主机，验证对应AWS实例是否终止，若终止则删除Rancher中的主机。

核心功能

• 定期检查Rancher中处于“reconnecting”状态的主机
• 验证对应AWS实例是否处于“terminated”状态
• 自动删除Rancher中已终止的AWS主机
• 支持干运行模式（仅日志操作，不实际删除）
• 可配置检查间隔、主机标签名称等参数

使用场景

• AWS自动扩展的Rancher Cattle主机环境
• 需要自动清理终止主机以保持Rancher UI整洁的场景
• 解决无健康检查容器未重新调度的问题

配置说明

主机标签要求

需为Rancher主机添加以下标签（可通过环境变量修改标签名称）：

• aws.instance_id：AWS实例ID（如i-8b92d524）
• aws.availability_zone：实例所在可用区（如us-west-1a）

添加标签示例（启动Rancher agent时）：

shell
sudo docker run -d --privileged -v /var/run/docker.sock:/var/run/docker.sock \
    -e CATTLE_HOST_LABELS="aws.instance_id=$(curl -s http://169.254.169.254/latest/meta-data/instance-id)&aws.availability_zone=$(curl -s http://169.254.169.254/latest/meta-data/placement/availability-zone)" \
    rancher/agent:v1.0.2 http://<rancher-server>/v1/scripts/<registrationToken>

环境变量配置

AWS IAM政策要求

需授予ec2:DescribeInstances和ec2:DescribeRegions权限：

json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": ["ec2:DescribeInstances", "ec2:DescribeRegions"],
      "Effect": "Allow",
      "Resource": "*"
    }
  ]
}

部署示例

docker-compose.yml

yaml
rancher-reaper:
  image: ampedandwired/rancher-reaper:latest
  tty: true
  environment:
    AWS_ACCESS_KEY_ID: ${AccessKeyId}
    AWS_SECRET_ACCESS_KEY: ${SecretAccessKey}
  labels:
    io.rancher.container.create_agent: 'true'
    io.rancher.container.agent.role: environment

rancher-compose.yml

yaml
rancher-reaper:
  scale: 1
  health_check:
    port: 3000
    interval: 2000
    unhealthy_threshold: 3
    strategy: recreate
    response_timeout: 2000
    request_line: GET / HTTP/1.0
    healthy_threshold: 2

开发说明

欢迎通过GitHub仓库提交建议或PR：https://github.com/ampedandwired/rancher-reaper

本地运行（需Ruby 2.x）：

shell
bundle install
bundle exec thin -R lib/config.ru start