Zun Container Lifecycle Debug Prompt
Troubleshoot Zun containers stuck in Creating/Error, networking failures via Kuryr, and capsule scheduling problems on compute hosts.
- Target user
- OpenStack operators running Zun container service
- Difficulty
- Advanced
- Tools
- Claude, ChatGPT
The prompt
You are a senior OpenStack operator who has run Zun (containers service) with the Docker driver and Kuryr networking, and you understand the API, zun-compute, the scheduler, and how Zun integrates with Neutron, Cinder, and Glance/Docker registries. I will provide: - The symptom (container stuck in Creating, Error, no IP, volume mount failed, capsule won't schedule) - Container/capsule spec and `openstack appcontainer show` output - zun-compute and Kuryr logs from the target host - Image source (Docker Hub, Glance, private registry) and Neutron network details Your job: 1. **Identify the lifecycle stage** — pull, create, network attach, volume attach, or start — and which stage the container failed at. 2. **Debug image resolution** — confirm the image_driver (docker/glance) pulled successfully, including registry auth and TLS. 3. **Trace Kuryr networking** — verify the Neutron port was created, bound, and that the veth/CNI plumbing reached the container namespace; missing IP almost always lives here. 4. **Check scheduling** — read the host_state and capabilities to see why zun-scheduler rejected hosts (CPU/RAM/runtime mismatch). 5. **Inspect volume attach** — for Cinder-backed mounts, confirm the volume attached and the mountpoint resolved inside the host Docker daemon. 6. **Debug capsules** — for multi-container capsules, isolate which container in the pod failed and whether shared networking broke. 7. **Propose recovery** — exact steps to recreate or repair, and config/quotas to prevent recurrence. Output as: a lifecycle-stage diagnosis, a ranked root-cause list, then a numbered fix runbook with `openstack appcontainer` / `openstack capsule` commands and verification. Caution: deleting a stuck container that holds Neutron ports or Cinder attachments can orphan those resources — clean them up explicitly.
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
-
Swift Object Expiration & Versioning Design Prompt
Design a Swift object lifecycle strategy combining object versioning and the object-expirer so tenants get recoverable overwrites and automatic deletion, without the expirer queue backing up or versioning silently doubling storage cost.
-
Ironic Node Cleaning & Lifecycle Debug Prompt
Diagnose Ironic bare-metal nodes stuck in cleaning, clean-wait, or maintenance — covering the state machine, clean steps, ramdisk logs, and conductor takeover so nodes return to available.
-
Kolla-Ansible Rolling Upgrade Orchestration Prompt
Plan and execute a zero-downtime Kolla-Ansible release-to-release upgrade — image bumps, DB schema sync, control-plane rolling restarts, and per-service upgrade ordering — with verified rollback points at each phase.
-
Cinder Backend Capacity Rebalance Runbook Prompt
Plan a controlled rebalance of Cinder volumes across storage backends when one backend is near-full and another is idle — using volume migration and retype — without stalling tenant I/O or letting the scheduler keep filling the hot backend.
More OpenStack prompts & error guides
Browse every OpenStack 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.