kibo platform
Publish, inspect and admit backend-specific Platform artifacts. This page lists the usage, examples, and flags of kibo platform and its subcommands, generated from the kibo source code.
Every command on this page also takes the global flags --endpoint, --json, and --timeout. See CLI reference for kibo.
Subcommands:
kibo platform approve: Approve a Platform revision so it can be resolved and set as a defaultkibo platform get: Get one Platform revision and its canonical manifestkibo platform list: List registered Platform revisions and the current default of each PlatformKeykibo platform publish: Publish one verified Platform archive to ctrlkibo platform set-default: Point the PlatformKey of this revision at itkibo platform withdraw: Withdraw a Platform revision so new Launches stop resolving to it
kibo platform approve
Approve a Platform revision so it can be resolved and set as a default.
kibo platform approve <revision> [flags]| Flag | Default | Description |
|---|---|---|
--command-id <key> | idempotency key for this change; see kibo help command-ids |
kibo platform get
Get one Platform revision and its canonical manifest.
kibo platform get <revision> [flags]kibo platform list
Lists Platform revisions in the server's order and marks the revision each PlatformKey currently defaults to. The five PlatformKey filters are one filter: give all of them or none, because a partial key would silently match every Platform. The page token is bound to the filter it was issued under.
kibo platform list [flags]Also available as kibo platform ls.
| Flag | Default | Description |
|---|---|---|
--architecture <string> | PlatformKey architecture; requires the other four key filters | |
--backend <string> | PlatformKey backend; requires the other four key filters | |
--guest-protocol <uint32> | PlatformKey guest protocol; requires the other four key filters | |
--kernel-series <string> | PlatformKey kernel series; requires the other four key filters | |
--page-size <number> | maximum number of results on a page | |
--page-token <token> | token from the Next line of the previous page | |
-q, --quiet | print only the IDs of the resources in the result | |
--rootfs-contract <uint32> | PlatformKey rootfs contract; requires the other four key filters | |
--state <state> | only revisions in this state: registered, approved or withdrawn | |
--wide | show every field, including revisions and full digests |
kibo platform publish
Publish one verified Platform archive to ctrl.
kibo platform publish <archive> [flags]| Flag | Default | Description |
|---|---|---|
--command-id <key> | idempotency key for this change; see kibo help command-ids | |
--wait-timeout <duration> | 2h | maximum time to wait for durable background finalization; timing out does not abort it |
kibo platform set-default
Moves one PlatformKey's default to this revision. The PlatformKey comes from the revision itself, so it is not spelled out again. The first default of a PlatformKey has no pointer to expect: give neither expected value.
See kibo help command-ids for --command-id and the expected values.
kibo platform set-default <revision> [flags]| Flag | Default | Description |
|---|---|---|
--command-id <key> | idempotency key for this change; see kibo help command-ids | |
--expected-revision <revision> | revision the default is expected to point at; read from the server when omitted | |
--expected-version <version> | default pointer version the command is submitted against; read from the server when omitted |
kibo platform withdraw
Withdraws a Platform revision. Workspaces already bound to it keep running and are not migrated. A reason is required: a Platform that disappears without one leaves nobody able to say why.
kibo platform withdraw <revision> [flags]| Flag | Default | Description |
|---|---|---|
--command-id <key> | idempotency key for this change; see kibo help command-ids | |
--reason <text> | Required | text saying why this Platform revision is withdrawn; required |
kibo artifact
Plan, apply and review artifact store reclamation. This page lists the usage, examples, and flags of kibo artifact and its subcommands, generated from the kibo source code.
kibo template
Build, publish, admit and discover Workspace Templates. This page lists the usage, examples, and flags of kibo template and its subcommands, generated from the kibo source code.