All pages
Promote
A sandbox that turned out to matter becomes a service in one call, and keeps its address. Every link anybody shared goes on working, which is the reason this exists rather than a copy and a redirect.
pilot promote scratch
pilot service info scratchThe machine becomes the service's first replica. It gains replicas, releases and a health gate, and its sandbox lifecycle knobs are replaced by the service's. Nothing is rebuilt, nothing is copied, and the URL does not move.
When to reach for it
| Situation | Promote? |
|---|---|
| A sandbox whose link people have been sharing, now worth keeping | Yes. |
| An experiment that should become production without a new address | Yes. |
| A directory of source you want deployed | No. Deploy it. |
| A machine created from the stock template, with no image of its own | No. It has nothing to redeploy from. |
What it answers
| Answer | What it means |
|---|---|
| A service id, and the same URL |
Promoted. pilot service info confirms it.
|
bad_request about an image
| The sandbox was created from the template rather than from an image. Recreate it with an image and promote that. |
bad_request about replicas
| The machine mounts a volume, and a volume-backed service runs one replica (volumes). |