Install Confluent Platform with Ansible Playbooks

This topic describes the installation steps for Confluent Platform:

Use Ansible 2.11 or higher to install Confluent Platform

After you configure the hosts.yml file, to install or update all Confluent Platform components, run:

ansible-playbook -i hosts.yml confluent.platform.all

Install individual Confluent Platform components

Install individual components, using the Ansible tags. You must follow the correct order given below to satisfy the dependencies among the components. For example, Kafka will not install until the certificate authority is generated and ZooKeeper is installed.

Similarly, when you update a component section in the hosts.yml file, you can optionally update the component and the preceding components in the order.

  1. Generate the certificate authority (CA) if TLS encryption is enabled and using self-signed certificates.

    ansible-playbook -i hosts.yml confluent.platform.all --tags=certificate_authority
    
  2. Generate secrets protection masterkey if secrets protection enabled.

    ansible-playbook -i hosts.yml confluent.platform.all --tags=masterkey
    
  3. Install ZooKeeper.

    ansible-playbook -i hosts.yml confluent.platform.all --tags=zookeeper
    
  4. Install Kafka.

    ansible-playbook -i hosts.yml confluent.platform.all --tags=kafka_broker
    
  5. Install Schema Registry, REST Proxy, Connect, and ksqlDB in any order.

    ansible-playbook -i hosts.yml confluent.platform.all --tags=schema_registry
    ansible-playbook -i hosts.yml confluent.platform.all --tags=kafka_rest
    ansible-playbook -i hosts.yml confluent.platform.all --tags=kafka_connect
    ansible-playbook -i hosts.yml confluent.platform.all --tags=ksql
    
  6. Install Control Center.

    ansible-playbook -i hosts.yml confluent.platform.all --tags=control_center
    

Use Ansible 2.9 or 2.10 to install Confluent Platform

When using Ansible 2.9 or 2.10, you need to use the 6.2 branch of the CP-Ansible GitHub repo to install Confluent Platform 7.0.1.

  1. Checkout the CP-Ansible 6.2.1-post branch, following steps in Download Ansible Playbooks for Confluent Platform for Ansible 2.9 or 2.10 hosts.

  2. In the hosts.yml file, specify the Confluent Platform package version to install, for example, 7.0.1:

    all:
      vars:
        confluent_package_version: 7.0.1
    
  3. Configure other required settings in the hosts.yml file as described in Configure Ansible Playbooks for Confluent Platform.

  4. Install or update all Confluent Platform components by running the all.yml playbook:

    ansible-playbook -i hosts.yml all.yml
    

Install individual Confluent Platform components

Install individual components, using the Ansible tags. You must follow the correct order given below to satisfy the dependencies among the components. For example, Kafka will not install until the certificate authority is generated and ZooKeeper is installed.

Similarly, when you update a component section in the hosts.yml file, you can optionally update the component and the preceding components in the order.

  1. Generate the certificate authority (CA) if TLS encryption is enabled and using self-signed certificates.

    ansible-playbook -i hosts.yml all.yml --tags=certificate_authority
    
  2. Generate secrets protection masterkey if secrets protection enabled.

    ansible-playbook -i hosts.yml all.yml --tags=masterkey
    
  3. Install ZooKeeper.

    ansible-playbook -i hosts.yml all.yml --tags=zookeeper
    
  4. Install Kafka.

    ansible-playbook -i hosts.yml all.yml --tags=kafka_broker
    
  5. Install Schema Registry, REST Proxy, Connect, and ksqlDB in any order.

    ansible-playbook -i hosts.yml all.yml --tags=schema_registry
    ansible-playbook -i hosts.yml all.yml --tags=kafka_rest
    ansible-playbook -i hosts.yml all.yml --tags=kafka_connect
    ansible-playbook -i hosts.yml all.yml --tags=ksql
    
  6. Install Control Center.

    ansible-playbook -i hosts.yml all.yml --tags=control_center