kosli diff snapshots

Diff environment snapshots.

Synopsis

kosli diff snapshots SNAPPISH_1 SNAPPISH_2 [flags]

Diff environment snapshots.
Specify SNAPPISH_1 and SNAPPISH_2 by:

• environmentName
  • the latest snapshot for environmentName, at the time of the request
  • e.g., prod
• environmentName#N
  • the Nth snapshot, counting from 1
  • e.g., prod#42
• environmentName~N
  • the Nth snapshot behind the latest, at the time of the request
  • e.g., prod~5
• environmentName@{YYYY-MM-DDTHH:MM:SS}
  • the snapshot at specific moment in time in UTC
  • e.g., prod@{2023-10-02T12:00:00}
• environmentName@{N.hours|days|weeks|months.ago}
  • the snapshot at a time relative to the time of the request
  • e.g., prod@{2.hours.ago}

Flags

Flag	Description
-h, —help	help for snapshots
-o, —output string	[defaulted] The format of the output. Valid formats are: [table, json]. (default “table”)
-u, —show-unchanged	[defaulted] Show the unchanged artifacts present in both snapshots within the diff output.

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 docs (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.

Live Example

To view a live example of ‘kosli diff snapshots’ you can run the commands below (for the cyber-dojo demo organization).
Run the commands below and view the output.

Examples Use Cases

These examples all assume that the flags --api-token, --org, --host, (and --flow, --trail when required), are set/provided.

compare the third latest snapshot in an environment to the latest

kosli diff snapshots envName~3 envName 

compare snapshots of two different environments of the same type

kosli diff snapshots envName1 envName2 

show the not-changed artifacts in both snapshots

kosli diff snapshots envName1 envName2 
	--show-unchanged 

compare the snapshot from 2 weeks ago in an environment to the latest

kosli diff snapshots envName@{2.weeks.ago} envName