CLI Reference Documentation

Last updated 5 months ago

Current version: PyPI version‚Äč

just is Clusterone's command line interface. It allows users to administrate projects, datasets, and individual jobs on Clusterone from the command line.

Installation & Configuration

The CLI is included with the Clusterone Python package. Install it through pip:

pip install clusterone

Enterprise

If you have a VPC or on-premise installation, you need to point the CLI to your installation.

  • Get the endpoint from your onboarding document

  • Run just config endpoint <your endpoint>, where endpoint looks like https://clusterone.com/api/. https://clusterone.com also works, the trailing /api is added automatically.

The configuration needs to be run only once, it persists through CLI launches and updates.

See the just config documentation page for more information.

Usage

This is the basic structure of a just command:

just <command> [<subcommand>...] [<arg>...] [options]

Commands can be followed by subcommands. For example, just create project [options] creates a new project, while just create dataset [options] creates a new dataset.

Some commands require a mandatory argument. For example, just rm job requires the name or ID of the job to delete: just rm job my-job.

Additionally, the just create job command allows passing custom arguments to the Python script executed by the job.

A command can have zero to multiple options, different options need to be separated by a space.

General Options

-h, --help

Display the help. To display the general help use:

just --help

To display a list of available options for each command, type:

just <command> --help

--version

Display the current version of just and exit.

Troubleshooting

just: command not found

In some cases, the command line cannot find the just command after installing the clusterone Python package.

If you've installed the package with the --user option via pip, try running this command:

export PATH=$PATH:~/.local/bin

This will update your PATH variable to search for packages in the local user directory.

If this solves the problem, you can make the change persistent by adding it to your .bashrc / .bash_profile via:

echo "export PATH=$PATH:~/.local/bin" >> .bashrc

or

echo "export PATH=$PATH:~/.local/bin" >> .bash_profile