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:conda install -kc https://anaconda.example.com/repository/conda/anaconda-enterprise anaconda-enterprise-cli cas-mirror git
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:
anaconda-enterprise-cli config set sites.master.url https://<your.domain.com>/repository/api
Run the following command to configure the instance of Anaconda Enterprise Repository you will be using as the default site:
anaconda-enterprise-cli config set default_site master
To see a consolidated view of the configuration, run the following command:
anaconda-enterprise-cli config view
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:
$ anaconda-enterprise-cli config set ssl_verify true
# On Ubuntu
$ anaconda-enterprise-cli config set sites.master.ssl_verify /etc/ssl/certs/ca-certificates.crt
# On RHEL/CentOS
$ anaconda-enterprise-cli config set sites.master.ssl_verify /etc/pki/tls/certs/ca-bundle.crt
Logging in to the Anaconda Enterprise CLI¶
Run this command to access the CLI:
anaconda-enterprise-cli login
Log in to the CLI using the same username and password that you use to log in the Anaconda Enterprise web interface:
Username: <your-username> Password: <your-password>
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.