Configuring the CLI client

The CDE CLI client uses a configuration file, ~/.cde/config.yaml, to define the default Cloudera Data Engineering virtual cluster to interact with, as well as other configuration parameters.

Make sure that you have downloaded the CDE CLI client.

Determine the virtual cluster endpoint URL.
1. Navigate to the Cloudera Data Engineering Overview page.
2. In the Environments column, select the environment containing the virtual cluster you want to access using the CLI.
3. In the Virtual Clusters column on the right, click the Cluster Details icon for the virtual cluster you want to access.
4. Click JOBS API URL to copy the URL to your clipboard.
  
  note
  Currently, the URL copied to your clipboard begins with http://, not https://. To use the URL, you must manually change this to https://.
On the host with the CLI client, create or edit the configuration file at ~/.cde/config.yaml. You can create multiple profiles in the ~/.cde/config.yaml file and can be used while running commands. For more information, see Creating and using multiple profiles.

note
You can use a custom file location by setting the CDE_CONFIG environment variable. If you include “user: ” in your config.yaml, the CLI tool will not use the access token and will instead keep prompting for a password. If you want to use a credential file, then you must remove the specified user from the profile.
In the configuration file, specify the Cloudera user and virtual cluster endpoint as follows:
```
user: <CDP_user>
vcluster-endpoint: <CDE_virtual_cluster_endpoint>
```
important
The CLI in this release does not support TLS validation. You must disable TLS validation by adding the following lines to the Cloudera Data Engineering configuration file:
```
tls-insecure: true
```
The connection still uses HTTPS, but the TLS certificate is not validated.
The Cloudera user is your workload username.
Save the configuration file.
If you have not done so already, make sure that the cde file is executable by running chmod +x /path/to/cde.
Run cde job list to verify your configuration. Enter your workload password when prompted.

note
If the directory containing the cde file is not part of your PATH environment variable, you can either add it to your PATH environment variable or use the full path when running the command.
You can also configure the CLI to use an access token so that you do not need to enter your password each time. For more information, see Cloudera Data Engineering CLI authentication.

See CDE CLI configuration options for other configuration options.