Skip to main content
kosli expect deployment is deprecated. deployment expectation is no longer required for compliance. Deprecated commands will be removed in a future release.

Synopsis

kosli expect deployment [IMAGE-NAME | FILE-PATH | DIR-PATH] [flags]
Report the expectation of an upcoming deployment of an artifact to an environment. The artifact fingerprint can be provided directly with the --fingerprint flag, or calculated based on --artifact-type flag. Artifact type can be one of: “file” for files, “dir” for directories, “oci” for container images in registries or “docker” for local docker images.

Flags

FlagDescription
-t, —artifact-type stringThe type of the artifact to calculate its SHA256 fingerprint. One of: [oci, docker, file, dir]. Only required if you want Kosli to calculate the fingerprint for you (i.e. when you don’t specify ‘—fingerprint’ on commands that allow it).
-b, —build-url stringThe url of CI pipeline that built the artifact. (defaulted in some CIs: docs ).
-d, —description string[optional] The deployment 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.
-e, —environment stringThe environment name.
-x, —exclude strings[optional] The comma separated list of directories and files to exclude from fingerprinting. Can take glob patterns. Only applicable for —artifact-type dir.
-F, —fingerprint string[conditional] The SHA256 fingerprint of the artifact. Only required if you don’t specify ‘—artifact-type’.
-f, —flow stringThe Kosli flow name.
-h, —helphelp for deployment
—registry-password string[conditional] The container registry password or access token. Only required if you want to read container image SHA256 digest from a remote container registry.
—registry-username string[conditional] The container registry username. Only required if you want to read container image SHA256 digest from a remote container registry.
-u, —user-data string[optional] The path to a JSON file containing additional data you would like to attach to the deployment.

Flags inherited from parent commands

FlagDescription
-a, —api-token stringThe 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 stringThe Kosli organization.
Last modified on March 11, 2026