Prerequisites for Installing Confluent Platform with Ansible Playbooks

General requirements

The following table summarizes version compatibility among Ansible Playbooks for Confluent Platform (Confluent Ansible) and other required components.

The Default Confluent Platform column specifies the default Confluent Platform version that the particular version of Confluent Ansible installs.

Default Confluent Platform Confluent Ansible Ansible and Python Versions
7.9.2 7.9.2 [1]
  • Ansible 9.x [ansible-core 2.16] & Python 3.10 - 3.12
  • Ansible 8.x [ansible-core 2.15] & Python 3.9 - 3.11
  • Ansible 7.x [ansible-core 2.14] & Python 3.9 - 3.11
7.9.1 7.9.1 [1]
  • Ansible 9.x [ansible-core 2.16] & Python 3.10 - 3.12
  • Ansible 8.x [ansible-core 2.15] & Python 3.9 - 3.11
  • Ansible 7.x [ansible-core 2.14] & Python 3.9 - 3.11
7.9.0 7.9.0
  • Ansible 9.x [ansible-core 2.16] & Python 3.10 - 3.12
  • Ansible 8.x [ansible-core 2.15] & Python 3.9 - 3.11
  • Ansible 7.x [ansible-core 2.14] & Python 3.9 - 3.11
7.8.2 7.8.2 [2]
  • Ansible 9.x [ansible-core 2.16] & Python 3.10 - 3.12
  • Ansible 8.x [ansible-core 2.15] & Python 3.9 - 3.11
  • Ansible 7.x [ansible-core 2.14] & Python 3.9 - 3.11
7.8.0 7.8.0
  • Ansible 9.x [ansible-core 2.16] & Python 3.10 - 3.12
  • Ansible 8.x [ansible-core 2.15] & Python 3.9 - 3.11
  • Ansible 7.x [ansible-core 2.14] & Python 3.9 - 3.11
7.7.3 7.7.3
  • Ansible 9.x [ansible-core 2.16] & Python 3.10 - 3.12
  • Ansible 8.x [ansible-core 2.15] & Python 3.9 - 3.11
  • Ansible 7.x [ansible-core 2.14] & Python 3.9 - 3.11
7.7.2 7.7.2
  • Ansible 9.x [ansible-core 2.16] & Python 3.10 - 3.12
  • Ansible 8.x [ansible-core 2.15] & Python 3.9 - 3.11
  • Ansible 7.x [ansible-core 2.14] & Python 3.9 - 3.11
7.7.1 7.7.1 [3]
  • Ansible 9.x [ansible-core 2.16] & Python 3.10 - 3.12
  • Ansible 8.x [ansible-core 2.15] & Python 3.9 - 3.11
  • Ansible 7.x [ansible-core 2.14] & Python 3.9 - 3.11
7.7.0 7.7.0 [3]
  • Ansible 9.x [ansible-core 2.16] & Python 3.10 - 3.12
  • Ansible 8.x [ansible-core 2.15] & Python 3.9 - 3.11
  • Ansible 7.x [ansible-core 2.14] & Python 3.9 - 3.11
7.6.6 7.6.6
  • Ansible 9.x [ansible-core 2.16] & Python 3.10 - 3.12
  • Ansible 8.x [ansible-core 2.15] & Python 3.9 - 3.11
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.6.5 7.6.5
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.6.4 7.6.4
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.6.3 7.6.3
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.6.2 7.6.2
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.6.1 7.6.1
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.6.0 7.6.0
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.5.9 7.5.9
  • Ansible 9.x [ansible-core 2.16] & Python 3.10 - 3.12
  • Ansible 8.x [ansible-core 2.15] & Python 3.9 - 3.11
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.5.8 7.5.8
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.5.7 7.5.7
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.5.6 7.5.6
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.5.5 7.5.5
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.5.4 7.5.4
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.5.3 7.5.3
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.5.2 7.5.2
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.5.1 7.5.1
  • Ansible 7.x [ansible-core 2.14] & Python 3.6-3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.5.0 7.5.0
  • Ansible 7.x [ansible-core 2.14] & Python 3.6-3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.4.10 7.4.10
  • Ansible 9.x [ansible-core 2.16] & Python 3.10 - 3.12
  • Ansible 8.x [ansible-core 2.15] & Python 3.9 - 3.11
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.4.9 7.4.9
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.4.8 7.4.8
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.4.7 7.4.7
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.4.6 7.4.6
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.4.5 7.4.5
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.4.4 7.4.4
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.4.3 7.4.3
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.4.2 7.4.2
  • Ansible 7.x [ansible-core 2.14] & Python 3.6-3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.4.1 7.4.1
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.4.0 7.4.0
  • Ansible 7.x [ansible-core 2.14] & Python 3.6 - 3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.3.12 7.3.13
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.3.11 7.3.12
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.3.10 7.3.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.3.9 7.3.10
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.3.8 7.3.9
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.3.7 7.3.8
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.3.6 7.3.7
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.3.5 7.3.6
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.3.4 7.3.5
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.3.3 7.3.4
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.3.2 7.3.3
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.3.1 7.3.2
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.3.0 7.3.1
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.2.14 7.2.14
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.2.13 7.2.13
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.2.12 7.2.12
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.2.11 7.2.11
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.2.10 7.2.10
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.2.9 7.2.9
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.2.8 7.2.8
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.2.7 7.2.7
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.2.6 7.2.6
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.2.5 7.2.5
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.2.4 7.2.4
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.2.3 7.2.3
  • Ansible 6.x [ansible-core 2.13] & Python 3.6 - 3.10
  • Ansible 5.x [ansible-core 2.12] & Python 3.6 - 3.10
  • Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.2.2 7.2.2 Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.2.1 7.2.1 Ansible 4.x [ansible-core 2.11] & Python 3.6 - 3.9
7.2.0 7.2.0 Ansible 4.x [ansible-core 2.11] &Python 3.6 - 3.9

[1] Confluent Ansible supports the same versions of Confluent Control Center as corresponding Confluent Platform versions support.

[2] Confluent Ansible does not have the 7.8.1 release.

[3] When running Confluent Ansible 7.7.x, you may see the following warning message:

[WARNING]: Collection confluent.platform does not support Ansible version 2.15

The minimum supported version of Ansible was updated in Confluent Ansible, and you can ignore this warning message.

The prerequisites for installing and using Confluent Ansible 7.9 are:

  • Ansible package 7.x+

    We recommend installing the Ansible package instead of Ansible Core (ansible-core). Ansible Core contains a minimal number of modules and plugins, and you might have to manually install additional modules and plugin that Confluent Ansible requires.

    For details on selecting an Ansible package and version to install, see Installing Ansible — Ansible Community Documentation.

  • SSH access between Ansible control nodes and Confluent Platform hosts

    For the steps and the command to verify the SSH connections for all the hosts involved, see Prepare Ansible Inventory File to Install Confluent Platform.

  • sudo access for SSH user to all Confluent Platform hosts

    Starting in 7.1.0, Ansible Playbooks for Confluent Platform supports tag-based separation of tasks that require root permission from tasks that do not require root permission. You can run the latter tasks without root privileges. However, there are certain steps where you do need root access. For details, see Install Confluent Platform without root access.

  • (Optional) Internet connectivity to pull Confluent Platform software from packages.confluent.io. If you don’t have internet access, refer to Deploy Confluent Platform in Air-Gapped Environment Using Ansible Playbooks for deploying in an air-gapped environment.

  • For detailed version requirements for the controller node, the managed node, and Python, see Ansible Support Matrix.

Supported Confluent Platform versions

It is highly recommended that you use the version of Confluent Ansible as referred in the above table in accordance with the Confluent Platform version.

Hardware

Starting in the 7.6.0 release, Confluent Ansible supports the X86 and ARM64 hardware architecture for the production workloads.

For more information about hardware support, see the on-premises system requirements for Confluent Platform components.

Operating systems

Confluent Ansible supports the operating systems listed in the Confluent Platform System Requirements, except for those marked as deprecated.

Network

Internet protocols

You can use Confluent Ansible to deploy Confluent Platform on machines on an IPv6 network, an IPv4 network, or dual-stack with both IPv4 and IPv6.

IPv6 or dual stack support is subject to the following constraints:

  • It can be enabled only on clusters using Java 11 or above.
  • It can be enabled only on clusters using KRaft.

Ports

Refer to the ports used by Confluent Platform components.

Users

Each Confluent Platform component runs under its own user set up during installation. The usernames are prefixed with cp- followed by the component name. For example, cp-kafka and cp-schema-registry.

The one exception is that ZooKeeper and KRaft run as the cp-kafka user.

Time synchronization

Clock synchronization on each Kafka broker is required to ensure the full system functions correctly. See Time synchronization requirement for details.

Locale

The en_US.UTF-8 locale is required for installing Confluent Platform using Confluent Ansible.