oz0 server dist pull
For: Operators and developers looking up a command.
Mirror a release into the dist directory the edge serves. URL is where a release's dist folder is served: manifest.json, manifest.json.sig and the files they name. --from takes it from a folder on this machine instead: an offline folder, whose dist/ holds the release, or a dist folder.
The release's signature must be by a key this server binary trusts, and every file must match its digest; the toolchain nodes install before their runtime comes along, each file checked against toolchain.json; the manifest goes in place last, so nodes see the new release whole or not at all. Then node upgrade --binary moves nodes to it.
It keeps to a release channel: the release's signed channel must be one the cluster follows (the cluster's, with the database; else the folder's), and on the same channel it never mirrors an older node version over a newer one. --switch-channel and --allow-older, each with --reason, are the explicit acts; with the database a switch moves the cluster's channel too, and both are recorded in the audit log.
Usage
oz0 server dist pull [URL] [flags]
Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--allow-older | bool | mirror a release older than the one the folder serves on the same channel; needs --reason | |
--channel | channel | the cluster's, with the database; else the dist folder's, or stable | the release channel to keep to: stable, preview or lts-<major>.<minor> |
--data-dir | string | ~/.local/share/orchestrator-zero | server data directory |
--db-file | file | a file (- for stdin) holding the PostgreSQL URL of the management database, such as postgres://oz0:PASSWORD@db:5432/oz0 (or set OZ0_DB); the URL can carry a password, so it never goes on the command line | |
--dev | bool | a dev server's data directory (--data-dir) instead of a cluster's database | |
--dist-dir | string | the dist folder next to this binary's folder | the edge's dist directory |
--from | folder | a folder on this machine to take the release from: an offline folder or a dist folder, instead of a URL | |
--reason | string | why, for --switch-channel and --allow-older (in the audit log with the database) | |
--switch-channel | bool | move to --channel from the channel the cluster (or the folder) follows; needs --reason, and with the database sets the cluster's channel, audited |
Inherited flags
| Flag | Type | Default | Description |
|---|---|---|---|
--context | string | $OZ0_CONTEXT or <config dir>/orchestrator-zero/context.json | CLI context file written by server init |
--log-level | string | info | log level: debug, info, warn or error |
See all oz0 commands and the global flags.