AA (AWS Automation)

AWS 운영 자동화를 위한 CLI 도구입니다.

미사용 리소스 탐지, 보안 점검, IAM 감사, ALB 로그 분석 등 AWS 운영에 필요한 도구들을 하나로 통합했습니다. 멀티 계정·멀티 리전 환경을 지원하며, 대화형 메뉴에서 키워드 검색으로 필요한 도구를 빠르게 찾을 수 있습니다. 분석 결과는 Excel 보고서로 저장됩니다. 현재 19개 AWS 서비스를 지원하며, 지속적으로 새로운 도구를 추가할 예정입니다.

주요 기능

• 멀티 계정 & 리전: 여러 AWS 계정과 리전을 동시에 분석
• 다중 인증 지원: SSO Session, SSO Profile, Access Key 자동 감지
• Excel 보고서: 분석 결과를 Excel 파일로 자동 저장
• 키워드 검색: 대화형 메뉴에서 도구를 빠르게 검색
• 플러그인 구조: 새로운 도구를 쉽게 추가 가능

설치

PyPI (권장)

pip install aws-automation

소스에서 설치

git clone https://github.com/expeor/aws-automation.git
cd aws-automation
pip install -e .

사용법

aa                # 대화형 메인 메뉴
aa ec2            # EC2 도구 바로 실행
aa vpc            # VPC 도구 바로 실행

메인 메뉴

검색

> rds              # 서비스명
> 미사용           # 한글 키워드 (비용)
> 보안             # 한글 키워드 (보안)
> snapshot         # 영문 키워드

CLI 명령어

기본 사용법

aa                  # 대화형 메뉴
aa ec2              # EC2 도구 실행
aa --help           # 도움말
aa --version        # 버전 표시

Headless 모드 (CI/CD용)

대화형 프롬프트 없이 도구를 실행합니다. SSO Profile 또는 Access Key 프로파일만 지원합니다. 도구 경로는 aa list-tools로 확인하세요.

# 도구 경로 확인
aa list-tools

# 기본 실행
aa run ec2/ebs_audit -p my-profile -r ap-northeast-2

# 다중 리전
aa run ec2/ebs_audit -p my-profile -r ap-northeast-2 -r us-east-1

# 전체 리전
aa run ec2/ebs_audit -p my-profile -r all

# 프로파일 그룹으로 실행
aa run ec2/ebs_audit -g "개발 환경" -r ap-northeast-2

# JSON 출력
aa run ec2/ebs_audit -p my-profile -f json -o result.json

옵션:

도구 목록 조회

aa list-tools              # 전체 도구 목록
aa list-tools -c ec2       # EC2 카테고리만
aa list-tools --json       # JSON 출력

프로파일 그룹 관리

여러 프로파일을 그룹으로 묶어 한 번에 실행할 수 있습니다.

aa group list              # 그룹 목록
aa group show "개발 환경"   # 그룹 상세
aa group create            # 그룹 생성 (인터랙티브)
aa group delete "개발 환경" # 그룹 삭제

지원 서비스

요구 사항

• Python 3.10 ~ 3.13
• AWS CLI 프로필 설정 (~/.aws/config)

업데이트

# PyPI 설치 시
pip install --upgrade aws-automation

# 소스 설치 시
git pull && pip install -e .

라이선스

MIT License - LICENSE