{"id":37076378,"url":"https://github.com/expeor/aws-automation","last_synced_at":"2026-01-14T08:59:02.873Z","repository":{"id":331344864,"uuid":"1126223939","full_name":"expeor/aws-automation","owner":"expeor","description":"AWS 운영 자동화 CLI - 멀티 계정/리전 지원, Excel 보고서 생성","archived":false,"fork":false,"pushed_at":"2026-01-06T07:13:14.000Z","size":995,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-01-06T17:42:31.213Z","etag":null,"topics":["automation","aws","cli","compliance","cost-optimization","devops","inventory","multi-account","multi-region","ops","python","security-audit","sre"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/expeor.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-01T12:32:02.000Z","updated_at":"2026-01-06T07:13:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/expeor/aws-automation","commit_stats":null,"previous_names":["expeor/aws-automation"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/expeor/aws-automation","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/expeor%2Faws-automation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/expeor%2Faws-automation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/expeor%2Faws-automation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/expeor%2Faws-automation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/expeor","download_url":"https://codeload.github.com/expeor/aws-automation/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/expeor%2Faws-automation/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28414729,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T08:38:59.149Z","status":"ssl_error","status_checked_at":"2026-01-14T08:38:43.588Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","aws","cli","compliance","cost-optimization","devops","inventory","multi-account","multi-region","ops","python","security-audit","sre"],"created_at":"2026-01-14T08:59:02.140Z","updated_at":"2026-01-14T08:59:02.858Z","avatar_url":"https://github.com/expeor.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AA (AWS Automation)\n\n[![PyPI](https://img.shields.io/pypi/v/aws-automation?color=blue\u0026logo=pypi\u0026logoColor=white)](https://pypi.org/project/aws-automation/)\n[![CI](https://github.com/expeor/aws-automation/actions/workflows/ci.yml/badge.svg)](https://github.com/expeor/aws-automation/actions/workflows/ci.yml)\n[![Python](https://img.shields.io/badge/Python-3.10--3.13-3776AB?logo=python\u0026logoColor=white)](https://python.org/)\n[![Ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\nAWS 운영 자동화를 위한 CLI 도구입니다.\n\n미사용 리소스 탐지, 보안 점검, IAM 감사, 로그 분석 등 40개 이상의 AWS 운영 도구를 제공합니다. 멀티 계정·멀티 리전을 지원하며, 결과는 Excel로 저장됩니다.\n\n## 주요 기능\n\n- **멀티 계정 \u0026 리전**: 여러 AWS 계정과 리전을 동시에 분석\n- **다중 인증 지원**: SSO Session, SSO Profile, Access Key 자동 감지\n- **Excel 보고서**: 분석 결과를 Excel 파일로 자동 저장\n- **키워드 검색**: 대화형 메뉴에서 도구를 빠르게 검색\n- **플러그인 구조**: 새로운 도구를 쉽게 추가 가능\n\n## 설치\n\n### PyPI (권장)\n\n```bash\npip install aws-automation\n```\n\n### 소스에서 설치\n\n```bash\ngit clone https://github.com/expeor/aws-automation.git\ncd aws-automation\npip install -e .\n```\n\n## 사용법\n\n```bash\naa                # 대화형 메인 메뉴\naa ec2            # EC2 도구 바로 실행\naa vpc            # VPC 도구 바로 실행\n```\n\n### 메인 메뉴\n\n| 키  | 설명                     |\n| --- | ------------------------ |\n| `a` | 전체 도구                |\n| `s` | AWS 서비스별 (EC2, RDS…) |\n| `c` | AWS 분류별 (Compute…)    |\n| `t` | 점검 유형 (보안, 비용…)  |\n| `f` | 즐겨찾기                 |\n| `p` | 프로필                   |\n| `g` | 프로필 그룹              |\n| `q` | 종료                     |\n\n### 검색\n\n```bash\n\u003e rds              # 서비스명\n\u003e 미사용           # 한글 키워드 (비용)\n\u003e 보안             # 한글 키워드 (보안)\n\u003e snapshot         # 영문 키워드\n```\n\n## CLI 명령어\n\n### 기본 사용법\n\n```bash\naa                  # 대화형 메뉴\naa ec2              # EC2 도구 실행\naa --help           # 도움말\naa --version        # 버전 표시\n```\n\n### Headless 모드\n\n대화형 프롬프트 없이 도구를 실행합니다. SSO Profile 또는 Access Key 프로파일을 지원합니다.\n\n```bash\n# 도구 경로 확인\naa list-tools\n\n# 기본 실행\naa run ec2/ebs_audit -p my-profile -r ap-northeast-2\n\n# 다중 리전\naa run ec2/ebs_audit -p my-profile -r ap-northeast-2 -r us-east-1\n\n# 전체 리전\naa run ec2/ebs_audit -p my-profile -r all\n\n# 프로파일 그룹으로 실행\naa run ec2/ebs_audit -g \"개발 환경\" -r ap-northeast-2\n\n# JSON 출력\naa run ec2/ebs_audit -p my-profile -f json -o result.json\n```\n\n**옵션:**\n\n| 옵션                  | 설명                                 |\n| --------------------- | ------------------------------------ |\n| `-p, --profile`       | SSO Profile 또는 Access Key 프로파일 |\n| `-g, --profile-group` | 저장된 프로파일 그룹 이름            |\n| `-r, --region`        | 리전 (다중 가능, `all` 또는 패턴)    |\n| `-f, --format`        | 출력 형식 (`console`, `json`, `csv`) |\n| `-o, --output`        | 출력 파일 경로                       |\n| `-q, --quiet`         | 최소 출력 모드                       |\n\n### 도구 목록 조회\n\n```bash\naa list-tools              # 전체 도구 목록\naa list-tools -c ec2       # EC2 카테고리만\naa list-tools --json       # JSON 출력\n```\n\n### IP 검색\n\nVPC 내 IP 주소를 빠르게 검색합니다.\n\n```bash\naa ip                      # 대화형 모드\naa ip 10.0.1.50            # 단일 IP 검색\naa ip 10.0.0.0/8           # CIDR 범위 검색\naa ip 10.0.1.50 -d         # 상세 모드 (API 조회)\naa ip vpc-0a6d4f22 -c      # VPC 검색 + CSV 저장\n```\n\n### 프로파일 그룹 관리\n\n여러 프로파일을 그룹으로 묶어 한 번에 실행할 수 있습니다.\n\n```bash\naa group list              # 그룹 목록\naa group show \"개발 환경\"   # 그룹 상세\naa group create            # 그룹 생성 (인터랙티브)\naa group delete \"개발 환경\" # 그룹 삭제\n```\n\n## 지원 서비스\n\n| 서비스          | 주요 도구                             |\n| --------------- | ------------------------------------- |\n| EC2             | EBS/EIP/Snapshot/AMI 미사용 분석      |\n| VPC             | 보안 그룹 감사, NAT Gateway, IP 검색  |\n| Lambda          | 미사용/버전/Provisioned 분석          |\n| S3              | 빈 버킷 탐지                          |\n| IAM             | 사용자/역할 감사, 정책 분석           |\n| RDS             | 스냅샷 감사                           |\n| ELB             | ALB/NLB 감사, 로그 분석, 마이그레이션 |\n| DynamoDB        | 용량 모드 분석, 미사용 테이블 탐지    |\n| CloudWatch      | 로그 그룹 감사, 알람 분석             |\n| CloudTrail      | Trail 감사                            |\n| CloudFormation  | 리소스 검색                           |\n| Route53         | 빈 호스팅 영역 탐지                   |\n| ECR             | 미사용 저장소 탐지                    |\n| KMS             | 키 사용 감사                          |\n| Secrets Manager | 미사용 시크릿 탐지                    |\n| SSO             | SSO 구성 감사                         |\n| ACM             | 미사용/만료 임박 인증서 탐지          |\n| EFS             | 미사용 파일시스템 탐지                |\n| SNS/SQS         | 미사용 토픽/큐 탐지                   |\n| ElastiCache     | 미사용 클러스터 탐지                  |\n| API Gateway     | 미사용 API 탐지                       |\n| EventBridge     | 미사용 규칙 탐지                      |\n| CodeCommit      | 미사용 리포지토리 탐지                |\n| Health          | AWS Health 이벤트 분석                |\n| Cost            | Cost Optimization Hub, 통합 분석      |\n| Tag Editor      | MAP 2.0 태그 감사/적용                |\n\n## 요구 사항\n\n- Python 3.10 ~ 3.13\n- AWS CLI 프로필 설정 (`~/.aws/config`)\n\n## 업데이트\n\n```bash\n# PyPI 설치 시\npip install --upgrade aws-automation\n\n# 소스 설치 시\ngit pull \u0026\u0026 pip install -e .\n```\n\n## 외부 데이터 출처\n\n이 도구는 다음 외부 데이터를 사용합니다:\n\n**IP 검색:**\n\n- [AWS IP Ranges](https://ip-ranges.amazonaws.com/ip-ranges.json)\n- [GCP IP Ranges](https://www.gstatic.com/ipranges/cloud.json)\n- [Azure ServiceTags](https://www.microsoft.com/en-us/download/details.aspx?id=56519)\n- [Oracle Cloud IP Ranges](https://docs.oracle.com/en-us/iaas/tools/public_ip_ranges.json)\n\n**ALB 로그 분석:**\n\n- [IPdeny Country IP Blocks](https://www.ipdeny.com/ipblocks/)\n- [AbuseIPDB Blocklist](https://github.com/borestad/blocklist-abuseipdb)\n\n## 라이선스\n\nMIT License - [LICENSE](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexpeor%2Faws-automation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexpeor%2Faws-automation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexpeor%2Faws-automation/lists"}