runbooks

Name	runbooks JSON
Version	1.1.10 JSON
	download
home_page	None
Summary	CloudOps Automation Toolkit with Enhanced Cloud Foundations Assessment for DevOps and SRE teams.
upload_time	2025-10-14 01:01:08
maintainer	None
docs_url	None
author	None
requires_python	<3.14,>=3.11
license	None
keywords	runbooks automation devops sre cloudops aws cloud-foundations finops enterprise cost-optimization security-compliance multi-account business-intelligence
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # 🚀 CloudOps Runbooks - Enterprise AWS Automation

[![PyPI](https://img.shields.io/pypi/v/runbooks)](https://pypi.org/project/runbooks/)
[![Python](https://img.shields.io/pypi/pyversions/runbooks)](https://pypi.org/project/runbooks/)
[![License](https://img.shields.io/pypi/l/runbooks)](https://opensource.org/licenses/Apache-2.0)
[![Documentation](https://img.shields.io/badge/docs-latest-brightgreen)](https://cloudops.oceansoft.io/runbooks/)
[![Downloads](https://img.shields.io/pypi/dm/runbooks)](https://pypi.org/project/runbooks/)

> **Enterprise-Grade Production-Ready AWS automation toolkit for DevOps and SRE teams managing Multi-Account Hybrid-Cloud environments at Scale** 🏢⚡

**Quick Value**: Discover, analyze, and optimize AWS resources across multi-account AWS environments with production-validated automation patterns.

---

## Runbooks FinOps & AWS MCP Servers

> The hybrid approach (Runbooks FinOps & AWS MCPs) leverages the strengths of both solutions: AWS MCPs for real-time accuracy data access and Runbooks FinOps for business intelligence and visualization, ensuring optimal cost optimization results for your enterprise environment.

---

## 🏆 **5-Minute Manager Success Path**

### **Step 1: Installation** (30 seconds)
```bash
pip install runbooks
runbooks --version
```

### **Step 2: Cost Discovery** (3 minutes)
```bash
# Replace with your billing profile
export AWS_BILLING_PROFILE="your-billing-readonly-profile"
runbooks finops --dry-run --profile $AWS_BILLING_PROFILE

# Expected output: Cost optimization opportunities across multiple categories
```

### **Step 3: Executive Reports** (90 seconds)
```bash
runbooks finops --export pdf --report-name executive-summary
runbooks finops --export csv --detailed-analysis
```

## 🎯 Why CloudOps Runbooks?

| Feature | Benefit | Status |
|---------|---------|--------|
| 🤖 **AI-Agents Orchestration** | AI-Agents FAANG SDLC coordination | ✅ Production Ready |
| ⚡ **Blazing Performance** | Sub-second CLI responses | ✅ 0.11s execution |
| 💰 **Cost Analysis** | Multi-account cost monitoring | ✅ Real-time analysis |
| 🔒 **Enterprise Security** | Zero-trust, compliance ready | ✅ SOC2, PCI-DSS, HIPAA |
| 🏗️ **Multi-Account Ready** | Universal AWS integration | ✅ 200+ accounts supported |
| 📊 **Rich Reporting** | Executive + technical dashboards | ✅ 15+ output formats |

## 💰 **Strategic Value Framework**

### **Business Impact Matrix**
```bash
# Enterprise cost optimization suite
pip install runbooks

# Business scenario analysis
runbooks finops --scenario workspaces --dry-run
runbooks finops --scenario nat-gateway --dry-run
runbooks finops --scenario elastic-ip --dry-run
runbooks finops --scenario rds-snapshots --dry-run
runbooks finops --scenario ebs-volumes --dry-run

# Strategic analysis modes
runbooks finops --profile $AWS_BILLING_PROFILE            # Cost visibility
runbooks finops --trend --profile $AWS_BILLING_PROFILE    # Trend analysis
runbooks finops --audit --profile $AWS_BILLING_PROFILE    # Audit compliance
```

### **Executive-Ready Deliverables**
| Scenario | Time to Value | Deliverable |
|----------|---------------|-------------|
| 🏢 **WorkSpaces Optimization** | 2 minutes | Executive PDF report |
| 🌐 **Network Cost Reduction** | 3 minutes | Cost analysis dashboard |
| 📊 **Storage Efficiency** | 2 minutes | Optimization roadmap |
| 🎯 **Complete Cost Audit** | 5 minutes | Comprehensive analysis |

## 📦 Installation & Quick Start

### Production Installation
```bash
pip install runbooks

# Verify installation
runbooks --help
runbooks inventory collect --help
```

### Configuration
```bash
# Set up your AWS profiles
export AWS_BILLING_PROFILE="your-billing-readonly-profile"
export AWS_MANAGEMENT_PROFILE="your-management-readonly-profile"
export AWS_OPERATIONS_PROFILE="your-operations-readonly-profile"

# Test single account access
runbooks inventory collect --profile $AWS_OPERATIONS_PROFILE --regions us-east-1
```

## 🧰 Core Modules

| Module | Purpose | Key Commands | Business Value |
|--------|---------|--------------|----------------|
| 📊 **Inventory** | Multi-account resource discovery | `runbooks inventory collect` | Complete visibility across 50+ services |
| 💰 **FinOps** | Multi-account cost analysis | `runbooks finops` | Real-time cost optimization |
| 🔒 **Security** | Compliance & baseline testing | `runbooks security assess` | 15+ security checks, 4 languages |
| 🏛️ **CFAT** | Cloud Foundations Assessment | `runbooks cfat assess` | Executive-ready compliance reports |
| ⚙️ **Operate** | Resource lifecycle management | `runbooks operate ec2 start` | Safe resource operations |
| 🔗 **VPC** | Network analysis & optimization | `runbooks vpc analyze` | Network cost optimization |
| 🏢 **Organizations** [PLANNED] | OU structure management | Coming in v1.2 | Landing Zone automation |
| 🛠️ **Remediation** [PLANNED] | Automated security fixes | Coming in v1.2 | 50+ security playbooks |

## ⚡ Essential Commands Reference

### 🔍 Discovery & Inventory
```bash
# Multi-service resource discovery
runbooks inventory collect -r ec2,s3,rds --profile production

# Cross-account organization scan
runbooks scan --all-accounts --include-cost-analysis

# Specialized discovery operations
runbooks inventory collect -r lambda --include-code-analysis
```

### 💰 Cost Management
```bash
# Interactive cost dashboard
runbooks finops --profile your-billing-profile

# Cost optimization analysis
runbooks finops --optimize --target-savings 30

# Multi-account cost aggregation
runbooks finops --all-accounts --breakdown-by service,account,region
```

### 🔒 Security & Compliance
```bash
# Security baseline assessment
runbooks security assess --profile production --language EN

# Multi-framework compliance check
runbooks cfat assess --compliance-framework "AWS Well-Architected"

# Specialized security operations
runbooks security check root_mfa --profile management
```

### ⚙️ Resource Operations
```bash
# Safe EC2 operations (dry-run by default)
runbooks operate ec2 stop --instance-ids i-1234567890abcdef0 --dry-run

# S3 security hardening
runbooks operate s3 set-public-access-block --account-id 123456789012

# CloudFormation operations
runbooks operate cloudformation move-stack-instances \
  --source-stackset old-baseline --target-stackset new-baseline --dry-run
```

### 🎨 CLI Parameter Flexibility (v1.1.10+)

**Enhanced UX**: All commands now support flexible format specification with **short flag support**

#### Triple Alias Pattern
Choose your preferred parameter style - all forms work identically:

| Style | Example | Use Case |
|-------|---------|----------|
| **Short** ✨ | `-f json` | Interactive CLI (save keystrokes) |
| **Standard** | `--format json` | Scripts & automation |
| **Legacy** | `--export-format json` | Backward compatibility |

#### Examples - All Three Forms Work

**Organization Visualization**:
```bash
# All three commands produce identical output
runbooks inventory draw-org -f graphviz --profile $MANAGEMENT_PROFILE
runbooks inventory draw-org --format graphviz --profile $MANAGEMENT_PROFILE
runbooks inventory draw-org --export-format graphviz --profile $MANAGEMENT_PROFILE
```

**Cost Analysis Export**:
```bash
# Choose your preferred style
runbooks finops analyze -f csv --profile $BILLING_PROFILE
runbooks finops analyze --format csv --profile $BILLING_PROFILE
runbooks finops analyze --export-format csv --profile $BILLING_PROFILE
```

**Account Inventory**:
```bash
# Short form for interactive use (NEW in v1.1.10)
runbooks inventory list-org-accounts -f json --output accounts.json

# Standard form for scripts
runbooks inventory list-org-accounts --format csv --output accounts.csv

# Legacy form (fully supported)
runbooks inventory list-org-accounts --export-format markdown --output accounts.md
```

#### Supported Commands (13 Total)

| Module | Command | Formats | v1.1.10 |
|--------|---------|---------|---------|
| Inventory | `draw-org` | graphviz, mermaid, diagrams | ✅ |
| Inventory | `list-org-accounts` | json, csv, markdown, table | ✅ |
| Inventory | `list-org-users` | json, csv, markdown, table | ✅ |
| Inventory | `find-lz-versions` | json, csv, markdown, table | ✅ |
| Inventory | `check-landingzone` | json, markdown, table | ✅ |
| Inventory | `check-controltower` | json, markdown, table | ✅ |
| FinOps | `infrastructure analyze` | json, csv, markdown | ✅ |
| FinOps | `elastic-ip` | json, csv, markdown | ✅ |
| FinOps | `ebs` | json, csv, markdown | ✅ |
| FinOps | `vpc-endpoint` | json, csv, markdown | ✅ |
| FinOps | `nat-gateway` | json, csv, markdown | ✅ |
| FinOps | `load-balancer` | json, csv, markdown | ✅ |

#### Migration Guide

**Zero Breaking Changes**: All existing scripts continue working without modification

**Adoption Path**:
- ✅ **Now**: All parameter forms work (choose preferred style)
- 💡 **Recommended**: Adopt `-f` for interactive CLI usage (faster typing)
- 📝 **Scripts**: Update at your convenience (no urgency)
- 🔄 **Future**: v1.2.0 will show deprecation warnings for legacy parameters

## 🏗️ Architecture Highlights

### Modern Stack
- **🐍 Python 3.11+**: Modern async capabilities
- **⚡ UV + Ruff**: 10x faster dependency resolution & linting
- **🎨 Rich CLI**: Beautiful terminal interfaces
- **📊 Pydantic V2**: Type-safe data models
- **🔗 boto3**: Native AWS SDK integration
- **🤖 MCP Servers**: Real-time AWS API access ([MCP Specification](https://modelcontextprotocol.io/))

### Enterprise Features
- **🔐 Multi-Profile AWS**: Seamless account switching
- **🌐 Multi-Language Reports**: EN/JP/KR/VN support
- **📈 DORA Metrics**: DevOps performance tracking
- **🚨 Safety Controls**: Dry-run defaults, approval workflows
- **📊 Executive Dashboards**: Business-ready reporting

## 📚 Documentation

### Quick Links
- **🏠 [Homepage](https://cloudops.oceansoft.io)** - Official project website
- **📖 [Documentation](https://cloudops.oceansoft.io/runbooks/)** - Complete guides
- **🐛 [Issues](https://github.com/1xOps/CloudOps-Runbooks/issues)** - Bug reports & features
- **💬 [Discussions](https://github.com/1xOps/CloudOps-Runbooks/discussions)** - Community support

### Enterprise Module Documentation

| Module | Documentation Hub | Key Business Value | Technical Implementation |
|--------|-------------------|-------------------|--------------------------|
| 💰 **FinOps** | [📊 Module Hub](docs/modules/finops/) | 20-40% cost optimization | [Code](src/runbooks/finops/) |
| 🔒 **Security** | [🛡️ Module Hub](docs/modules/security/) | 15+ security checks, 4 languages | [Code](src/runbooks/security/) |
| 📊 **Inventory** | [🔍 Module Hub](docs/modules/inventory/) | 50+ AWS services discovery | [Code](src/runbooks/inventory/) |
| ⚙️ **Operations** | [🔧 Module Hub](docs/modules/operate/) | Resource lifecycle management | [Code](src/runbooks/operate/) |

## 🔧 Configuration

### AWS Profiles Setup
```bash
# Environment variables for enterprise setup
export AWS_BILLING_PROFILE="your-billing-readonly-profile"
export AWS_MANAGEMENT_PROFILE="your-management-readonly-profile"
export AWS_OPERATIONS_PROFILE="your-operations-readonly-profile"

# Universal profile usage patterns
runbooks finops --profile $AWS_BILLING_PROFILE      # Cost analysis
runbooks inventory collect --profile $AWS_MANAGEMENT_PROFILE  # Discovery
runbooks operate --profile $AWS_OPERATIONS_PROFILE   # Operations
```

### Advanced Configuration
```bash
# Custom configuration directory
export RUNBOOKS_CONFIG_DIR="/path/to/config"

# Performance tuning
export RUNBOOKS_PARALLEL_WORKERS=10
export RUNBOOKS_TIMEOUT=300
```

## 🛡️ Security & Compliance

| Framework | Status | Coverage |
|-----------|--------|----------|
| **AWS Well-Architected** | ✅ Full | 5 pillars |
| **SOC2** | ✅ Compliant | Type II ready |
| **PCI-DSS** | ✅ Validated | Level 1 |
| **HIPAA** | ✅ Ready | Healthcare compliant |
| **ISO 27001** | ✅ Aligned | Security management |

## 🚦 Roadmap

| Version | Timeline | Key Features |
|---------|----------|--------------|
| **v1.1.4** | **Current** | ✅ **Enterprise Production** - ProfileManager + Enhanced exports |
| **v1.2** | Q1 2026 | Enhanced enterprise features and expanded service coverage |
| **v1.3** | Q2 2026 | Enhanced AI orchestration with universal compatibility |
| **v1.5** | Q3 2026 | Self-healing infrastructure across any AWS setup |
| **v2.0** | Q4 2026 | Multi-cloud support (Azure, GCP) |

## 🆘 Support Options

### Community Support (Free)
- 🐛 **[GitHub Issues](https://github.com/1xOps/CloudOps-Runbooks/issues)** - Bug reports & feature requests
- 💬 **[GitHub Discussions](https://github.com/1xOps/CloudOps-Runbooks/discussions)** - Community Q&A

### Enterprise Support
- 🏢 **Professional Services** - Custom deployment assistance
- 🎓 **Training Programs** - Team enablement workshops
- 🛠️ **Custom Development** - Tailored collector modules
- 📧 **Email**: [info@oceansoft.io](mailto:info@oceansoft.io)

## 📄 License

Apache License 2.0 - See [LICENSE](LICENSE) file for details.

---

**🏗️ Built with ❤️ by the xOps team at OceanSoft**

*Transform your AWS operations from reactive to proactive with enterprise-grade automation* 🚀

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "runbooks",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<3.14,>=3.11",
    "maintainer_email": null,
    "keywords": "runbooks, automation, DevOps, SRE, CloudOps, AWS, cloud-foundations, FinOps, enterprise, cost-optimization, security-compliance, multi-account, business-intelligence",
    "author": null,
    "author_email": "Maintainers <nnthanh101@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/fc/c2/7e6cdeb086e830ba165a0e872d324a69a5a5f687437417367d6e09873858/runbooks-1.1.10.tar.gz",
    "platform": null,
    "description": "# \ud83d\ude80 CloudOps Runbooks - Enterprise AWS Automation\n\n[![PyPI](https://img.shields.io/pypi/v/runbooks)](https://pypi.org/project/runbooks/)\n[![Python](https://img.shields.io/pypi/pyversions/runbooks)](https://pypi.org/project/runbooks/)\n[![License](https://img.shields.io/pypi/l/runbooks)](https://opensource.org/licenses/Apache-2.0)\n[![Documentation](https://img.shields.io/badge/docs-latest-brightgreen)](https://cloudops.oceansoft.io/runbooks/)\n[![Downloads](https://img.shields.io/pypi/dm/runbooks)](https://pypi.org/project/runbooks/)\n\n> **Enterprise-Grade Production-Ready AWS automation toolkit for DevOps and SRE teams managing Multi-Account Hybrid-Cloud environments at Scale** \ud83c\udfe2\u26a1\n\n**Quick Value**: Discover, analyze, and optimize AWS resources across multi-account AWS environments with production-validated automation patterns.\n\n---\n\n## Runbooks FinOps & AWS MCP Servers\n\n> The hybrid approach (Runbooks FinOps & AWS MCPs) leverages the strengths of both solutions: AWS MCPs for real-time accuracy data access and Runbooks FinOps for business intelligence and visualization, ensuring optimal cost optimization results for your enterprise environment.\n\n---\n\n## \ud83c\udfc6 **5-Minute Manager Success Path**\n\n### **Step 1: Installation** (30 seconds)\n```bash\npip install runbooks\nrunbooks --version\n```\n\n### **Step 2: Cost Discovery** (3 minutes)\n```bash\n# Replace with your billing profile\nexport AWS_BILLING_PROFILE=\"your-billing-readonly-profile\"\nrunbooks finops --dry-run --profile $AWS_BILLING_PROFILE\n\n# Expected output: Cost optimization opportunities across multiple categories\n```\n\n### **Step 3: Executive Reports** (90 seconds)\n```bash\nrunbooks finops --export pdf --report-name executive-summary\nrunbooks finops --export csv --detailed-analysis\n```\n\n## \ud83c\udfaf Why CloudOps Runbooks?\n\n| Feature | Benefit | Status |\n|---------|---------|--------|\n| \ud83e\udd16 **AI-Agents Orchestration** | AI-Agents FAANG SDLC coordination | \u2705 Production Ready |\n| \u26a1 **Blazing Performance** | Sub-second CLI responses | \u2705 0.11s execution |\n| \ud83d\udcb0 **Cost Analysis** | Multi-account cost monitoring | \u2705 Real-time analysis |\n| \ud83d\udd12 **Enterprise Security** | Zero-trust, compliance ready | \u2705 SOC2, PCI-DSS, HIPAA |\n| \ud83c\udfd7\ufe0f **Multi-Account Ready** | Universal AWS integration | \u2705 200+ accounts supported |\n| \ud83d\udcca **Rich Reporting** | Executive + technical dashboards | \u2705 15+ output formats |\n\n## \ud83d\udcb0 **Strategic Value Framework**\n\n### **Business Impact Matrix**\n```bash\n# Enterprise cost optimization suite\npip install runbooks\n\n# Business scenario analysis\nrunbooks finops --scenario workspaces --dry-run\nrunbooks finops --scenario nat-gateway --dry-run\nrunbooks finops --scenario elastic-ip --dry-run\nrunbooks finops --scenario rds-snapshots --dry-run\nrunbooks finops --scenario ebs-volumes --dry-run\n\n# Strategic analysis modes\nrunbooks finops --profile $AWS_BILLING_PROFILE            # Cost visibility\nrunbooks finops --trend --profile $AWS_BILLING_PROFILE    # Trend analysis\nrunbooks finops --audit --profile $AWS_BILLING_PROFILE    # Audit compliance\n```\n\n### **Executive-Ready Deliverables**\n| Scenario | Time to Value | Deliverable |\n|----------|---------------|-------------|\n| \ud83c\udfe2 **WorkSpaces Optimization** | 2 minutes | Executive PDF report |\n| \ud83c\udf10 **Network Cost Reduction** | 3 minutes | Cost analysis dashboard |\n| \ud83d\udcca **Storage Efficiency** | 2 minutes | Optimization roadmap |\n| \ud83c\udfaf **Complete Cost Audit** | 5 minutes | Comprehensive analysis |\n\n## \ud83d\udce6 Installation & Quick Start\n\n### Production Installation\n```bash\npip install runbooks\n\n# Verify installation\nrunbooks --help\nrunbooks inventory collect --help\n```\n\n### Configuration\n```bash\n# Set up your AWS profiles\nexport AWS_BILLING_PROFILE=\"your-billing-readonly-profile\"\nexport AWS_MANAGEMENT_PROFILE=\"your-management-readonly-profile\"\nexport AWS_OPERATIONS_PROFILE=\"your-operations-readonly-profile\"\n\n# Test single account access\nrunbooks inventory collect --profile $AWS_OPERATIONS_PROFILE --regions us-east-1\n```\n\n## \ud83e\uddf0 Core Modules\n\n| Module | Purpose | Key Commands | Business Value |\n|--------|---------|--------------|----------------|\n| \ud83d\udcca **Inventory** | Multi-account resource discovery | `runbooks inventory collect` | Complete visibility across 50+ services |\n| \ud83d\udcb0 **FinOps** | Multi-account cost analysis | `runbooks finops` | Real-time cost optimization |\n| \ud83d\udd12 **Security** | Compliance & baseline testing | `runbooks security assess` | 15+ security checks, 4 languages |\n| \ud83c\udfdb\ufe0f **CFAT** | Cloud Foundations Assessment | `runbooks cfat assess` | Executive-ready compliance reports |\n| \u2699\ufe0f **Operate** | Resource lifecycle management | `runbooks operate ec2 start` | Safe resource operations |\n| \ud83d\udd17 **VPC** | Network analysis & optimization | `runbooks vpc analyze` | Network cost optimization |\n| \ud83c\udfe2 **Organizations** [PLANNED] | OU structure management | Coming in v1.2 | Landing Zone automation |\n| \ud83d\udee0\ufe0f **Remediation** [PLANNED] | Automated security fixes | Coming in v1.2 | 50+ security playbooks |\n\n## \u26a1 Essential Commands Reference\n\n### \ud83d\udd0d Discovery & Inventory\n```bash\n# Multi-service resource discovery\nrunbooks inventory collect -r ec2,s3,rds --profile production\n\n# Cross-account organization scan\nrunbooks scan --all-accounts --include-cost-analysis\n\n# Specialized discovery operations\nrunbooks inventory collect -r lambda --include-code-analysis\n```\n\n### \ud83d\udcb0 Cost Management\n```bash\n# Interactive cost dashboard\nrunbooks finops --profile your-billing-profile\n\n# Cost optimization analysis\nrunbooks finops --optimize --target-savings 30\n\n# Multi-account cost aggregation\nrunbooks finops --all-accounts --breakdown-by service,account,region\n```\n\n### \ud83d\udd12 Security & Compliance\n```bash\n# Security baseline assessment\nrunbooks security assess --profile production --language EN\n\n# Multi-framework compliance check\nrunbooks cfat assess --compliance-framework \"AWS Well-Architected\"\n\n# Specialized security operations\nrunbooks security check root_mfa --profile management\n```\n\n### \u2699\ufe0f Resource Operations\n```bash\n# Safe EC2 operations (dry-run by default)\nrunbooks operate ec2 stop --instance-ids i-1234567890abcdef0 --dry-run\n\n# S3 security hardening\nrunbooks operate s3 set-public-access-block --account-id 123456789012\n\n# CloudFormation operations\nrunbooks operate cloudformation move-stack-instances \\\n  --source-stackset old-baseline --target-stackset new-baseline --dry-run\n```\n\n### \ud83c\udfa8 CLI Parameter Flexibility (v1.1.10+)\n\n**Enhanced UX**: All commands now support flexible format specification with **short flag support**\n\n#### Triple Alias Pattern\nChoose your preferred parameter style - all forms work identically:\n\n| Style | Example | Use Case |\n|-------|---------|----------|\n| **Short** \u2728 | `-f json` | Interactive CLI (save keystrokes) |\n| **Standard** | `--format json` | Scripts & automation |\n| **Legacy** | `--export-format json` | Backward compatibility |\n\n#### Examples - All Three Forms Work\n\n**Organization Visualization**:\n```bash\n# All three commands produce identical output\nrunbooks inventory draw-org -f graphviz --profile $MANAGEMENT_PROFILE\nrunbooks inventory draw-org --format graphviz --profile $MANAGEMENT_PROFILE\nrunbooks inventory draw-org --export-format graphviz --profile $MANAGEMENT_PROFILE\n```\n\n**Cost Analysis Export**:\n```bash\n# Choose your preferred style\nrunbooks finops analyze -f csv --profile $BILLING_PROFILE\nrunbooks finops analyze --format csv --profile $BILLING_PROFILE\nrunbooks finops analyze --export-format csv --profile $BILLING_PROFILE\n```\n\n**Account Inventory**:\n```bash\n# Short form for interactive use (NEW in v1.1.10)\nrunbooks inventory list-org-accounts -f json --output accounts.json\n\n# Standard form for scripts\nrunbooks inventory list-org-accounts --format csv --output accounts.csv\n\n# Legacy form (fully supported)\nrunbooks inventory list-org-accounts --export-format markdown --output accounts.md\n```\n\n#### Supported Commands (13 Total)\n\n| Module | Command | Formats | v1.1.10 |\n|--------|---------|---------|---------|\n| Inventory | `draw-org` | graphviz, mermaid, diagrams | \u2705 |\n| Inventory | `list-org-accounts` | json, csv, markdown, table | \u2705 |\n| Inventory | `list-org-users` | json, csv, markdown, table | \u2705 |\n| Inventory | `find-lz-versions` | json, csv, markdown, table | \u2705 |\n| Inventory | `check-landingzone` | json, markdown, table | \u2705 |\n| Inventory | `check-controltower` | json, markdown, table | \u2705 |\n| FinOps | `infrastructure analyze` | json, csv, markdown | \u2705 |\n| FinOps | `elastic-ip` | json, csv, markdown | \u2705 |\n| FinOps | `ebs` | json, csv, markdown | \u2705 |\n| FinOps | `vpc-endpoint` | json, csv, markdown | \u2705 |\n| FinOps | `nat-gateway` | json, csv, markdown | \u2705 |\n| FinOps | `load-balancer` | json, csv, markdown | \u2705 |\n\n#### Migration Guide\n\n**Zero Breaking Changes**: All existing scripts continue working without modification\n\n**Adoption Path**:\n- \u2705 **Now**: All parameter forms work (choose preferred style)\n- \ud83d\udca1 **Recommended**: Adopt `-f` for interactive CLI usage (faster typing)\n- \ud83d\udcdd **Scripts**: Update at your convenience (no urgency)\n- \ud83d\udd04 **Future**: v1.2.0 will show deprecation warnings for legacy parameters\n\n## \ud83c\udfd7\ufe0f Architecture Highlights\n\n### Modern Stack\n- **\ud83d\udc0d Python 3.11+**: Modern async capabilities\n- **\u26a1 UV + Ruff**: 10x faster dependency resolution & linting\n- **\ud83c\udfa8 Rich CLI**: Beautiful terminal interfaces\n- **\ud83d\udcca Pydantic V2**: Type-safe data models\n- **\ud83d\udd17 boto3**: Native AWS SDK integration\n- **\ud83e\udd16 MCP Servers**: Real-time AWS API access ([MCP Specification](https://modelcontextprotocol.io/))\n\n### Enterprise Features\n- **\ud83d\udd10 Multi-Profile AWS**: Seamless account switching\n- **\ud83c\udf10 Multi-Language Reports**: EN/JP/KR/VN support\n- **\ud83d\udcc8 DORA Metrics**: DevOps performance tracking\n- **\ud83d\udea8 Safety Controls**: Dry-run defaults, approval workflows\n- **\ud83d\udcca Executive Dashboards**: Business-ready reporting\n\n## \ud83d\udcda Documentation\n\n### Quick Links\n- **\ud83c\udfe0 [Homepage](https://cloudops.oceansoft.io)** - Official project website\n- **\ud83d\udcd6 [Documentation](https://cloudops.oceansoft.io/runbooks/)** - Complete guides\n- **\ud83d\udc1b [Issues](https://github.com/1xOps/CloudOps-Runbooks/issues)** - Bug reports & features\n- **\ud83d\udcac [Discussions](https://github.com/1xOps/CloudOps-Runbooks/discussions)** - Community support\n\n### Enterprise Module Documentation\n\n| Module | Documentation Hub | Key Business Value | Technical Implementation |\n|--------|-------------------|-------------------|--------------------------|\n| \ud83d\udcb0 **FinOps** | [\ud83d\udcca Module Hub](docs/modules/finops/) | 20-40% cost optimization | [Code](src/runbooks/finops/) |\n| \ud83d\udd12 **Security** | [\ud83d\udee1\ufe0f Module Hub](docs/modules/security/) | 15+ security checks, 4 languages | [Code](src/runbooks/security/) |\n| \ud83d\udcca **Inventory** | [\ud83d\udd0d Module Hub](docs/modules/inventory/) | 50+ AWS services discovery | [Code](src/runbooks/inventory/) |\n| \u2699\ufe0f **Operations** | [\ud83d\udd27 Module Hub](docs/modules/operate/) | Resource lifecycle management | [Code](src/runbooks/operate/) |\n\n## \ud83d\udd27 Configuration\n\n### AWS Profiles Setup\n```bash\n# Environment variables for enterprise setup\nexport AWS_BILLING_PROFILE=\"your-billing-readonly-profile\"\nexport AWS_MANAGEMENT_PROFILE=\"your-management-readonly-profile\"\nexport AWS_OPERATIONS_PROFILE=\"your-operations-readonly-profile\"\n\n# Universal profile usage patterns\nrunbooks finops --profile $AWS_BILLING_PROFILE      # Cost analysis\nrunbooks inventory collect --profile $AWS_MANAGEMENT_PROFILE  # Discovery\nrunbooks operate --profile $AWS_OPERATIONS_PROFILE   # Operations\n```\n\n### Advanced Configuration\n```bash\n# Custom configuration directory\nexport RUNBOOKS_CONFIG_DIR=\"/path/to/config\"\n\n# Performance tuning\nexport RUNBOOKS_PARALLEL_WORKERS=10\nexport RUNBOOKS_TIMEOUT=300\n```\n\n## \ud83d\udee1\ufe0f Security & Compliance\n\n| Framework | Status | Coverage |\n|-----------|--------|----------|\n| **AWS Well-Architected** | \u2705 Full | 5 pillars |\n| **SOC2** | \u2705 Compliant | Type II ready |\n| **PCI-DSS** | \u2705 Validated | Level 1 |\n| **HIPAA** | \u2705 Ready | Healthcare compliant |\n| **ISO 27001** | \u2705 Aligned | Security management |\n\n## \ud83d\udea6 Roadmap\n\n| Version | Timeline | Key Features |\n|---------|----------|--------------|\n| **v1.1.4** | **Current** | \u2705 **Enterprise Production** - ProfileManager + Enhanced exports |\n| **v1.2** | Q1 2026 | Enhanced enterprise features and expanded service coverage |\n| **v1.3** | Q2 2026 | Enhanced AI orchestration with universal compatibility |\n| **v1.5** | Q3 2026 | Self-healing infrastructure across any AWS setup |\n| **v2.0** | Q4 2026 | Multi-cloud support (Azure, GCP) |\n\n## \ud83c\udd98 Support Options\n\n### Community Support (Free)\n- \ud83d\udc1b **[GitHub Issues](https://github.com/1xOps/CloudOps-Runbooks/issues)** - Bug reports & feature requests\n- \ud83d\udcac **[GitHub Discussions](https://github.com/1xOps/CloudOps-Runbooks/discussions)** - Community Q&A\n\n### Enterprise Support\n- \ud83c\udfe2 **Professional Services** - Custom deployment assistance\n- \ud83c\udf93 **Training Programs** - Team enablement workshops\n- \ud83d\udee0\ufe0f **Custom Development** - Tailored collector modules\n- \ud83d\udce7 **Email**: [info@oceansoft.io](mailto:info@oceansoft.io)\n\n## \ud83d\udcc4 License\n\nApache License 2.0 - See [LICENSE](LICENSE) file for details.\n\n---\n\n**\ud83c\udfd7\ufe0f Built with \u2764\ufe0f by the xOps team at OceanSoft**\n\n*Transform your AWS operations from reactive to proactive with enterprise-grade automation* \ud83d\ude80\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "CloudOps Automation Toolkit with Enhanced Cloud Foundations Assessment for DevOps and SRE teams.",
    "version": "1.1.10",
    "project_urls": {
        "Changelog": "https://github.com/1xOps/CloudOps-Runbooks/blob/main/CHANGELOG.md",
        "Documentation": "https://cloudops.oceansoft.io/runbooks/",
        "Homepage": "https://cloudops.oceansoft.io",
        "Issues": "https://github.com/1xOps/CloudOps-Runbooks/issues",
        "Repository": "https://github.com/1xOps/CloudOps-Runbooks"
    },
    "split_keywords": [
        "runbooks",
        " automation",
        " devops",
        " sre",
        " cloudops",
        " aws",
        " cloud-foundations",
        " finops",
        " enterprise",
        " cost-optimization",
        " security-compliance",
        " multi-account",
        " business-intelligence"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "05b1853c653d67619fa4c2f70cfaf234488bd23692f62af7f12dbbb7cad32018",
                "md5": "7664c52735b86d2670dc5d992643f419",
                "sha256": "bdcc5e78074f95ba68ec0e92d7df424df989b308c1a3c4b4f185f4bbf44a93f9"
            },
            "downloads": -1,
            "filename": "runbooks-1.1.10-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "7664c52735b86d2670dc5d992643f419",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<3.14,>=3.11",
            "size": 4578364,
            "upload_time": "2025-10-14T01:01:04",
            "upload_time_iso_8601": "2025-10-14T01:01:04.505182Z",
            "url": "https://files.pythonhosted.org/packages/05/b1/853c653d67619fa4c2f70cfaf234488bd23692f62af7f12dbbb7cad32018/runbooks-1.1.10-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "fcc27e6cdeb086e830ba165a0e872d324a69a5a5f687437417367d6e09873858",
                "md5": "67ca1f7287575aa1ffb2ad627a1e881b",
                "sha256": "f459e587858704d062ce28ff05f6fd1d9fc16a1f4ea9b4af556c28e637c3cb9e"
            },
            "downloads": -1,
            "filename": "runbooks-1.1.10.tar.gz",
            "has_sig": false,
            "md5_digest": "67ca1f7287575aa1ffb2ad627a1e881b",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<3.14,>=3.11",
            "size": 4279445,
            "upload_time": "2025-10-14T01:01:08",
            "upload_time_iso_8601": "2025-10-14T01:01:08.348028Z",
            "url": "https://files.pythonhosted.org/packages/fc/c2/7e6cdeb086e830ba165a0e872d324a69a5a5f687437417367d6e09873858/runbooks-1.1.10.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-10-14 01:01:08",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "1xOps",
    "github_project": "CloudOps-Runbooks",
    "github_not_found": true,
    "lcname": "runbooks"
}