kubeblocks-configure-tls

Configure TLS and mTLS security for existing KubeBlocks clusters.

3|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/apecloud/kubeblocks-skills --skill kubeblocks-configure-tls
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kubeblocks-configure-tls
Source: https://github.com/apecloud/kubeblocks-skills/tree/main/skills/kubeblocks-configure-tls
Command: npx skills add https://github.com/apecloud/kubeblocks-skills --skill kubeblocks-configure-tls

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Access-security for TLS and mTLS on existing KubeBlocks clusters to enable encrypted database connections and safer cross-service communication without needing cluster recreation.

Core Features & Use Cases

  • Choose TLS mode (Built-in, User-provided, or mTLS) and apply to the cluster.
  • Configure TLS in the Cluster CR and verify TLS connections across engines like MySQL and PostgreSQL.
  • Reference engine and addon capability matrices to validate scope and prevent unsafe configurations.

Quick Start

Initiate the TLS workflow on an existing cluster to enable, verify, or rotate TLS settings.

Frequently Asked Questions about kubeblocks-configure-tls

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enable TLS on an existing KubeBlocks database cluster?

To enable TLS on an existing KubeBlocks cluster, you configure TLS settings directly in the Cluster CR. You can choose built-in TLS using cert-manager or apply user-provided certificates by validating Secrets.

Can I configure mTLS for cross-service communication without recreating my database cluster?

Yes, you can enable mTLS for cross-service communication on existing clusters without recreation. The configuration applies mutual TLS settings to secure database connections safely across services.

Does KubeBlocks support user-provided certificates for database security?

KubeBlocks supports user-provided certificates for database security by validating your existing TLS Secrets. This allows you to migrate from built-in TLS to your own certificate management workflow.

How does cert-manager work with built-in TLS for KubeBlocks clusters?

Cert-manager handles built-in TLS provisioning for KubeBlocks clusters by automatically generating and managing certificates. This integrated approach enables encrypted database connections without needing external certificate setup.

What are the limitations when configuring TLS across different database engines?

TLS configuration limitations depend on engine capability matrices. You must reference these matrices to validate scope and verify TLS connections across engines like MySQL and PostgreSQL to prevent unsafe configurations.

What is the best way to migrate an existing cluster to user-provided TLS certificates?

The best way to migrate to user-provided TLS certificates is to update the Cluster CR with your validated Secrets. This workflow ensures continuous database security by transitioning from built-in TLS to custom certificates.