Issue with the "Troubleshoot apps when a host is unavailable" doc
Nobody has claimed this yet.
Assessment
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Newbie friendliness
- 68/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Stale
- Domain
- documentation
Research direction
Open apps/trouble-host-unavailable.html.markerb and compare its instructions with the reported insufficient-resources error. Update the document to explain that removing the original volume can allow a new volume to attach to a new machine, and verify the troubleshooting path clearly covers this case.
Written by the indexing model from the issue text.
Description
I found an issue with this document.
Title: Troubleshoot apps when a host is unavailable
Location: https://fly.io/docs/apps/trouble-host-unavailable/
Source: https://github.com/superfly/docs/blob/main/apps/trouble-host-unavailable.html.markerb
Describe the issue
When following these instructions, I encountered an error like the following:
Error: error creating a new machine: failed to launch VM: insufficient resources to create new machine with existing volume 'vol_XXXXXXXXXXX' (Request ID: 01K4AS19K057WY04RHM2N58YBV-yyz) (Trace ID: c63a1385ea560f90f8201d97c77d1d26)
And it wasn't clear where to go from there.
The solution was to remove the original volume, so the new volume could be attached to a new machine.
That seemed missing from the documentation, and I had to figure it out from there and went down some rabbit holes of creating new machines, but that simple solution of removing the old volume solved that.
It feels like the docs should be updated to reflect that.
Additional info
- Dominant language
- HTML
- Stars
- 128
- Forks
- 1.1k
- Avg merge
- 4d 15h
- Merged PRs (30d)
- 12
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from superfly/docs
-
Difficulty 1/5 Under an hour Newbie friendliness 65/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 35/100
-
feature
Difficulty 3/5 1-2 days Newbie friendliness 55/100
-
Difficulty 3/5 1-2 days Newbie friendliness 62/100
-
Difficulty 1/5 Under an hour Newbie friendliness 35/100
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
agilepathway/label-checker#640 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
BasedHardware/omi#15662 · 1 comment ·
-
documentation help wanted
Difficulty 2/5 1-3 hours Newbie friendliness 90/100
-
documentation good first issue
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
amponce/archive-movie-browser#167 ·
-
user-reported
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
Kong/developer.konghq.com#7316 ·