Statuses
Each vocabulary below is separate on purpose: a deployment moves through a lifecycle and ends, a service either is or is not serving, a domain is somewhere on the way to routing. They are never mixed, which is what lets an environment show a deployment Building while its service is still Healthy.
Deployment
| Status | Meaning |
|---|---|
| Queued | Accepted and waiting for a builder. |
| Building | Turning the commit into a container image. |
| Deploying | Kuppit is provisioning and promoting the new revision. |
| Live | Serving production traffic. Exactly one deployment of a service is Live. |
| Previous | Superseded by a newer deployment. Can be rolled back to if it went live and its image is kept. |
| Failed | Stopped before reaching production. Traffic was not moved. |
| Cancelling | Stopping. Whatever had already started is being wound down. |
| Cancelled | Stopped on request. It never took traffic. |
Phases on the deployment page
| Phase | Done when |
|---|---|
| Analyzing source | The repository is read and the build resolved. |
| Building image | The image exists. |
| Starting revision | Compute for the revision is provisioned. Shows Waiting for a resource while a referenced database is still being created. |
| Health check | The revision answers on PORT. |
| Going live | Production traffic has moved to the revision. |
Triggers
Git push · Pull request · Manual · Redeploy · Rollback. See Deployments.
Service health
| Health | Meaning |
|---|---|
| Healthy | Serving production traffic. |
| Starting | Reaching production for the first time. |
| Failed | Nothing has reached production. |
| Not deployed | Nothing has been deployed yet. |
| Deleting | Stopping traffic, destroying the workload and removing its history. |
A worker and a scheduled worker show the same health, with "serving" read as "running".
Scheduled worker run
| Status | Meaning |
|---|---|
| Pending | Waiting for the runtime to start it. |
| Running | The run is executing. |
| Succeeded | The run finished and exited cleanly. |
| Failed | The run exited with an error or ran out of time. |
| Cancelled | The run was stopped before it finished. |
Database
| Status | Meaning |
|---|---|
| Provisioning | Creating the database and its credentials. |
| Ready | Accepting connections from this environment's services. |
| Failed | Provisioning failed. Retry it or delete it. |
| Deleting | Destroying the database and removing its references. |
Custom domain
| Status | Meaning |
|---|---|
| Provisioning | Creating secure routing for this domain. |
| Needs ownership | Add the ownership TXT record. |
| Verifying | Confirming domain ownership. |
| Needs routing | Point the hostname to Kuppit using the displayed DNS target. |
| Securing | Issuing and deploying the TLS certificate. |
| Active | Serving traffic securely through Kuppit. |
| DNS issue | The domain DNS no longer points to Kuppit. |
| Failed | Certificate issuance failed. Kuppit keeps retrying. |
| Removing | Stopping traffic and removing the certificate. |
| Removed | This domain no longer routes through Kuppit. |
A generated hostname shows Provisioning until the service's first deployment is Live, then Active.
Preview readiness
Whether an environment has what its commit reads, on its panel and, for a preview, on the check:
| State | Meaning |
|---|---|
| Analysing | Some of what this commit reads has not been analysed yet. What is known is shown; nothing is called ready on half a story. |
| Ready | Everything this commit reads is configured here. |
| Needs attention | Something this commit reads is not configured here. The deploy proceeds. |
A box's header counts it — ⚠ 2 need attention — and a resource card says ⚠ 1 issue. Never "action required": a reference proves no requirement. See application changes.
Pull request check
The Kuppit Preview check on a pull request: Deploying… or Cancelling… while in progress; Deployed with the preview's URL, or Deployed · needs attention when something the pull request reads is not configured for the preview; Build failed or Deployment failed; Cancelled; or the neutral No preview with the reason. See no preview for a pull request.