cloudera.cloud - Cloudera on cloud and Data Services

cloudera.cloud is an Ansible collection that lets you manage your Cloudera Platform on cloud (Public Cloud) resources. With this collection, you can:

• Create and manage Datalakes and Environments.
• Manage Users and Groups.
• Create and manage Data Hubs and Data Services, such as:
  • Cloudera Data Flow (CDF)
  • Cloudera Data Engineering (CDE)
  • Cloudera Data Warehouse (CDW)
  • Cloudera Machine Learning (CML)
  • Cloudera Operational Database
  • Cloudera Stream Processing (CSP)

If you have any questions, want to chat about the collection's capabilities and usage, need help using the collection, or just want to stay updated, join us at our Discussions.

Quickstart

See the API documentation for details for each plugin and role within the collection.

1. Install the collection
2. Install the requirements
3. Use the collection

Roadmap

If you want to see what we are working on or have pending, check out:

• the Milestones and active issues to see our current activity,
• the issue backlog to see what work is pending or under consideration, and
• read up on the Ideas we have in mind.

Are we missing something? Let us know by creating a new issue or posting a new idea!

Contribute

For more information on how to get involved with the cloudera.cloud Ansible collection, head over to CONTRIBUTING.md.

Installation

To install the cloudera.cloud collection, you have several options.

The preferred method is to install via Ansible Galaxy; in your requirements.yml file, add the following:

collections:
  - name: cloudera.cloud

If you want to install from GitHub, add to your requirements.yml file the following:

collections:
  - name: https://github.com/cloudera-labs/cloudera.cloud.git
    type: git
    version: main

And then run in your project:

ansible-galaxy collection install -r requirements.yml

You can also install the collection directly:

# From Ansible Galaxy
ansible-galaxy collection install cloudera.cloud

# From GitHub
ansible-galaxy collection install git+https://github.com/cloudera-labs/cloudera.cloud.git@main

ansible-builder can discover and install all Python dependencies - current collection and dependencies - if you wish to use that application to construct your environment. Otherwise, you will need to read each collection and role dependency and follow its installation instructions.

See the Collection Metadata section for further details on how to install (and manage) collection dependencies.

You may wish to use a virtual environment to manage the Python dependencies.

Using the Collection

Once installed, reference the collection in your playbooks and roles.

For example, here we use the cloudera.cloud.env_info module to list all available CDP environments:

- hosts: localhost
  connection: local
  gather_facts: no
  tasks:
    - name: List all CDP environments
      cloudera.cloud.env_info:
      register: output

    - name: Display the resulting JSON
      ansible.builtin.debug:
        var: output

Important

The collection expects standard Cloudera Platform authentication configurations, e.g. CDP_PROFILE, as described by the Configuring section of CDP CLI/SDK.

Building the API Documentation

To create a local copy of the API documentation, first make sure the collection is in your ANSIBLE_COLLECTIONS_PATH.

hatch run docs:build

Your local documentation will be found at docsbuild/build/html.

You can also lint the documentation with the following command:

hatch run docs:lint

Preparing a New Version

To prepare a version release, first set the following variables for antsichaut:

export GITHUB_TOKEN=some_gh_token_value # Read-only scope

Update the collection version using hatch version. For example, to increment to the next minor release:

hatch version minor

Then update the changelog to query the pull requests since the last release.

hatch run docs:changelog

You can then examine (and update if needed) the resulting changelog.yaml and CHANGELOG.rst files before committing to the release branch.

License and Copyright

Copyright 2025, Cloudera, Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.