cloudera.services - Cloudera Data Platform (CDP) for Public and Private Cloud data and compute services

cloudera.services is an Ansible collection that lets you use and manage your Cloudera Data Platform (CDP) Public and Private Cloud execution services and resources for both data and compute. With this collection, you can:

• Execute your Cloudera Machine Learning (CML) projects and resources, including:
  • Run jobs
  • Build and deploy models
  • Install and run Accelerators for ML Projects (AMPs)
  • Construct DataViz applications
• Manage and control Cloudera Stream Processing (CSP) assets, including
  • Configure SQL Stream Builder (SSB) catalogs and data sources and run jobs
  • Create and manage Streams Messaging Manager (SSM) Kafka topics
• Manage Apache Ranger authorization assets, including
  • Services, policies, and roles
• Manage Apache Atlas metadata on CDP Private Cloud Base, including
  • Type definitions (enums, structs, classifications, entities, relationships, and business metadata) and queries for existing type definitions
  • Look up entities, such as Hive tables, by GUID or qualified name
  • Add and remove entity labels

and more!

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

1. Install the collection
2. Use the collection

API

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

Installation

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

collections:
  - name: cloudera.services

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

collections:
  - name: https://github.com/cloudera-labs/cloudera.services.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.services

# From GitHub
ansible-galaxy collection install git+https://github.com/cloudera-labs/cloudera.services.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.services.ssb_project_info module to discover details regarding available SQL Stream Builder (SSB) projects:

- hosts: localhost
  connection: local
  gather_facts: no
  tasks:
    - name: List all SSB projects
      cloudera.services.ssb_project_list:
        endpoint: "https://example.cldr.com/ssb_endpoint"

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:render

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.

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.services Ansible collection, head over to CONTRIBUTING.md.

License and Copyright

Copyright 2026, 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

    https://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.