apphost.web.deploy

Launch an app on a claimed AppHost site from a container image (or registry repo). No customer connection. Pins the Deployment to the shared apphost pool and serves https://<slug>.app.orkestia.dev.

Launch a process on a claimed AppHost site from a container image.

Overview

Property	Value
Workflow type	Dag
Library	App-apphost
Version	1.0

Input Schema

Field	Type	Required	Default	Description
site_uuid	uuid	Yes	—	Claimed AppHost site (the project)
image	string	No	—	Container image registry/name:tag
repo	string	No	—	Container repository ref (same as image). Git URLs are rejected
port	integer	No	8080	Container listen port (default 8080)
replicas	integer	No	1	Replicas (1..8, default 1)
sku	string	No	small	Shared size class small

Output Schema

Field	Type	Required	Default	Description
site_uuid	uuid	No	—	—
image	string	No	—	—
repo	string	No	—	—
port	integer	No	—	—
replicas	integer	No	—	—
sku	string	No	—	—
plan	json	No	—	—
sync	json	No	—	—
ack	json	No	—	—
failure_reason	string	No	—	Engine-stamped failure reason
failure_type	string	No	—	Stable failure classification
failed_action	string	No	—	Action that failed
failed_at_state	string	No	—	State when the workflow failed
failed_step	json	No	—	Failed DAG step envelope
failed_layer	json	No	—	Failed DAG layer envelope
error	string	No	—	Engine-stamped exception message
error_type	string	No	—	Engine-stamped exception class name
compensation_trigger	json	No	—	—
comp_queue	json	No	—	—
comp_current_layer	json	No	—	—
comp_retry_count	json	No	—	—

DAG Layers

#	Layer	Steps	Compensation
1	prepare	apphost.web.prepare	apphost.web.ack
2	apply	k8s.manifest.sync	—

Execution Flow

Compensation

When any layer fails, its compensation steps run in reverse order to roll back the work completed so far.

Sub-workflows

Sub-workflow	Step name
apphost.web.prepare	plan
k8s.manifest.sync	sync
apphost.web.ack	ack

Outcomes

Outcome	Type	Description	State Data Keys
deployed	SUCCESS	Process applied on the shared AppHost pool	plan, sync
failed	FAILURE	Apphost workflow failed	failure_reason

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "apphost.web.deploy",
  "initial_data": {
    "site_uuid": "value"
  }
}