Deploying TIBCO Control Plane in a Kubernetes Cluster
TIBCO Control Plane is deployed in a Kubernetes cluster by using the Helm package manager for Kubernetes. You need to install Helm charts for TIBCO Control Plane and its components in your Kubernetes cluster.
- If you have not already set up Kubernetes cluster infrastructure required for TIBCO Control Plane deployment, see Setting up Kubernetes Cluster on Amazon EKS.
- If you have an existing Kubernetes cluster, See Preparing a Kubernetes Cluster for TIBCO Control Plane Deployment.
- Ensure that Helm is installed and configured.
- Ensure that kubectl is installed.
To deploy TIBCO Control Plane in your Kubernetes cluster, you must perform the following steps:
Step 2: Add the Helm Chart Repository
Step 3: Create a Namespace for TIBCO Control Plane
Step 4: Configure TIBCO Control Plane Helm Chart Values
Step 5: Install platform-bootstrap chart
Step 6: Install platform-base chart
Step 7: Provision Subscription from TIBCO Platform Console
Step 8: Sign in to TIBCO Control Plane
Step 1: Get the JFrog Token
The Account owner must get the Jfrog token which is required to access the Docker images from the TIBCO JFrog repository. The account owner receives an activation email that contains the link to sign in to TIBCO Operated Control Plane environment. The account owner must click the link in the email to accept invite and sign in. After signing in to TIBCO Control Plane, perform the following steps to get the token:
- Procedure
- In TIBCO Operated Control Plane, click Settings menu.
- On the Account details page, in the Container Registry Credentials section, you can see Registry URL, Username, and Password. Copy all the three values.
- Copy the Customer ID from the Account Details section.
You must specify Registry URL, Username, and Password values in the platform-bootstrap chart values file. You must specify Customer ID in the platform-base chart. For more information about configuring Helm chart values, see Configuring TIBCO Control Plane Helm Chart Values.
Step 2: Add the Helm Chart Repository
The Helm charts required to install TIBCO Control Plane are available in the GitHub repository. To add this repository in your local path, run the following command:
helm repo add tibco-platform https://tibcosoftware.github.io/tp-helm-charts
Step 3: Create a Namespace for TIBCO Control Plane
Create a namespace where TIBCO Control Plane charts are installed. The namespace used must have the platform.tibco.com/controlplane-instance-id label along with the controlPlaneInstanceId value.
kubectl label namespace <namespace-name> platform.tibco.com/controlplane-instance-id=<controlPlaneInstanceId>Here controlPlaneInstanceId is the unique identifier (Example: prod, stag) that you specify in the platform-bootstrap chart values. The controlPlaneInstanceId must be lowercase alphanumeric string of maximum 5 characters.
Specify this namespace created when installing the platform-bootstrap and platform-base charts.
Step 4: Configure TIBCO Control Plane Helm Chart Values
Before installing charts required to deploy TIBCO Control Plane, you must configure values used by these charts as per your environment. For more information, see Configuring TIBCO Control Plane Helm Chart Values.
Step 5: Install platform-bootstrap chart
The platform-bootstrap chart contains common configurations for all TIBCO Control Plane components.
To install platform-bootstrap chart, run the following command:
helm upgrade --install -n <namespace> platform-bootstrap tibco-platform/platform-bootstrap -f values.yaml --version=<Helm_Chart_Version>
To install a specific chart version, use the --version flag. For more information about which chart version to install, see Helm Chart Version Matrix.
Step 6: Install platform-base chart
The platform-base chart installs all the required subcharts for TIBCO Control Plane components.
To install the platform-base chart, run the following command:
helm upgrade --install -n <namespace> platform-base tibco-platform/platform-base -f values.yaml --version=<Helm_Chart_Version>
To install a specific chart version, use the --version flag. For more information about which chart version to install, see Helm Chart Version Matrix.
After the chart is installed, you must sign in to TIBCO Platform Console and provision subscription.
(Optional) To install TIBCO® Platform Add-on for Event Processing, run the following command. The platform-addon-eventprocessing chart installs all charts required for TIBCO BusinessEvents product.
helm upgrade --install -n <namespace> platform-addon-eventprocessing tibco-platform/platform-addon-eventprocessing -f values.yaml --version=<Helm_Chart_Version>Step 7: Provision Subscription from TIBCO Platform Console
After the platform-base chart is installed, Administrator receives an email with the link to set password and sign in to TIBCO Platform Console with default IdP. TIBCO Platform Console is web UI to provision and manage subscription for TIBCO Control Plane. Administrator must sign in to TIBCO Platform Console and provision subscription. For more information about provisioning subscription in TIBCO Platform Console, see Provisioning a Subscription.
Step 8: Sign in to TIBCO Control Plane
After Administrator has provisioned subscription, the owner receives an email with the link to sign in to TIBCO Control Plane. For more information, see Signing in to TIBCO Control Plane.