CLI reference / product / surface / add

stado product surface add

Invocation

stado product surface add [OPTIONS] --kind <kind> --repository <repository> <PRODUCT>

Purpose

Provision one private repository for an existing catalog product and record it as that product's surface of KIND, the way create provisions each repository; run it again to resume one that stopped

Required inputs and options

Input or optionContract
<PRODUCT>An existing catalog product
--catalog <catalog>Independent authoritative catalog path
--kind <kind>Surface kind: cli, desktop, web, service, ios or android
--repository <repository>The new repository, OWNER/NAME
--workspace <workspace>The workspace of canonical checkouts this operation reads and builds from; default WISENT_WORKSPACE, else ~/Documents/CodingProjects/Wisent
--planCheck with reads only and print what would be provisioned and recorded; creates nothing
--purpose <DEFECT>An open Oko defect this operation serves, named to Oko's admission (`oko admit build --purpose DEFECT`) before anything compiles, so a consent the operator limited to that defect admits it; repeat for each defect
--allow-createAuthorize the private repository creation
--jsonPrint the plan or the provisioning result as JSON

Output and state effect

It performs the operation described above and emits its operator result on standard output or standard error. Any state change is limited to the resources and records named by the purpose and options on this page.

Refusals

  • Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.