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

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 #

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