kosli assert snapshot #

Synopsis #

Assert the compliance status of an environment in Kosli. Exits with non-zero code if the environment has a non-compliant status. The expected argument is an expression to specify the specific environment snapshot to assert. It has the format <ENVIRONMENT_NAME>[SEPARATOR][SNAPSHOT_REFERENCE]

Separators can be:

  • '#' to specify a specific snapshot number for the environment that is being asserted.
  • '~' to get N-th behind the latest snapshot.

Examples of valid expressions are:

  • prod (latest snapshot of prod)
  • prod#10 (snapshot number 10 of prod)
  • prod~2 (third latest snapshot of prod)
kosli assert snapshot ENVIRONMENT-NAME-OR-EXPRESSION [flags]

Flags #

Flag Description
-D, --dry-run [optional] Run in dry-run mode. When enabled, no data is sent to Kosli and the CLI exits with 0 exit code regardless of any errors.
-h, --help help for snapshot

Flags inherited from parent commands #

Flag Description
-a, --api-token string The Kosli API token.
-c, --config-file string [optional] The Kosli config file path. (default "kosli")
--debug [optional] Print debug logs to stdout. A boolean flag https://docs.kosli.com/faq/#boolean-flags (default false)
-H, --host string [defaulted] The Kosli endpoint. (default "https://app.kosli.com")
--http-proxy string [optional] The HTTP proxy URL including protocol and port number. e.g. 'http://proxy-server-ip:proxy-port'
-r, --max-api-retries int [defaulted] How many times should API calls be retried when the API host is not reachable. (default 3)
--org string The Kosli organization.

Examples Use Cases #

kosli assert snapshot prod#5 \
	--api-token yourAPIToken \
	--org yourOrgName