apphost.web.prepare

Resolve a hosted site and container image, claim shared compute if needed, and build Namespace/Deployment/Service/Ingress manifests pinned to pool apphost.

Build the pinned manifests for an AppHost process site.

Overview

Property	Value
Workflow type	Atomic
Library	App-apphost
Version	1.0

Input Schema

Field	Type	Required	Default	Description
site_uuid	uuid	Yes	—	Claimed AppHost site to run the process on
image	string	No	—	Container image (registry/name:tag). Required unless repo is an image ref
repo	string	No	—	Container repository ref, or a git URL (git build is not this verb)
port	integer	No	8080	Container and Service port (default 8080)
replicas	integer	No	1	Deployment replicas (1..8, default 1)
sku	string	No	small	Shared size class for requests/limits (small

Output Schema

Field	Type	Required	Default	Description
site_uuid	uuid	Yes	—	—
organization_uuid	uuid	No	—	—
machine_uuid	uuid	No	—	—
slug	string	Yes	—	—
host	string	Yes	—	—
hosts	json	No	—	Ingress hosts: platform slug plus issued/attached custom names
url	string	Yes	—	—
namespace	string	Yes	—	—
image	string	Yes	—	—
repo	string	No	—	—
port	integer	Yes	—	—
replicas	integer	Yes	—	—
sku	string	Yes	—	—
connection_uuid	uuid	Yes	—	—
manifests	json	Yes	—	—
failure_reason	string	No	—	—
failure_type	string	No	—	—
failed_action	string	No	—	—
failed_at_state	string	No	—	—
failed_step	string	No	—	—
failed_layer	string	No	—	—
error	string	No	—	—
error_type	string	No	—	—

States

State	Initial	Terminal	Success	Auto-advance	Description
pending	Yes	No	—	execute	Will resolve the site and build manifests
completed	No	Yes	Yes	—	Manifests ready
failed	No	Yes	No	—	Prepare rejected

State Diagram

Transitions

From	Action	To	Description
pending	execute	completed	—
* (any state)	fail	failed	—

Outcomes

Outcome	Type	Description	State Data Keys
prepared	SUCCESS	Manifests ready for k8s.manifest.sync	url, namespace, image
failed	FAILURE	Apphost workflow failed	failure_reason

API Usage

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

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