CLI reference

apolo-flow

Usage:

apolo-flow [OPTIONS] COMMAND [ARGS]...

Options:

Name	Description
--config PATH	Path to a directory with .apolo folder inside, automatic lookup is performed if not set (default)
-v, --verbose	Give more output. Option is additive, and can be used up to 2 times.
-q, --quiet	Give less output. Option is additive, and can be used up to 2 times.
--show-traceback	Show python traceback on error, useful for debugging the tool.
--version	Show the version and exit.
--help	Show this message and exit.

Command Groups:

Usage	Description
apolo-flow completion	Output shell completion code.

Commands:

Usage	Description
apolo-flow bake	Start a batch.
apolo-flow bakes	List existing bakes.
apolo-flow build	Build an image.
apolo-flow cancel	Cancel a bake.
apolo-flow clean	Clean volume.
apolo-flow clear-cache	Clear cache.
apolo-flow delete-flow	Completely remove flow with all related entities
apolo-flow download	Download volume.
apolo-flow init	Initialize a flow from a selected template.
apolo-flow inspect	Inspect a bake.
apolo-flow kill	Kill a job.
apolo-flow logs	Print logs.
apolo-flow mkvolumes	Create all remote folders for volumes.
apolo-flow ps	List all jobs
apolo-flow restart	Start a batch.
apolo-flow run	Run a job.
apolo-flow show	Show output of baked task.
apolo-flow status	Show job status.
apolo-flow upload	Upload volume.

apolo-flow completion

Output shell completion code.

Usage:

apolo-flow completion [OPTIONS] COMMAND [ARGS]...

Options:

Name	Description
--help	Show this message and exit.

Commands:

Usage	Description
apolo-flow completion generate	Provide instruction for shell completion generation.
apolo-flow completion patch	Automatically patch shell configuration profile to enable completion

apolo-flow completion generate

Provide instruction for shell completion generation.

Usage:

apolo-flow completion generate [OPTIONS] {bash|zsh}

Options:

Name	Description
--help	Show this message and exit.

apolo-flow completion patch

Automatically patch shell configuration profile to enable completion

Usage:

apolo-flow completion patch [OPTIONS] {bash|zsh}

Options:

Name	Description
--help	Show this message and exit.

apolo-flow bake

Start a batch.

Run BATCH pipeline remotely on the cluster.

Usage:

apolo-flow bake [OPTIONS] BATCH

Options:

Name	Description
--local-executor	Run primary job locally
-p, --param <TEXT TEXT>...	Set params of the batch config
-n, --name NAME	Optional bake name
--meta-from-file FILE	File with params for batch.
-t, --tag TAG	Optional bake tag, multiple values allowed
--help	Show this message and exit.

apolo-flow bakes

List existing bakes.

Usage:

apolo-flow bakes [OPTIONS]

Options:

Name	Description
-t, --tag TAG	Filter out bakes by tag (multiple option)
--since DATE_OR_TIMEDELTA	Show bakes created after a specific date (including). Use value of format '1d2h3m4s' to specify moment in past relatively to current time.
--until DATE_OR_TIMEDELTA	Show bakes created before a specific date (including). Use value of format '1d2h3m4s' to specify moment in past relatively to current time.
--recent-first / --recent-last	Show newer bakes first or last
--help	Show this message and exit.

apolo-flow build

Build an image.

Assemble the IMAGE remotely and publish it.

Usage:

apolo-flow build [OPTIONS] IMAGE

Options:

Name	Description
-F, --force-overwrite	Build even if the destination image already exists.
--help	Show this message and exit.

apolo-flow cancel

Cancel a bake.

Cancel a bake execution by stopping all started tasks.

Usage:

apolo-flow cancel [OPTIONS] BAKE

Options:

Name	Description
-a, --attempt INTEGER	Attempt number, the last attempt by default
--help	Show this message and exit.

apolo-flow clean

Clean volume.

Clean remote files on VOLUME, use clean ALL for cleaning up all volumes.

Usage:

apolo-flow clean [OPTIONS] VOLUME

Options:

Name	Description
--help	Show this message and exit.

apolo-flow clear-cache

Clear cache.

Use apolo-flow clear-cache <BATCH> for cleaning up the cache for BATCH; Use apolo-flow clear-cache <BATCH> <TASK_ID> for cleaning up the cache for TASK_ID in BATCH;

apolo-flow clear-cache ALL clears all caches.

Usage:

apolo-flow clear-cache [OPTIONS] BATCH [TASK_ID]

Options:

Name	Description
--help	Show this message and exit.

apolo-flow delete-flow

Completely remove flow with all related entities

Usage:

apolo-flow delete-flow [OPTIONS] FLOW_IDS...

Options:

Name	Description
--help	Show this message and exit.

apolo-flow download

Download volume.

Download remote files to local for VOLUME, use download ALL for downloading all volumes.

Usage:

apolo-flow download [OPTIONS] VOLUME

Options:

Name	Description
--help	Show this message and exit.

apolo-flow init

Initialize a flow from a selected template.

Creates required storage as well.

Usage:

apolo-flow init [OPTIONS] [[barebone|default]]

Options:

Name	Description
--help	Show this message and exit.

apolo-flow inspect

Inspect a bake.

Display a list of started/finished tasks of BAKE_ID.

Usage:

apolo-flow inspect [OPTIONS] BAKE

Options:

Name	Description
-a, --attempt INTEGER	Attempt number, the last attempt by default
-o, --output-graph FILE	A path to Graphviz (DOT) file. Autogenerated from BAKE_ID and attempt number by default
--dot	Save DOT file with tasks statuses.
--pdf	Save PDF file with tasks statuses.
--view	Open generated PDF file with tasks statuses.
--help	Show this message and exit.

apolo-flow kill

Kill a job.

Kill JOB-ID, use kill ALL for killing all jobs.

Usage:

apolo-flow kill [OPTIONS] JOB_ID [SUFFIX]

Options:

Name	Description
--help	Show this message and exit.

apolo-flow logs

Print logs.

Display logs for JOB-ID

Usage:

apolo-flow logs [OPTIONS] JOB_ID [SUFFIX]

Options:

Name	Description
--help	Show this message and exit.

apolo-flow mkvolumes

Create all remote folders for volumes.

Usage:

apolo-flow mkvolumes [OPTIONS]

Options:

Name	Description
--help	Show this message and exit.

apolo-flow ps

List all jobs

Usage:

apolo-flow ps [OPTIONS]

Options:

Name	Description
--help	Show this message and exit.

apolo-flow restart

Start a batch.

Run BATCH pipeline remotely on the cluster.

Usage:

apolo-flow restart [OPTIONS] BAKE

Options:

Name	Description
-a, --attempt INTEGER	Attempt number, the last attempt by default
--local-executor	Run primary job locally
--from-failed / --no-from-failed	Restart from the point of failure
--help	Show this message and exit.

apolo-flow run

Run a job.

RUN job JOB-ID or ATTACH to it if the job is already running

For multi-jobs an explicit job suffix can be used with explicit job arguments.

Usage:

apolo-flow run [OPTIONS] JOB_ID [ARGS]...

Options:

Name	Description
-s, --suffix TEXT	Optional suffix for multi-jobs
-p, --param <TEXT TEXT>...	Set params of the batch config
--dry-run	Print run command instead of starting job.
--help	Show this message and exit.

apolo-flow show

Show output of baked task.

Display a logged output of TASK_ID from BAKE_ID.

Usage:

apolo-flow show [OPTIONS] BAKE TASK_ID

Options:

Name	Description
-a, --attempt INTEGER	Attempt number, the last attempt by default
-r, --raw / -R, --no-raw	Raw mode disables the output postprocessing (the output is processed by default)
--help	Show this message and exit.

apolo-flow status

Show job status.

Print status for JOB-ID

Usage:

apolo-flow status [OPTIONS] JOB_ID [SUFFIX]

Options:

Name	Description
--help	Show this message and exit.

apolo-flow upload

Upload volume.

Upload local files to remote for VOLUME, use upload ALL for uploading all volumes.

Usage:

apolo-flow upload [OPTIONS] VOLUME

Options:

Name	Description
--help	Show this message and exit.