Installing the Anaconda Enterprise CLI¶
Warning
The following process for installing the Anaconda Enterprise CLI results in a broken conda env. Follow the workaround described here instead, until the issue is addressed in a future release of Anaconda Enterprise.
If you want to be able to create and share channels and packages from your Anaconda Enterprise Repository using conda
commands, you need to download and install the Anaconda Enterprise CLI. If you updated the platform’s TLS/SSL certificate, you can also use the AE CLI to configure the TLS/SSL certs for the repository.
Prerequisites:
To install the CLI, run the following command, replacing
anaconda.example.com
with the fully-qualified domain name (FQDN) of your Anaconda Enterprise instance:
Note
You’ll notice that running this command also installs cas-mirror
, the package mirroring tool. For more information on package mirroring, see Configuring channels and packages.
After the list of package dependencies has been resolved, type
y
to proceed with the installation.
Configuring the Anaconda Enterprise CLI¶
To add the url of the Anaconda Enterprise Repository to the set of available sites, run the following command with the fully-qualified domain name (FQDN) of your Anaconda Enterprise instance:
Run the following command to configure the instance of Anaconda Enterprise Repository you will be using as the default site:
To see a consolidated view of the configuration, run the following command:
The Anaconda Enterprise 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 it’s configured, modify the appropriate cli.yml
file(s), based on your needs.
Note
Changing configuration settings at the user level overrides any system-level configuration.
If you updated the platform’s TLS/SSL certificate, you can use the AE CLI to configure the certificates for the repository using the following commands:
Logging in to the Anaconda Enterprise CLI¶
Run this command to access the CLI:
Log in to the CLI using the same username and password that you use to log in the Anaconda Enterprise web interface:
Next Steps: You can now configure access to the source of the packages to be mirrored, whether an online repository or a tarball (if an air-gapped installation). Then you’ll be ready to begin mirroring channels and packages.