szm9119/awslimitchecker

awslimitcheck Docker镜像文档

镜像概述

本镜像基于更新的Python基础镜像重新构建，集成了awslimitchecker工具，提供Docker化部署方案，用于便捷检查AWS服务限制和配额。通过更新Python基础版本，提升了运行时兼容性、安全性及依赖管理效率，简化AWS资源配额监控流程。

核心功能与特性

• 基于最新Python基础镜像：采用更新的Python版本构建，修复潜在安全漏洞，提升与现代依赖库的兼容性
• 集成awslimitchecker工具：预安装并配置awslimitchecker，无需手动处理依赖关系，开箱即可使用
• 轻量级部署：Docker化封装减少环境配置复杂度，支持快速集成到现有运维流程
• 灵活凭证配置：支持通过环境变量或挂载文件方式注入AWS访问凭证，适配多种部署场景

使用场景

• AWS资源配额日常监控与预警
• 多账户/多区域AWS服务限额统一检查
• 自动化运维流程中的配额合规性校验
• 云资源扩容前的限额预评估

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+推荐）
• 拥有具备AWS服务配额查看权限的IAM用户凭证（需包含quota:ListServiceQuotas等权限）

快速启动命令

通过以下命令快速运行镜像，检查默认区域（us-east-1）的AWS服务配额：

bash
docker run --rm \
  -e AWS_ACCESS_KEY_ID="AKIAEXAMPLE" \
  -e AWS_SECRET_ACCESS_KEY="secretExample" \
  awslimitcheck:latest check

环境变量配置

高级使用示例

指定区域与输出格式

检查eu-west-1区域配额并以JSON格式输出：

bash
docker run --rm \
  -e AWS_ACCESS_KEY_ID="AKIAEXAMPLE" \
  -e AWS_SECRET_ACCESS_KEY="secretExample" \
  -e AWS_REGION="eu-west-1" \
  -e OUTPUT_FORMAT="json" \
  awslimitcheck:latest check

挂载本地AWS凭证文件

通过挂载~/.aws/credentials文件使用本地凭证：

bash
docker run --rm \
  -v ~/.aws/credentials:/root/.aws/credentials:ro \
  -e AWS_REGION="ap-southeast-1" \
  -e AWS_PROFILE="production" \
  awslimitcheck:latest check

自定义检查参数

传递awslimitchecker原生参数（如过滤特定服务、设置警告阈值）：

bash
docker run --rm \
  -e AWS_ACCESS_KEY_ID="AKIAEXAMPLE" \
  -e AWS_SECRET_ACCESS_KEY="secretExample" \
  awslimitcheck:latest check --services ec2,s3 --warning 80 --critical 90

注：--services指定检查的AWS服务，--warning/--critical设置配额使用率警告/ critical阈值（百分比）

常见问题

• 凭证权限不足：确保IAM用户具备quota:ListServiceQuotas、ec2:DescribeAccountAttributes等必要权限
• 区域不可用：通过AWS_REGION环境变量指定AWS支持的区域代码（如us-west-2、cn-north-1）
• 输出格式异常：使用OUTPUT_FORMAT=json时，可通过jq工具解析结果：docker run ... | jq '.services.ec2'