Versions, going live and rolling back
Every upload creates a new version. Versions are never overwritten, and any version that built can go live, newer or older.
Build stages#
After an upload, a version moves through these stages. Its row on the Deploy tab shows the current one.
| Stage | What the platform is doing |
|---|---|
| Queued | Waiting for a build machine. The row shows how many builds are ahead. |
| Building | Building the web page or the container image. |
| Scanning | Checking for secrets, personal data and scripts loaded from elsewhere. A container image is also scanned for vulnerabilities and secrets. |
| Reviewing | Collecting the scan results. |
| Awaiting confirmation | A check set to "asks first" found something. After reading the findings, you can publish anyway. |
| Succeeded | The version can go live. |
| Failed | The content was refused or the platform failed. See Troubleshoot failed deployments. |
Each check in a version's results says how it is handled: "blocks the deploy", "asks first" or "not run".
Go live#
An app's first version goes live on its own once it builds. For later versions, select Go live on the version's row on the Deploy tab. Visitors see the new version within a minute.
Before going live, open the version's preview address to check it. Every version keeps its own preview address, whichever version is live.
Roll back#
If a new version has a problem, find an earlier version in the list and select Roll back to this. It's the same action as going live: nothing is uploaded or rebuilt.
Internal calls move too
Other apps that call this app's internal address reach the live version. Going live or rolling back changes where those calls land.
Branches#
When an app has more than one branch, every action applies to the branch you are on. The upload button reads "Upload and go live on ‹branch›", and going live affects only that branch. Each branch has its own settings and secrets.
Before a version goes live on a branch, the platform compares the branch's variable and secret names and tells you about any that are missing.