Install the Run:ai Command-line Interface¶
The Run:ai Command-line Interface (CLI) is one of the ways for a Researcher to send deep learning workloads, acquire GPU-based containers, list jobs, etc.
The instructions below will guide you through the process of installing the CLI. The Run:ai CLI runs on Mac and Linux. You can run the CLI on Windows by using Docker for Windows. See the end of this document.
When enabled, Researcher authentication requires additional setup when installing the CLI. To configure authentication see Setup Project-based Researcher Access Control. Use the modified Kubernetes configuration file described in the article.
- When installing the command-line interface, it is worth considering future upgrades:
- Install the CLI on a dedicated Jumpbox machine. Researchers will connect to the Jumpbox from which they can submit Run:ai commands
- Install the CLI on a shared directory that is mounted on Researchers' machines.
- A Kubernetes configuration file.
- In the Researcher's root folder, create a directory .kube. Copy the Kubernetes configuration file into the directory. Each Researcher should have a separate copy of the configuration file. The Researcher should have write access to the configuration file as it stores user defaults.
- If you choose to locate the file at a different location than
~/.kube/config, you must create a shell variable to point to the configuration file as follows:
- Test the connection by running:
Install Run:ai CLI¶
- Go to the Run:ai user interface. On the top right select
Researcher Command Line Interface.
- Download directly using the button or copy the file to run it on a remote machine
An alternative way of downloading the CLI is provided under the CLI Troubleshooting section.
To verify the installation run:
Install Command Auto-Completion¶
It is possible to configure your Linux/Mac shell to complete Run:ai CLI commands. This feature works on bash and zsh shells only.
Edit the file
~/.zshrc. Add the lines:
Install the bash-completion package:
brew install bash-completion
sudo apt-get install bash-completion
sudo yum install bash-completion
Edit the file
~/.bashrc. Add the lines:
Troubleshoot the CLI Installation¶
Update the Run:ai CLI¶
To update the CLI to the latest version perform the same install process again.
Delete the Run:ai CLI¶
If you have installed using the default path, run: