Control Plane Installation
This chart installs the TSB control plane operator. Similar to Management Plane Helm chart, it also allows you to install TSB control plane components using TSB
ControlPlane CR and all the required secrets to make it fully run.
Before you start, make sure that you've:
Before you begin, you will need to create a cluster object in TSB to represent the cluster where you will be installing the TSB control plane. Replace
<organization-name> with the appropriate values for your environment:
displayName: "App Cluster"
To create the cluster object, run the following command:
tctl apply -f cluster.yaml
Next, you will need to create a cluster service account that will be used to authenticate the TSB control plane operator with the TSB management plane. Run the following command to create the cluster service account:
tctl install cluster-service-account \
--cluster <cluster-name-in-tsb> \
Next, you will need to create a Helm values file. This file, called
cluster-values.yaml, will contain the configuration for the TSB control plane operator, as well as any secrets required to authenticate with the TSB management plane.
spec field is similar to TSB
ControlPlane CR. You can customize the
spec field to meet the needs of your environment. For simplicity you will include secrets also, but you can create secrets in separate steps or use separate values file to store secrets. If you are using a self-signed certificate for the TSB management plane, you will need to include the certificate authority (CA) in the secrets section of the
You can find more details on the available Helm configuration in the configuration section below.
To complete the
cluster-values.yaml file, you will need to include the cluster service account JWK that you created earlier. Replace
$JWK with the contents of the
cluster-service-account.jwk file. You can use the
envsubst command to substitute the
$JWK placeholder with the actual contents of the
export JWK=$(cat cluster-service-account.jwk)
envsubst < cluster-values.yaml > cluster-values-with-jwk.yaml
Once you have created the
cluster-values-with-jwk.yaml file, you are ready to install the TSB control plane using Helm. Run the following command to install the TSB control plane in the
helm install cp tetrate-tsb-helm/controlplane \
--namespace istio-system \
--set image.registry=<registry-location> \
--set image.tag=<tsb-version> \
--set spec.hub=<registry-location> \
Wait for the TSB control plane components to be deployed successfully. To verify that the installation was successful, you can try logging in to the TSB UI or connecting to TSB using tctl and checking the list of clusters to see if the cluster has been onboarded.
If you encounter any issues during the installation process, here are a few tips for troubleshooting:
- Make sure that you have followed all of the steps in the correct order.
- Double-check the configuration values in the
cluster-values-with-jwk.yamlfile to ensure that they are correct.
- Check the logs of the TSB control plane operator to see if there are any error messages or stack traces that can help diagnose the problem.
- If you are using a self-signed certificate for the TSB management plane, make sure that the certificate authority (CA) is included in the
secretssection of the
- If you are using a private registry to host the TSB control plane operator image, make sure that you have authenticated with the registry and that the
spec.hubvalues in the
cluster-values.yamlfile are correct.
- Check the cluster onboarding troubleshooting guide.
This is a required field. Set
registry to your private registry where you have synced TSB images into and
tag to TSB version that you want to deploy. Specifying only this field will install TSB control plane operator without installing other TSB components.
|Registry used to download the operator image|
|The tag of the operator image||same as the Chart version|
Control Plane resource configuration
This is an optional field. You can set TSB
in Helm values file to make the TSB control plane fully run.
|Holds the |
This is an optional field. You can apply secrets into your cluster before installing TSB control plane or you can use Helm values to specify required secrets. Note that you can use different Helm values file if you want to separate secrets from control plane spec.
Keep in mind that these options just help with creating secrets, and they must respect the configuration provided
in the TSB
ManagementPlane CR, otherwise the installation will end up misconfigured.
|Enabling this makes the generated secrets persist in the cluster after uninstalling the chart if they are no provided in future updates. (see Helm doc)|
|CA certificate used to verify TLS certs exposed the Management Plane (front envoy)|
|The username to access Elasticsearch|
|The password to access Elasticsearch|
|Elasticsearch CA cert TLS used by control plane to verify TLS connection|
|JWT token used to authenticate OAP against the Management Plane|
|JWT token used to authenticate OTel Collector against the Management Plane|
|TSB FQN of the onboarded cluster resource. This will be generate tokens for all control plane agents.|
|JWK used to generate and sign the tokens for all the control plane agents.|
XCP secrets configuration
XCP has two authentication configuration modes:
JWT (default) and
mTLS. Depending on the authentication mode, the provided certificates will be used for different purpose.
JWT mode, if the XCP root CA (
secrets.xcp.rootca) is provided it will be used to verify the TLS certs provided by
secrets.clusterServiceAccount will be required to authenticate against XCP Central.
MUTUAL TLS mode
MUTUAL_TLS mode, XCP Edge requires certificates with a SPIFFE ID to authenticate against the XCP Central.
secrets.xcp.autoGenerateCerts is disabled, the XCP Edge cert is expected to be provided by the user using
Then, if XCP Root CA is provided, it will be used to verify TLS certs provided by XCP Central.
secrets.xcp.autoGenerateCerts is enabled, Cert Manager is required to provide the certs to XCP Edge.
If the control plane is installed in the same cluster the Management Plane runs on, no other cert info is required, because the same Cert Manager issuers will be used to create the XCP Edge cert.
Otherwise, when the control plane is not able to use the same Management Plane issuers, the XCP Root CA and its
secrets.xcp.rootcakey) are required to create a Cert Manager issuer to provide the cert
to the Edge.
The following are the configuration properties allowed to be used to configure XCP authentication mode:
|Enabling this will auto generate XCP Edge certificate if mTLS is enabled to authenticate to XCP Central. Requires cert-manager|
|CA certificate of XCP components|
|Key of the CA certificate of XCP components|
|Edge certificate used for mTLS with XCP Central|
|Key of the Edge certificate used for mTLS with XCP Central|
|JWT token used to authenticate XCP Edge against the XCP Central|
|Indicates the XCP authentication mode configured in order to generate the proper required secrets. Accepted values: |
Operator extended configuration
This is an optional field. You can customize TSB operator related resources like the deployment, the service or the service account using the following optional properties:
|Affinity configuration for the pod|
|Custom collection of annotations to add to the deployment|
|Custom collection of environment vars to add to the container|
|Custom collection of annotations to add to the pod|
|Number of replicas managed by the deployment|
|Deployment strategy to use|
|Toleration collection applying to the pod scheduling|
|SecurityContext properties to apply to the pod|
|SecurityContext properties to apply to the pod's containers|
|Custom collection of annotations to add to the service|
|Custom collection of annotations to add to the service account|
|Collection of secrets names required to be able to pull images from the registry|
|A JSON encoded Docker configuration that will be stored as an image pull secret|