Kubernetes Cluster Installation

For a customer-controlled environment, you (the customer) are responsible for installing the Kubernetes cluster and to ensure that the configuration of the Kubernetes cluster meets the requirements before meeting with Solace. To help you identify the many considerations when planning your Kubernetes cluster, we recommend that you review the questionnaire for customer-controlled deployments.

The following is an overview of the steps to install your Kubernetes cluster.

1. Check to see if the Kubernetes distribution or cloud provider you plan to use is supported for the latest broker version. For more information see Supported Kubernetes Versions.

2. Ensure that your Kubernetes cluster fulfills the prerequisites which are required to install PubSub+ Cloud. Solace recommends that you use these best practices:

   • Configure the resources required for your Kubernetes cluster.

   • If you are using one of the following cloud providers, you must use the resources defined as documented:

     • Installing PubSub+ Cloud in Azure Kubernetes Service (AKS)

     • Installing PubSub+ Cloud in Amazon Elastic Kubernetes Service (EKS)

     • Installing PubSub+ Cloud in AWS Outposts

     • Installing PubSub+ Cloud in Google Kubernetes Engine (GKE)

     • Installing PubSub+ Cloud in Alibaba Cloud Container Service for Kubernetes (ACK)

   • Use best practices to configure the Kubernetes cluster to optimally operate PubSub+ Cloud. Solace recommends that you use these best practices when possible:

     • Use multiple zones as this ensures reliability for High-Availability event broker services and a loadbalancer as described in Availability Zones and Deployment Architecture for Kubernetes

     • Schedule workloads to appropriately-scaled-Node Pool using nodeSelector and the recommended labels/taints. For more information, see Schedule Workload to Appropriately-Scaled Node Pool and Using nodeSelector

     • We also support tolerations. For more information, see Support for nodeSelector, Labels, Taints, and Tolerations.

   You can contact us to get access to reference terraforms to deploy a Kubernetes cluster. These terraforms have the recommended configuration settings, such as worker node sizes, resource configurations, taints, and labels optimized to install PubSub+ Cloud.You can use the reference examples as-is or modify them to meet your requirements.
   
   Beware that all sample scripts, Terraform modules, and examples available from Solace are provided as-is. You (the customer) can modify the files as required and you are responsible to maintain and modify the files for your Kubernetes cluster.

After following these steps, your Kubernetes cluster is ready to set up the Kubernetes connectivity so that you can deploy PubSub+ Cloud.