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 specThe 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.