kosli get artifact #

Synopsis #

Get artifact from a specified flow You can get an artifact by its fingerprint or by its git commit sha. In case of using the git commit, it is possible to get multiple artifacts matching the git commit.

The expected argument is an expression to specify the artifact to get. It has the format <FLOW_NAME><COMMIT_SHA1|ARTIFACT_FINGERPRINT>

Expression can be specified as follows:

  • flowName@ artifact with a given fingerprint. The fingerprint can be short or complete.
  • flowName:<commit_sha> artifact with a given commit SHA. The commit sha can be short or complete.

Examples of valid expressions are:

  • flow@184c799cd551dd1d8d5c5f9a5d593b2e931f5e36122ee5c793c1d08a19839cc0
  • flow@184c7
  • flow:110d048bf1fce72ba546cbafc4427fb21b958dee
  • flow:110d0
kosli get artifact EXPRESSION [flags]

Flags #

Flag Description
-h, --help help for artifact
-o, --output string [defaulted] The format of the output. Valid formats are: [table, json]. (default "table")

Options 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")
-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 #

# get an artifact with a given fingerprint from a flow
kosli get artifact flowName@fingerprint \
	--api-token yourAPIToken \
	--org orgName

# get an artifact with a given commit SHA from a flow
kosli get artifact flowName:commitSHA \
	--api-token yourAPIToken \
	--org orgName