just is Clusterone's command line interface. It allows users to administrate projects, datasets, and individual jobs on Clusterone from the command line.
The CLI is included with the Clusterone Python package. Install it through pip:
pip install clusterone
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
just config endpoint <your endpoint>, where endpoint looks like
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.
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.
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.
Display the help. To display the general help use:
To display a list of available options for each command, type:
just <command> --help
Display the current version of just and exit.
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:
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
echo "export PATH=$PATH:~/.local/bin" >> .bashrc
echo "export PATH=$PATH:~/.local/bin" >> .bash_profile