You are looking at the documentation of a prior release. To read the documentation of the latest release, please visit here.

New to KubeDB? Please start here.

Reconfiguring TLS of PerconaXtraDB Database

This guide will give an overview on how KubeDB Enterprise operator reconfigures TLS configuration i.e. add TLS, remove TLS, update issuer/cluster issuer or Certificates and rotate the certificates of a PerconaXtraDB database.

Before You Begin

How Reconfiguring PerconaXtraDB TLS Configuration Process Works

The following diagram shows how KubeDB Enterprise operator reconfigures TLS of a PerconaXtraDB database. Open the image in a new tab to see the enlarged version.

  Reconfiguring TLS process of PerconaXtraDB
Fig: Reconfiguring TLS process of PerconaXtraDB

The Reconfiguring PerconaXtraDB TLS process consists of the following steps:

  1. At first, a user creates a PerconaXtraDB Custom Resource Object (CRO).

  2. KubeDB Community operator watches the PerconaXtraDB CRO.

  3. When the operator finds a PerconaXtraDB CR, it creates required number of StatefulSets and related necessary stuff like secrets, services, etc.

  4. Then, in order to reconfigure the TLS configuration of the PerconaXtraDB database the user creates a PerconaXtraDBOpsRequest CR with desired information.

  5. KubeDB Enterprise operator watches the PerconaXtraDBOpsRequest CR.

  6. When it finds a PerconaXtraDBOpsRequest CR, it pauses the PerconaXtraDB object which is referred from the PerconaXtraDBOpsRequest. So, the KubeDB Community operator doesn’t perform any operations on the PerconaXtraDB object during the reconfiguring TLS process.

  7. Then the KubeDB Enterprise operator will add, remove, update or rotate TLS configuration based on the Ops Request yaml.

  8. Then the KubeDB Enterprise operator will restart all the Pods of the database so that they restart with the new TLS configuration defined in the PerconaXtraDBOpsRequest CR.

  9. After the successful reconfiguring of the PerconaXtraDB TLS, the KubeDB Enterprise operator resumes the PerconaXtraDB object so that the KubeDB Community operator resumes its usual operations.

In the next docs, we are going to show a step by step guide on reconfiguring TLS configuration of a PerconaXtraDB database using PerconaXtraDBOpsRequest CRD.