Skip to content
SHC Docs

Flow: app install

Layer 11. Lifecycle. Layer page.

shc install posts /api/method/shc.stack.install and follows the operation. The deploy renders once, stores that render, and the node starts from the stored spec.

sequenceDiagram
participant CLI
participant Deploy
participant Store
participant Node
CLI->>Deploy: POST /api/method/shc.stack.install
Deploy->>Deploy: ExecuteCompose renders the compose once
Deploy->>Store: store the render before fabric, networks, replica projects
Deploy->>Store: store the spec
Node->>Store: materialise clusterfs
Node->>Node: start replicas from the stored spec

The command is ce modules/app/commands/install.go. Placement is --where and --prefer. The runtime flag accepts docker, podman, incus, or apple. Publish is --expose.

The deploy runs on the node the deployment row names (ce modules/app/install_dispatch.go). RunInstallWithObserver drives ExecuteCompose (ce modules/app/install_async.go). Where replica projects run, the render is stored before it names a node (ce modules/app/install_runner.go). See render once.

A refusal that leaves no manifest deletes the queued row (ce modules/app/service.go, cleanupRefusedInstall). --no-rollback is on the command.

--node and --rule are gone. ce core/selector/flags.go registers both as hidden flags and refuses either with X400242SELFLG, naming the --where to write instead.

Sources: ce modules/app/commands/install.go, modules/app/install_dispatch.go, modules/app/install_async.go, modules/app/install_runner.go, modules/app/service.go, core/selector/flags.go.