KubeBlocks
Blogs
⌘K
​
kbcli
kbcli addon
kbcli addon describe
kbcli addon disable
kbcli addon enable
kbcli addon index
kbcli addon index add
kbcli addon index delete
kbcli addon index list
kbcli addon index update
kbcli addon install
kbcli addon list
kbcli addon purge
kbcli addon search
kbcli addon uninstall
kbcli addon upgrade
kbcli backuprepo
kbcli backuprepo create
kbcli backuprepo delete
kbcli backuprepo describe
kbcli backuprepo list-storage-provider
kbcli backuprepo list
kbcli backuprepo update
kbcli cluster
kbcli cluster backup
kbcli cluster cancel-ops
kbcli cluster configure
kbcli cluster connect
kbcli cluster create
kbcli cluster create apecloud-mysql
kbcli cluster create etcd
kbcli cluster create kafka
kbcli cluster create mongodb
kbcli cluster create mysql
kbcli cluster create postgresql
kbcli cluster create qdrant
kbcli cluster create rabbitmq
kbcli cluster create redis
kbcli cluster custom-ops
kbcli cluster custom-ops kafka-quota
kbcli cluster custom-ops kafka-topic
kbcli cluster custom-ops kafka-user-acl
kbcli cluster custom-ops pg-update-standby-config
kbcli cluster custom-ops redis-cluster-rebalance
kbcli cluster custom-ops redis-master-account-ops
kbcli cluster custom-ops redis-reset-master
kbcli cluster custom-ops redis-sentinel-account-ops
kbcli cluster custom-ops redis-shard-account-ops
kbcli cluster delete-backup
kbcli cluster delete-ops
kbcli cluster delete
kbcli cluster describe-backup-policy
kbcli cluster describe-backup
kbcli cluster describe-config
kbcli cluster describe-ops
kbcli cluster describe-restore
kbcli cluster describe
kbcli cluster edit-backup-policy
kbcli cluster edit-config
kbcli cluster explain-config
kbcli cluster expose
kbcli cluster label
kbcli cluster list-backup-policies
kbcli cluster list-backups
kbcli cluster list-components
kbcli cluster list-events
kbcli cluster list-instances
kbcli cluster list-logs
kbcli cluster list-ops
kbcli cluster list-restores
kbcli cluster list
kbcli cluster logs
kbcli cluster promote
kbcli cluster rebuild-instance
kbcli cluster register
kbcli cluster restart
kbcli cluster restore
kbcli cluster scale-in
kbcli cluster scale-out
kbcli cluster start
kbcli cluster stop
kbcli cluster update
kbcli cluster upgrade-to-v1
kbcli cluster upgrade
kbcli cluster volume-expand
kbcli cluster vscale
kbcli clusterdefinition
kbcli clusterdefinition describe
kbcli clusterdefinition list
kbcli componentdefinition
kbcli componentdefinition describe
kbcli componentdefinition list
kbcli componentversion
kbcli componentversion describe
kbcli componentversion list
kbcli dataprotection
kbcli dataprotection backup
kbcli dataprotection delete-backup
kbcli dataprotection describe-backup-policy
kbcli dataprotection describe-backup
kbcli dataprotection describe-restore
kbcli dataprotection edit-backup-policy
kbcli dataprotection list-action-sets
kbcli dataprotection list-backup-policies
kbcli dataprotection list-backup-policy-templates
kbcli dataprotection list-backups
kbcli dataprotection list-restores
kbcli dataprotection restore
kbcli kubeblocks
kbcli kubeblocks compare
kbcli kubeblocks config
kbcli kubeblocks describe-config
kbcli kubeblocks install
kbcli kubeblocks list-versions
kbcli kubeblocks preflight
kbcli kubeblocks status
kbcli kubeblocks uninstall
kbcli kubeblocks upgrade
kbcli ops-definition
kbcli ops-definition describe
kbcli ops-definition list
kbcli options
kbcli playground
kbcli playground destroy
kbcli playground init
kbcli plugin
kbcli plugin describe
kbcli plugin index
kbcli plugin index add
kbcli plugin index delete
kbcli plugin index list
kbcli plugin index update
kbcli plugin install
kbcli plugin list
kbcli plugin search
kbcli plugin uninstall
kbcli plugin upgrade
kbcli report
kbcli report cluster
kbcli report kubeblocks
kbcli trace
kbcli trace create
kbcli trace delete
kbcli trace list
kbcli trace update
kbcli trace watch
kbcli version
KubeBlocks CLI Overview
  1. addon
  2. backuprepo
  3. cluster
  4. clusterdefinition
  5. componentdefinition
  6. componentversion
  7. dataprotection
  8. kubeblocks
  9. ops-definition
  10. options
  11. playground
  12. plugin
  13. report
  14. trace
  15. version

addon

Addon command.

  • kbcli addon describe - Describe an addon specification.
  • kbcli addon disable - Disable an addon.
  • kbcli addon enable - Enable an addon.
  • kbcli addon index - Manage custom addon indexes
  • kbcli addon install - Install KubeBlocks addon
  • kbcli addon list - List addons.
  • kbcli addon purge - Purge the sub-resources of specified addon and versions
  • kbcli addon search - Search the addon from index
  • kbcli addon uninstall - Uninstall an existed addon
  • kbcli addon upgrade - Upgrade an existed addon to latest version or a specified version

backuprepo

BackupRepo command.

  • kbcli backuprepo create - Create a backup repository
  • kbcli backuprepo delete - Delete a backup repository.
  • kbcli backuprepo describe - Describe a backup repository.
  • kbcli backuprepo list - List Backup Repositories.
  • kbcli backuprepo list-storage-provider - List storage providers.
  • kbcli backuprepo update - Update a backup repository.

cluster

Cluster command.

  • kbcli cluster backup - Create a backup for the cluster.
  • kbcli cluster cancel-ops - Cancel the pending/creating/running OpsRequest which type is vscale or hscale.
  • kbcli cluster configure - Configure parameters with the specified components in the cluster.
  • kbcli cluster connect - Connect to a cluster or instance.
  • kbcli cluster create - Create a cluster.
  • kbcli cluster custom-ops -
  • kbcli cluster delete - Delete clusters.
  • kbcli cluster delete-backup - Delete a backup.
  • kbcli cluster delete-ops - Delete an OpsRequest.
  • kbcli cluster describe - Show details of a specific cluster.
  • kbcli cluster describe-backup - Describe a backup.
  • kbcli cluster describe-backup-policy - Describe backup policy
  • kbcli cluster describe-config - Show details of a specific reconfiguring.
  • kbcli cluster describe-ops - Show details of a specific OpsRequest.
  • kbcli cluster describe-restore - Describe a restore
  • kbcli cluster edit-backup-policy - Edit backup policy
  • kbcli cluster edit-config - Edit the config file of the component.
  • kbcli cluster explain-config - List the constraint for supported configuration params.
  • kbcli cluster expose - Expose a cluster with a new endpoint, the new endpoint can be found by executing 'kbcli cluster describe NAME'.
  • kbcli cluster label - Update the labels on cluster
  • kbcli cluster list - List clusters.
  • kbcli cluster list-backup-policies - List backups policies.
  • kbcli cluster list-backups - List backups.
  • kbcli cluster list-components - List cluster components.
  • kbcli cluster list-events - List cluster events.
  • kbcli cluster list-instances - List cluster instances.
  • kbcli cluster list-logs - List supported log files in cluster.
  • kbcli cluster list-ops - List all opsRequests.
  • kbcli cluster list-restores - List restores.
  • kbcli cluster logs - Access cluster log file.
  • kbcli cluster promote - Promote a non-primary or non-leader instance as the new primary or leader of the cluster
  • kbcli cluster rebuild-instance - Rebuild the specified instances in the cluster.
  • kbcli cluster register - Pull the cluster chart to the local cache and register the type to 'create' sub-command
  • kbcli cluster restart - Restart the specified components in the cluster.
  • kbcli cluster restore - Restore a new cluster from backup.
  • kbcli cluster scale-in - scale in replicas of the specified components in the cluster.
  • kbcli cluster scale-out - scale out replicas of the specified components in the cluster.
  • kbcli cluster start - Start the cluster if cluster is stopped.
  • kbcli cluster stop - Stop the cluster and release all the pods of the cluster.
  • kbcli cluster update - Update the cluster settings, such as enable or disable monitor or log.
  • kbcli cluster upgrade - Upgrade the service version(only support to upgrade minor version).
  • kbcli cluster upgrade-to-v1 - upgrade cluster to v1 api version.
  • kbcli cluster volume-expand - Expand volume with the specified components and volumeClaimTemplates in the cluster.
  • kbcli cluster vscale - Vertically scale the specified components in the cluster.

clusterdefinition

ClusterDefinition command.

  • kbcli clusterdefinition describe - Describe ClusterDefinition.
  • kbcli clusterdefinition list - List ClusterDefinitions.

componentdefinition

ComponentDefinition command.

  • kbcli componentdefinition describe - Describe ComponentDefinition.
  • kbcli componentdefinition list - List ComponentDefinition.

componentversion

ComponentVersions command.

  • kbcli componentversion describe - Describe ComponentVersion.
  • kbcli componentversion list - List ComponentVersion.

dataprotection

Data protection command.

  • kbcli dataprotection backup - Create a backup for the cluster.
  • kbcli dataprotection delete-backup - Delete a backup.
  • kbcli dataprotection describe-backup - Describe a backup
  • kbcli dataprotection describe-backup-policy - Describe a backup policy
  • kbcli dataprotection describe-restore - Describe a restore
  • kbcli dataprotection edit-backup-policy - Edit backup policy
  • kbcli dataprotection list-action-sets - List actionsets
  • kbcli dataprotection list-backup-policies - List backup policies
  • kbcli dataprotection list-backup-policy-templates - List backup policy templates
  • kbcli dataprotection list-backups - List backups.
  • kbcli dataprotection list-restores - List restores.
  • kbcli dataprotection restore - Restore a new cluster from backup

kubeblocks

KubeBlocks operation commands.

  • kbcli kubeblocks compare - List the changes between two different version KubeBlocks.
  • kbcli kubeblocks config - KubeBlocks config.
  • kbcli kubeblocks describe-config - Describe KubeBlocks config.
  • kbcli kubeblocks install - Install KubeBlocks.
  • kbcli kubeblocks list-versions - List KubeBlocks versions.
  • kbcli kubeblocks preflight - Run and retrieve preflight checks for KubeBlocks.
  • kbcli kubeblocks status - Show list of resource KubeBlocks uses or owns.
  • kbcli kubeblocks uninstall - Uninstall KubeBlocks.
  • kbcli kubeblocks upgrade - Upgrade KubeBlocks.

ops-definition

ops-definitions command.

  • kbcli ops-definition describe - Describe OpsDefinition.
  • kbcli ops-definition list - List OpsDefinition.

options

Print the list of flags inherited by all commands.

playground

Bootstrap or destroy a playground KubeBlocks in local host or cloud.

  • kbcli playground destroy - Destroy the playground KubeBlocks and kubernetes cluster.
  • kbcli playground init - Bootstrap a kubernetes cluster and install KubeBlocks for playground.

plugin

Provides utilities for interacting with plugins.

Plugins provide extended functionality that is not part of the major command-line distribution.

  • kbcli plugin describe - Describe a plugin
  • kbcli plugin index - Manage custom plugin indexes
  • kbcli plugin install - Install kbcli or kubectl plugins
  • kbcli plugin list - List all visible plugin executables on a user's PATH
  • kbcli plugin search - Search kbcli or kubectl plugins
  • kbcli plugin uninstall - Uninstall kbcli or kubectl plugins
  • kbcli plugin upgrade - Upgrade kbcli or kubectl plugins

report

Report kubeblocks or cluster info.

  • kbcli report cluster - Report Cluster information
  • kbcli report kubeblocks - Report KubeBlocks information, including deployments, events, logs, etc.

trace

trace management command

  • kbcli trace create - create a trace.
  • kbcli trace delete - Delete a trace.
  • kbcli trace list - list all traces.
  • kbcli trace update - update a trace.
  • kbcli trace watch - watch a trace.

version

Print the version information, include kubernetes, KubeBlocks and kbcli version.

© 2025 ApeCloud PTE. Ltd.