{"id":51358249,"url":"https://github.com/h-vance/cloud-operations-runbook","last_synced_at":"2026-07-02T21:08:27.161Z","repository":{"id":352137022,"uuid":"1214008762","full_name":"h-vance/cloud-operations-runbook","owner":"h-vance","description":"Production-grade cloud engineering and security runbooks for incident response, troubleshooting, and prevention.","archived":false,"fork":false,"pushed_at":"2026-05-02T20:56:42.000Z","size":42,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-03T06:22:23.212Z","etag":null,"topics":["cloud-engineering","incident-response","runbooks","security","troubleshooting"],"latest_commit_sha":null,"homepage":"","language":null,"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/h-vance.png","metadata":{"files":{"readme":"README.md","changelog":null,"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-04-18T02:27:53.000Z","updated_at":"2026-05-03T03:56:56.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/h-vance/cloud-operations-runbook","commit_stats":null,"previous_names":["dexmachina-eth/cloud-support-runbook","harrison-vc/cloud-operations-runbook","h-vance/cloud-operations-runbook"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/h-vance/cloud-operations-runbook","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h-vance%2Fcloud-operations-runbook","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h-vance%2Fcloud-operations-runbook/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h-vance%2Fcloud-operations-runbook/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h-vance%2Fcloud-operations-runbook/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/h-vance","download_url":"https://codeload.github.com/h-vance/cloud-operations-runbook/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/h-vance%2Fcloud-operations-runbook/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35062874,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-02T02:00:06.368Z","response_time":173,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["cloud-engineering","incident-response","runbooks","security","troubleshooting"],"created_at":"2026-07-02T21:08:26.256Z","updated_at":"2026-07-02T21:08:27.150Z","avatar_url":"https://github.com/h-vance.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Standard Operating Procedures (SOPs) \u0026 Runbooks\n\n\u003e **Standardized troubleshooting paths that reduce tribal knowledge and provide repeatable, evidence-driven incident resolution.**\n\n[![Markdown](https://www.shieldcn.dev/badge/Markdown-000000.svg?variant=default\u0026logo=Markdown\u0026logoColor=FFFFFF\u0026size=xs)](https://daringfireball.net/projects/markdown/)\u0026nbsp;[![Linux](https://www.shieldcn.dev/badge/Linux-222222.svg?variant=default\u0026logo=Linux\u0026logoColor=FCC624\u0026size=xs)](https://kernel.org)\n\n---\n\n## The Impact\n\nAuthored and maintained **15+ comprehensive technical SOPs** covering compute, networking, identity, and application fault domains in cloud environments.\n\n## The Value\n\nStandardized common support tasks, **reduced tribal knowledge**, and improved the efficiency of the broader support team by providing repeatable troubleshooting paths. Each runbook follows a consistent `Symptoms → Triage → Investigation → Root Cause → Resolution → Validation → Prevention` structure, ensuring that any engineer on the team can execute them regardless of prior exposure to the specific failure mode.\n\n---\n\n## Runbook Structure\n\nEvery runbook follows a standardized diagnostic template ([`TEMPLATE.md`](runbooks/TEMPLATE.md)):\n\n```text\nSymptoms        → What does the failure look like?\nInitial Triage  → Rapid, low-impact checks to isolate the fault domain\nInvestigation   → Step-by-step diagnostics with specific CLI commands\nRoot Cause      → The underlying technical failure mechanism\nResolution      → Clear steps to restore service integrity\nValidation      → How to confirm the fix is effective\nPrevention      → Proposed changes to eliminate the failure mode\n```\n\n---\n\n## Runbook Index\n\n### Compute\n\n| Runbook | Scenario |\n| ------- | -------- |\n| [Disk Space Exhaustion](runbooks/compute/disk-full.md) | Root partition full — logrotate misconfiguration and uncapped journald |\n| [High CPU Process](runbooks/compute/high-cpu-process.md) | Runaway process consuming CPU and degrading host performance |\n| [Service Not Running](runbooks/compute/service-not-running.md) | Critical service down — systemd unit failure and dependency chain |\n\n### Application\n\n| Runbook | Scenario |\n| ------- | -------- |\n| [API Timeout (Upstream Delay)](runbooks/application/api-timeout.md) | HTTP 504s caused by third-party provider degradation |\n| [Environment Misconfiguration](runbooks/application/env-misconfig.md) | Application failure due to missing or incorrect environment variables |\n| [ELB Health Check Failure](runbooks/application/elb-health-fail.md) | Load balancer marking healthy targets as unhealthy |\n| [K8s OOMKilled Pods](runbooks/application/k8s-oomkill.md) | Container memory limits exceeded causing pod evictions |\n| [RDS Failover](runbooks/application/rds-failover.md) | Database failover event and application reconnection |\n| [RDS Slow Queries](runbooks/application/rds-slow-queries.md) | Query performance degradation impacting application response times |\n| [S3 Policy Block](runbooks/application/s3-policy-block.md) | Access denied errors due to bucket policy or ACL conflicts |\n| [VPC Peering](runbooks/application/vpc-peering.md) | Cross-VPC connectivity failures and route table issues |\n| [IAM Permission Boundaries](runbooks/application/iam-boundaries.md) | Effective permissions reduced by permission boundary policies |\n\n### Identity \u0026 Access\n\n| Runbook | Scenario |\n| ------- | -------- |\n| [IAM Access Denied](runbooks/identity/iam-access-denied.md) | Permission errors — policy evaluation, SCP boundaries, and trust relationships |\n\n### Networking\n\n| Runbook | Scenario |\n| ------- | -------- |\n| [DNS Resolution Failure](runbooks/networking/dns-resolution-failure.md) | Service unreachable due to DNS misconfiguration or propagation delay |\n| [Security Group Block](runbooks/networking/security-group-block.md) | Traffic blocked by overly restrictive security group or NACL rules |\n\n---\n\n## Triage Flowchart\n\n```text\n[Start] → (External Check: Status 200?)\n           |── No  → [Network / WAF Issue]\n           |── Yes → (Local Check: Success?)\n                      |── No  → [Application / Process Issue]\n                      |── Yes → (Resource Check: Free space / CPU?)\n                                |── No  → [Compute / Disk Issue]\n                                |── Yes → [Upstream / Database Issue]\n```\n\n---\n\n## Related Repositories\n\n| Repository | Description |\n| ---------- | ----------- |\n| [**ops-diagnostics**](https://github.com/h-vance/ops-diagnostics) | Python \u0026 Bash diagnostic scripts for automated health verification, log analysis, and system profiling |\n| [**log-rotation-maintenance**](https://github.com/h-vance/log-rotation-maintenance) | Automated Bash scripts for log rotation, compression, and storage cleanup on Linux servers |\n\n---\n\nMaintained by a Technical Support Engineer focused on operational reliability and incident response.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fh-vance%2Fcloud-operations-runbook","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fh-vance%2Fcloud-operations-runbook","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fh-vance%2Fcloud-operations-runbook/lists"}