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") |
| -t, --trail string | [optional] The Kosli trail name. |
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 the latest artifact with a given fingerprint from a flow in a specific trail
kosli get artifact flowName@fingerprint \
--api-token yourAPIToken \
--org orgName
--trail trailName
get an artifact with a given commit SHA from a flow
kosli get artifact flowName:commitSHA \
--api-token yourAPIToken \
--org orgName
get a list of artifacts with a given commit SHA from a flow in a particular trail
kosli get artifact flowName:commitSHA \
--api-token yourAPIToken \
--org orgName
--trail trailName
