Repository navigation
Add cache disks page - #2655
Add cache disks page#2655kcmartin wants to merge 3 commits into
Conversation
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
| | | Root file system | Cache drive | Fly Volume | | ||
| | --- | --- | --- | --- | | ||
| | Survives stop and restart | No | Usually, not guaranteed | Yes | | ||
| | Survives a move to another host | No | No | Volumes don't move between hosts | |
There was a problem hiding this comment.
We do migrate volumes between hosts as part of https://docs.fly.io/reference/machine-migration
"migration" might be a better word than move?
There was a problem hiding this comment.
Changed to "Machine migration" with a link, and fixed the volume cell, in a045b42.
| | Machine update that doesn't change the cache drive's size | Usually kept | | ||
| | Cache drive `path` changed | Kept | | ||
| | Cache drive `size_mb` changed | Wiped. The drive is destroyed and a new empty one is created | | ||
| | Machine moved or recovered on another host | Wiped. A new empty drive is created on the new host | |
There was a problem hiding this comment.
Same here - call this migration too?
There was a problem hiding this comment.
Changed to "Machine migration" with a link, and fixed the volume cell, in a045b42.
| }' | ||
| ``` | ||
|
|
||
| This creates a Machine with a 10 GiB cache drive mounted at `/cache`. |
There was a problem hiding this comment.
Don't want excessive allocations through people copying the example. Let's give a small size - 1 GiB?
a870370 to
a045b42
Compare
New page for Machine cache disks: lifecycle, performance, limits, and setup with fly.toml, flyctl (flyctl#5469), and the Machines API.
Not ready to merge: pricing and the rootfs performance comparison are still TODOs. Tracking: https://github.com/superfly/docs-tracking/issues/394