CLI Reference

apolo-extras

Auxiliary scripts and recipes for automating routine tasks.

Usage:

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

Options:

Name
Description

-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.

--version

Show the version and exit.

--help

Show this message and exit.

Command Groups:

Usage
Description

Configuration operations.

Data transfer operations.

Job container image operations.

Cluster Kubernetes operations.

Seldon deployment operations.

Commands:

Usage
Description

Create apolo CLI aliases for apolo-extras functionality.

apolo-extras config

Configuration operations.

Usage:

apolo-extras config [OPTIONS] COMMAND [ARGS]...

Options:

Name
Description

--help

Show this message and exit.

Commands:

Usage
Description

Generate docker auth for accessing remote registry.

Save docker auth file for accessing platform registry.

apolo-extras config build-registy-auth

Generate docker auth for accessing remote registry.

Usage:

apolo-extras config build-registy-auth [OPTIONS] REGISTRY_URI USERNAME
                                              PASSWORD

Options:

Name
Description

--help

Show this message and exit.

apolo-extras config save-registry-auth

Save docker auth file for accessing platform registry.

Usage:

apolo-extras config save-registry-auth [OPTIONS] PATH

Options:

Name
Description

--cluster TEXT

Cluster name for which the auth information should be saved. Current cluster by default

--help

Show this message and exit.

apolo-extras data

Data transfer operations.

Usage:

apolo-extras data [OPTIONS] COMMAND [ARGS]...

Options:

Name
Description

--help

Show this message and exit.

Commands:

Usage
Description

Copy data between external object storage and cluster.

Copy data between storages on different clusters.

apolo-extras data cp

Copy data between external object storage and cluster. Supported external object storage systems: ['AWS', 'GCS', 'AZURE', 'HTTP', 'HTTPS']. Note: originally, Azure's blob storage scheme is 'http(s)', but we prepend 'azure+' to differenciate https vs azure

Usage:

apolo-extras data cp [OPTIONS] SOURCE DESTINATION

Options:

Name
Description

-x, --extract

Perform extraction of SOURCE into the DESTINATION directory. The archive type is derived from the file name. Supported types: .tar.gz, .tgz, .tar.bz2, .bz2, .tbz, .tar, .gz, .zip.

-c, --compress

Perform compression of SOURCE into the DESTINATION file. The archive type is derived from the file name. Supported types: .tar.gz, .tgz, .tar.bz2, .bz2, .tbz, .tar, .gz, .zip.

-v, --volume MOUNT

Mounts directory from vault into container. Use multiple options to mount more than one volume.

-e, --env VAR=VAL

Set environment variable in container. Use multiple options to define more than one variable.

-t, --use-temp-dir

DEPRECATED - need for temp dir is automatically detected, this flag will be removed in a future release. Download and extract / compress data (if needed) inside the temporary directory. Afterwards move resulted file(s) into the DESTINATION. NOTE: use it if 'storage:' is involved and extraction or compression is performed to speedup the process.

-s, --preset PRESET_NAME

Preset name used for copy.

-l, --life_span SECONDS

Copy job life span in seconds.

--help

Show this message and exit.

apolo-extras data transfer

Copy data between storages on different clusters.

Consider archiving dataset first for the sake of performance, if the dataset contains a lot (100k+) of small (< 100Kb each) files.

Usage:

apolo-extras data transfer [OPTIONS] SOURCE DESTINATION

Options:

Name
Description

--help

Show this message and exit.

apolo-extras image

Job container image operations.

Usage:

apolo-extras image [OPTIONS] COMMAND [ARGS]...

Options:

Name
Description

--help

Show this message and exit.

Commands:

Usage
Description

Build Job container image remotely on cluster using Kaniko.

Build Job container image locally (requires Docker daemon).

Copy images between clusters.

apolo-extras image build

Build Job container image remotely on cluster using Kaniko.

Usage:

apolo-extras image build [OPTIONS] CONTEXT_PATH IMAGE_URI

Options:

Name
Description

-f, --file TEXT

Relative (w.r.t. context) path to the dockerfile. The dockerfile should be within the context directory. [default: Dockerfile]

--build-arg VAR=VAL

Build-time variables passed in ARG values, similarly to Docker. Could be used multiple times for multiple arguments.

-v, --volume MOUNT

Mounts directory from storage into container. Use multiple options to mount more than one volume.

-e, --env VAR=VAL

Set environment variable in container. Use multiple options to define more than one variable. Those env vars will be passed as build arguments too.

-s, --preset PRESET

Predefined resource configuration (to see available values, run apolo config show)

-F, --force-overwrite

Overwrite if the destination image already exists.

--cache / --no-cache

Use Kaniko cache while building image. [default: cache]

--verbose BOOLEAN

If specified, run Kaniko with 'debug' verbosity, otherwise 'info' (default).

--build-tag VAR=VAL

Set tag(s) for image builder job. We will add tag 'kaniko-builds:{image-name}' authomatically.

-p, --project PROJECT_NAME

Start image builder job in other than the current project.

--extra-kaniko-args ARGS

Extra arguments for Kaniko builder. Useful for advanced users, e.g. to set custom Kaniko caching behaviour. We set some default arguments for you, so use this option with caution. Please refer to Kaniko documentation for more details at https://github.com/GoogleContainerTools/kaniko?tab=readme-ov-file#additional-flags

--help

Show this message and exit.

apolo-extras image local-build

Build Job container image locally (requires Docker daemon).

Usage:

apolo-extras image local-build [OPTIONS] CONTEXT_PATH IMAGE_URI

Options:

Name
Description

-f, --file TEXT

Relative (w.r.t. context) path to the dockerfile. The dockerfile should be within the context directory. [default: Dockerfile]

--build-arg VAR=VAL

Build-time variables passed in ARG values. Could be used multiple times for multiple arguments.

-F, --force-overwrite

Overwrite if the destination image already exists.

--verbose BOOLEAN

If specified, provide verbose output (default False).

-p, --project PROJECT_NAME

Start image builder job in other than the current project.

--help

Show this message and exit.

apolo-extras image transfer

Copy images between clusters.

Usage:

apolo-extras image transfer [OPTIONS] SOURCE DESTINATION

Options:

Name
Description

-F, --force-overwrite

Transfer even if the destination image already exists.

--help

Show this message and exit.

apolo-extras k8s

Cluster Kubernetes operations.

Usage:

apolo-extras k8s [OPTIONS] COMMAND [ARGS]...

Options:

Name
Description

--help

Show this message and exit.

Commands:

apolo-extras k8s generate-registry-secret

Usage:

apolo-extras k8s generate-registry-secret [OPTIONS]

Options:

Name
Description

--name TEXT

--help

Show this message and exit.

apolo-extras k8s generate-secret

Usage:

apolo-extras k8s generate-secret [OPTIONS]

Options:

Name
Description

--name TEXT

--help

Show this message and exit.

apolo-extras seldon

Seldon deployment operations.

Usage:

apolo-extras seldon [OPTIONS] COMMAND [ARGS]...

Options:

Name
Description

--help

Show this message and exit.

Commands:

apolo-extras seldon generate-deployment

Usage:

apolo-extras seldon generate-deployment [OPTIONS] MODEL_IMAGE_URI
                                               MODEL_STORAGE_URI

Options:

Name
Description

--name TEXT

--apolo-secret TEXT

--registry-secret TEXT

--help

Show this message and exit.

apolo-extras seldon init-package

Usage:

apolo-extras seldon init-package [OPTIONS] [PATH]

Options:

Name
Description

--help

Show this message and exit.

apolo-extras init-aliases

Create apolo CLI aliases for apolo-extras functionality.

Usage:

apolo-extras init-aliases [OPTIONS]

Options:

Name
Description

--help

Show this message and exit.

Last updated