kubeblocks-engine-kafka

Provision Kafka on KubeBlocks with deterministic topology, version, storage, and sizing.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Primary create-time entry for Kafka on KubeBlocks, enabling users to provision Kafka with the correct topology, version, storage, sizing, connection details, and next-hop guidance. Run kubeblocks-preflight first when environment readiness is unknown. The legacy kubeblocks-addon-kafka skill remains only as a compatibility shim.

Core Features & Use Cases

  • Deterministic topology selection: default to combined or separated layouts based on controller and broker needs.
  • Version and storage guidance: select stable serviceVersion and PVC sizing per workload.
  • Preflight and next-hop routing: verify environment readiness and guide transitions to capability layers or troubleshooting.
  • Compatibility bridge: preserves legacy addon-kafka path for backward compatibility.

Quick Start

Start with kubeblocks-preflight to profile the environment, then draft and apply the Kafka cluster manifest using the recommended topology and version strategy.

Frequently Asked Questions about kubeblocks-engine-kafka

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

FAQPage Schema
How do I provision a Kafka cluster on KubeBlocks with the correct topology?

To provision Kafka on KubeBlocks, the engine enforces deterministic topology defaults, selecting combined or separated layouts based on your controller and broker needs. It guides version strategy, storage, and PVC sizing during cluster creation.

What is the best way to configure Kafka storage and PVC sizing for KubeBlocks provisioning?

Configuring Kafka storage and PVC sizing requires selecting stable serviceVersion and PVC allocations per workload. The engine provides deterministic guidance for these storage requirements during the create-time workflow.

Do I need to run preflight checks before provisioning Kafka on KubeBlocks?

Yes, you need preflight checks when environment readiness is unknown. Run kubeblocks-preflight first to profile the environment, then apply the Kafka cluster manifest using the recommended topology and version strategy.

How does KubeBlocks handle Kafka version selection during cluster creation?

KubeBlocks handles Kafka version selection by enforcing a version strategy that selects a stable serviceVersion tailored to your workload. This ensures deterministic provisioning outcomes during the create-time workflow.

Can I use the legacy kubeblocks-addon-kafka skill instead of this engine?

You can use the legacy kubeblocks-addon-kafka skill as it remains only as a compatibility shim for backward compatibility. However, this engine serves as the primary create-time entry for deterministic Kafka provisioning.

What happens after Kafka provisioning if I need troubleshooting or capability configuration?

After Kafka provisioning, the engine provides defined next-hop routing to guide transitions to capability layers or troubleshooting. This ensures you can proceed to configure or debug your cluster deterministically.