deploys

Deploy now: the branch’s newest commit, or { commit_sha } again; an Ingot repo, its newest changeset or { at }

Changed on

Queued, and built once the computer runs and no other build runs there (one at a time per computer). A newer deploy of the same project supersedes one still queued. A build stops after 30 minutes; a new release that does not answer on its port within 60 seconds is rolled back to the previous one.

post/api/computers/{id}/deploy-projects/{projectId}/deployments

Request

  • Base URL
    https://www.orgo.ai
  • Auth
    HTTP bearer

Path parameters

idstring required

Computer id.

projectIdstring uuid required

Deploy project id.

Request body

commit_shastring

A repository’s.

atstring

An Ingot repo’s: any changeset of it, an older one too. Default: the project’s at, else the newest on main.

Response

Queued.

idstring uuid required
project_idstring uuid required
trigger'push' | 'manual' | 'rollback' | 'redeploy' required
state'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled' | 'superseded' required
phase'preparing' | 'cloning' | 'detecting' | 'installing' | 'building' | 'starting' | 'health_check' | 'live' | 'null' nullable
branchstring required
source_versionstring nullable

An Ingot repo’s: the changeset it builds, once known (the one asked for, else the one the runner found newest on main). A rollback: the changeset of the release it went back to.

commit_shastring nullable
commit_messagestring nullable
commit_authorstring nullable
frameworkstring nullable
error_codestring nullable

Failed: build_timeout, runner_lost, computer_not_running, github_token, clone_failed, detect_failed, install_failed, build_failed, docker_unavailable, start_failed, health_check_failed, release_gone, apply_failed, ingot_missing.

errorstring nullable
rollback_ofstring uuid nullable
currentboolean

This deployment is the project’s live one. After a rollback it is the rollback, not the deployment it went back to.

release_liveboolean

Its release is the one live now, through this deployment or another of the same release (a rollback to it, or the one this rollback went back to). Nothing to roll back to or build again.

can_rollbackboolean

Its release is still on the computer and is not the one live now.

created_atstring date-time
started_atstring date-time nullable
finished_atstring date-time nullable

Changes