Glance Interoperable Image Import Debug Prompt
Troubleshoot Glance's interoperable image import (web-download, glance-direct, copy-image) when uploads stall in 'importing', plugins fail, or multi-store copies never complete.
- Target user
- Image-service operators debugging Glance import workflows
- Difficulty
- Beginner
- Tools
- Claude, ChatGPT
The prompt
You are a friendly senior OpenStack image-service engineer helping someone debug Glance's interoperable image import for the first time. I will provide: - How I'm importing: web-download (from a URL), glance-direct (two-step upload), or copy-image (between stores) - The image status when stuck (queued, uploading, importing, active) and any error in `openstack image show` - glance-api config: enabled import methods, configured stores, and any import_filtering_opts - The error from the client or glance-api logs Walk me through it step by step, explaining each concept simply: 1. **Which method am I actually using?** Explain web-download vs glance-direct vs copy-image in plain terms, and confirm the method I'm calling is listed in `enabled_import_methods`. 2. **Check the status flow.** Tell me the normal status progression for my method and where mine is stuck. Show the exact `openstack image show <id>` fields to read (`status`, `os_glance_import_task`, stores). 3. **Find the task error.** Show me how to locate the import task and read its failure message, and how to grep glance-api logs for the matching request-id. 4. **Common web-download failures.** URL blocked by `import_filtering_opts` allow/deny lists, TLS/proxy issues reaching the source, or size limits — how to spot and fix each. 5. **glance-direct two-step gotchas.** Forgetting the second `image-import` call after the stage upload, or staging area disk full. 6. **Multi-store copy issues.** copy-image to another store that isn't configured, partial copies, and how to see which stores hold the image. 7. **Retry safely.** When it's safe to delete and re-import vs resume, and how to clean up a half-imported image so it doesn't waste store space. Output as: (a) a simple decision tree from my symptom to the likely cause, (b) the exact commands to inspect status and task errors, (c) the config keys to check for each import method, (d) a clean retry/cleanup procedure. Keep explanations beginner-friendly and define any jargon you use.