Cloudera Docs

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.

Procedure for obtaining the VIRTUAL-CLUSTER-ENDPOINT:

  1. Log in to the Cloudera Data Engineering UI and navigate to Administration in the left-navigation menu.
  2. Select the respective service and then the respective VC.
  3. Click on the Virtual Cluster Details icon.
  4. Click on the Actions button.
  5. Click Copy Jobs API URL.
  1. 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.
  2. 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.
  3. In the configuration file, specify the Cloudera user and virtual cluster endpoint as follows:
    user: <CDP_user>
vcluster-endpoint: <CDE_virtual_cluster_endpoint>
    The Cloudera user is your workload username.
  4. Save the configuration file.
  5. If you have not done so already, make sure that the cde file is executable by running chmod +x /path/to/cde.
  6. Run cde job list to verify your configuration. Enter your workload password when prompted.
See for other configuration options.