webdevops/azure-janitor

Azure Janitor

Azure Janitor 是一个用于清理 Azure 资源组、资源和部署的 Docker 镜像，基于 TTL 标签控制资源过期清理，并支持按部署的 TTL（生存时间）和数量限制进行清理，帮助自动管理 Azure 资源生命周期，避免资源闲置和成本浪费。

核心功能和特性

• 多类型资源清理：支持清理 Azure 资源组、资源和部署
• TTL 标签控制：基于资源标签（默认标签名 ttl）判断资源是否过期，支持绝对时间戳和相对时间戳
• 部署管理：可按 TTL 和数量限制清理资源组部署（默认 TTL 8760h，限制 700 个/资源组）
• 灵活配置：通过环境变量自定义清理间隔、API 版本、过滤条件等
• 监控支持：提供清理时长、资源过期时间、删除数量和错误数等指标，便于监控和审计

配置说明

通常无需额外配置，但可通过环境变量自定义行为。

Azure API 认证（通过环境变量）详见 https://github.com/Azure/azure-sdk-for-go#authentication%E3%80%82

Azure 标签

默认使用 ttl 标签标记资源过期时间，触发清理。

支持的绝对时间戳格式

• 2006-01-02 15:04:05 +07:00
• 2006-01-02 15:04:05 MST
• 2006-01-02 15:04:05
• 02 Jan 06 15:04 MST（RFC822）
• 02 Jan 06 15:04 -0700（RFC822Z）
• Monday, 02-Jan-06 15:04:05 MST（RFC850）
• Mon, 02 Jan 2006 15:04:05 MST（RFC1123）
• Mon, 02 Jan 2006 15:04:05 -0700（RFC1123Z）
• 2006-01-02T15:04:05Z07:00（RFC3339）
• 2006-01-02T15:04:05.999999999Z07:00（RFC3339Nano）

支持的相对时间戳格式

（发现后标签会自动更新为绝对时间戳）

• ISO8601 持续时间
  • PT24H（24小时）
  • P1M（1个月）
• https://github.com/karrick/tparse
  • 1h（1小时）
  • 1d（1天）
  • 1w（1周）
  • 1mo（1个月）
  • 1y（1年）

监控指标

使用示例

Docker 运行命令

bash
docker run -d \
  -e AZURE_SUBSCRIPTION_ID="your-subscription-id" \
  -e AZURE_TENANT_ID="your-tenant-id" \
  -e AZURE_CLIENT_ID="your-client-id" \
  -e AZURE_CLIENT_SECRET="your-client-secret" \
  -e JANITOR_INTERVAL="30m" \
  -e DRYRUN="true" \
  webdevops/azure-janitor

docker-compose 配置

yaml
version: '3'
services:
  azure-janitor:
    image: webdevops/azure-janitor
    environment:
      - AZURE_SUBSCRIPTION_ID=your-subscription-id
      - AZURE_TENANT_ID=your-tenant-id
      - AZURE_CLIENT_ID=your-client-id
      - AZURE_CLIENT_SECRET=your-client-secret
      - JANITOR_INTERVAL=1h
      - JANITOR_DEPLOYMENT_TTL=720h
      - JANITOR_DEPLOYMENT_LIMIT=500
    ports:
      - "8080:8080"  # 暴露指标和健康检查端口

适用场景

• 开发/测试环境的资源自动清理，避免长期闲置
• 按合规要求定期清理过期资源
• 控制 Azure 部署数量，避免达到 Azure 部署上限（800个/资源组）
• 降低 Azure 资源成本，优化资源利用率