Cloudera Docs

Installing Strimzi on Taikun CloudWorks [Technical Preview]

Learn how to install Strimzi in Cloudera Streams Messaging - Kubernetes Operator on Taikun CloudWorks. Installation involves importing the Cloudera Kafka Operator repository, adding Strimzi to a new or existing catalog, and installing Strimzi using the Taikun CloudWorks UI.

  • You have access to a project and Kubernetes cluster in Taikun CloudWorks.

  • Your Kubernetes environment meets requirements listed in System requirements.

  • The worker nodes in your cluster meet the minimum sizing requirements listed in Sizing and performance considerations.

  • Access to your cluster with kubectl is configured. For more information, see Accessing Cluster with Kubeconfig.

  • Your Kubernetes cluster requires internet connectivity to complete these steps. It must be able to reach the Cloudera Docker registry.

  • You have access to your Cloudera credentials (username and password). Credentials are required to access the Cloudera Archive and Cloudera Docker registry where installation artifacts are hosted.

  • You have access to a valid Cloudera license.

  • Review the Helm chart reference before installation.

    The Helm chart accepts various configuration properties that you can set during installation. Using these properties you can customize your installation.

  • If you are planning to watch and manage more than 20 Kafka clusters with a single installation, you must increase the memory and heap allocated to the Strimzi Cluster Operator. For more information, see Increasing Cluster Operator memory.

Importing the Cloudera Kafka Operator repository and adding Strimzi to a catalog

Complete these steps to import the Cloudera Kafka Operator repository and to add Strimzi to a new or existing catalog in Taikun CloudWorks.

  1. Import the Cloudera Kafka Operator repository.
    1. In Taikun CloudWorks, go to Repositories and select the Private tab.
    2. Click Import Repository.
    3. Enter the following in Import Repository:

      • Enter a unique name in Name.

      • Enter the following OCI repository URL in URL:

        oci://container.repository.cloudera.com/cloudera-helm/csm-operator/strimzi-kafka-operator

      • Enter your Cloudera credentials in Username and Password.

    4. Click Import.
  2. Add Strimzi to a catalog.
    1. Go to Catalogs and click Add Catalog.
    2. Enter a catalog name and description in Create Catalog.
    3. Click Save.
    4. Go to [***YOUR CATALOG***] and click Add Applications.
    5. Select [***YOUR REPOSITORY***] from the Repository drop-down list and click Apply.
    6. Find the strimzi-kafka-operator application in the list of available applications and click .
    7. Click Add to the catalog.
  3. Add catalog app parameters.
    1. Click Add Parameters.
    2. Find and add the following parameters:
      • watchAnyNamespaces
      • clouderaLicense.secretRef
    3. Set the following default values for the parameters you added:
      • watchAnyNamespaces=true
      • clouderaLicense.secretRef=csm-op-license
    4. Click Save.

Installing Strimzi

Complete these steps to install Strimzi on Taikun CloudWorks.

  1. Create a namespace in your Kubernetes cluster. 
    kubectl create namespace [***NAMESPACE***]

    Use this namespace in all of the following installation steps.

  2. Create a Kubernetes Secret containing your Cloudera license. 
    kubectl create secret generic csm-op-license \
  --namespace [***NAMESPACE***] \
  --from-file=license=[***PATH TO LICENSE FILE***]
  3. Create a Kubernetes Secret containing your Cloudera credentials. 
    kubectl create secret docker-registry [***REGISTRY CREDENTIALS SECRET***] \
  --namespace [***NAMESPACE***] \
  --docker-server container.repository.cloudera.com \
  --docker-username [***USERNAME***] \
  --docker-password "$(echo -n 'Enter your Cloudera password: ' >&2; read -s password; echo >&2; echo $password)"

    • Take note of the name you specify as [***REGISTRY CREDENTIALS SECRET***]. You will need to specify the name in a later step.

    • Replace [***USERNAME***] with your Cloudera username.

    • Enter your Cloudera password when prompted.

  4. Install Strimzi.
    1. In Taikun CloudWorks, go to Projects > [***YOUR PROJECT***] > Applications.
    2. Click Install.
    3. Search for strimzi-kafka-operator.
    4. Find the strimzi-kafka-operator application in the list of available applications. Select the one that is in [*** YOUR CATALOG ***] and click .
    5. Click Bind if you get a prompt to bind the catalog to your project.
    6. Configure the following common settings in Application Instance:

      • Enter a name in Application Instance Name.

      • In Namespace, select the namespace you created in Step 1.

      • Enable the Extra Values tab by clicking the Extra Values toggle.

    7. Click Continue.
    8. Configure the following parameters in Installation Params:

      • Set the watchAnyNamespace toggle to enabled.

      • Set clouderaLicense.secretRef to the name of the Secret you created in Step 2.

    9. Click Continue.
    10. Provide the following values in Extra Values: 
      image:
  imagePullSecrets:
    - name: [***REGISTRY CREDENTIALS SECRET***]

      Replace [***REGISTRY CREDENTIALS SECRET***] with the name of the Secret you created in Step 3.

    11. Validate your extra values by clicking Check extra values.
    12. Click Run installation.
  5. Go to Projects > [***YOUR PROJECT***] > LiveOps to verify your installation.
    If installation is successful, a Strimzi Deployment and Pod will be present in the cluster in the installation namespace. These resources use the name you specified in Application Instance Name.
  • Deploy a Kafka cluster, see Deploying Kafka.