Workbench CLI - Anaconda

The Data Science & AI Workbench has a collection of tools that you can use to interact with your instance of Workbench at the operating system (OS) level. Workbench uses the anaconda-enterprise-cli package to manage its system via the command line. Everything you need to use the CLI tools is contained in the ae5-conda-latest-Linux-x86_64.sh script that is run during environment preparation. Follow the steps for administration server setup on your current machine to install anaconda-enterprise-cli.

Configuring the CLI

Before you can log in to your instance of Workbench, you’ll need to tell the CLI which sites it has access to and which one of the available sites to reach out to and interact with. To configure your CLI, complete the following steps:

Add your Workbench repository URL to the list of sites anaconda-enterprise-cli can access by running the following command:

# Replace <FQDN> with the fully qualified domain name of your Workbench instance
# Replace <SITE_NAME> with a short name you want to use to refer to your Workbench site
anaconda-enterprise-cli config set sites.<SITE_NAME>.url https://<FQDN>/repository/api

Configure your instance of Workbench as the default site for anaconda-enterprise-cli to interact with by running the following command:
```
# Replace <SITE_NAME> with the short name you provided in the previous command
anaconda-enterprise-cli config set default_site <SITE_NAME>
```
Verify your configuration was successful by running the following command:
```
anaconda-enterprise-cli config view
```

Logging in to the CLI

Access the CLI by running the following command:
```
anaconda-enterprise-cli login
```
Use your Workbench username and password to log in when prompted:
```
Username: <YOUR_USERNAME>
Password: <YOUR_PASSWORD>
```

Configuring SSL certificates using the CLI

If you updated the platform’s TLS/SSL certificate, you must update the Workbench CLI configurations to use the new repository certificates using the following commands:

anaconda-enterprise-cli config set ssl_verify true

Next Steps: You can now configure channels and mirrors for your Workbench users.

CLI Configuration files

The Workbench CLI reads configuration information from the following places: System-level configuration: /etc/anaconda-platform/cli.yml User-level configuration: $INSTALL_PREFIX/anaconda-platform/cli.yml and $HOME/.anaconda/anaconda-platform/cli.yml To change how the CLI is configured, modify the appropriate cli.yml files based on your needs.

Changing configuration settings at the user level overrides any system-level CLI configurations.

Included CLI tools

The Workbench CLI uses multiple tools to interact with your instance and your repositories, and these tools are provided via the ae5-conda-latest-Linux-x86_64.sh script. The script contains the following tools:

Package	Version	Build	Channel	Documentation
ae5-tools	0.4.1	pypi_0	ae5-admin
ae5_backup_restore	0.3.2	0	ae5-admin
ae_preflight	0.1.9	py_0	ae5-admin	ae_preflight github
anaconda-enterprise-cli	5.5.2	pypi_0	ae5-admin
anaconda-mirror	5.4.0	pypi_0	defaults	Mirroring channels and packages
python	3.11.2	h7a1cb2a_0

Data Science & AI Workbench (5.8.0)

​Configuring the CLI

​Logging in to the CLI

​Configuring SSL certificates using the CLI

​CLI Configuration files

​Included CLI tools

Configuring the CLI

Logging in to the CLI

Configuring SSL certificates using the CLI

CLI Configuration files

Included CLI tools