Cloud Run Revision Rollout & Traffic-Split Failure Debug Prompt
Debug a Cloud Run deploy where the new revision won't go Ready, traffic won't shift, or a canary is serving errors — by reasoning from revision status, traffic config, and the readiness/health signals instead of redeploying blindly.
- Target user
- Engineers shipping services on Cloud Run
- Difficulty
- Intermediate
- Tools
- Claude, ChatGPT, Cursor
The prompt
You are a senior Cloud Run engineer who debugs failed rollouts from revision status and traffic config, not by spamming `gcloud run deploy`. I will provide: - The deploy command and output, plus `gcloud run services describe` and `gcloud run revisions list` - The failing revision's status conditions (Ready, Active, ContainerHealthy) and any "Revision failed" / "did not become ready" message - Traffic configuration: tags, percent splits, and whether `--no-traffic` or a tagged canary was used - Logs from Cloud Logging for the revision (startup, readiness probe, 4xx/5xx) and the configured CPU/memory, concurrency, min/max instances, startup probe, and timeout Your job: 1. **Read the revision status** — interpret the Ready/ContainerHealthy conditions to separate "container never started" from "started but failed readiness" from "deployed fine but no traffic." 2. **Trace the failure class** — startup crash, port mismatch (must listen on $PORT), missing secret/env, image pull/permission, startup-probe timeout, or OOM at boot. 3. **Fix traffic routing** — explain why the new revision isn't receiving traffic (pinned to old revision, `--no-traffic`, tag-only canary) and the exact `gcloud run services update-traffic` to shift or roll back. 4. **Check the gradual rollout** — if a canary percent is erroring, compare the canary revision's config/logs against the stable one to isolate the regression. 5. **Recommend safe rollback** — the one-command revert to the last-good revision while the fix is prepared. Output as: (a) root cause and failure class, (b) the offending config/log lines, (c) exact fix command, (d) immediate rollback command. Diagnose and recommend only — do not assume deploy access.
Run this prompt with AI
Test it, get an AI-improved version, or compare models — live in the Prompt Workspace. No copy-paste.
Related prompts
-
Cloud Run & Cloud Functions Cold-Start & Failure Debug Prompt
Debug Cloud Run / Cloud Functions cold starts, container startup failures, timeouts, and 5xx errors using revision config, concurrency, and logs — not blind redeploys.
-
Eventarc Trigger Routing Debug Prompt
Diagnose Eventarc triggers that never fire — events not reaching Cloud Run/Functions, permission gaps on the trigger service account, wrong event filters, and audit-log events that were never enabled.
-
GCP Cloud NAT & Egress Connectivity Debug Prompt
Debug failed outbound connectivity from private GCP instances — Cloud NAT port exhaustion, dropped egress, Private Google Access gaps, and route/firewall blocks — by reasoning from NAT metrics and config instead of assigning public IPs.
-
Cloud SQL Connectivity Triage Prompt
Diagnose why a client cannot connect to Cloud SQL — private IP routing, authorized networks, SSL/TLS, IAM database auth, and connector vs proxy issues — by walking the connection path instead of opening the instance to the internet.
More GCP with AI prompts & error guides
Browse every GCP with AI prompt and troubleshooting guide in one place.
Reading prompts? Get all 500 in one free PDF
500 battle-tested, copy-paste AI prompts engineered by a senior systems engineer — every one with fill-in placeholders and safety/back-out notes. Drop your email and it's yours.
- 500 prompts: Linux · Kubernetes · Terraform · OpenStack · GitLab · Docker · Monitoring · Incident Response
- Instant PDF download — yours free, forever
- Plus one practical AI-workflow email a week (no spam)
Single opt-in · unsubscribe anytime · no spam.