创建并连接 ApeCloud MySQL 集群

本文档展示如何创建并连接到一个 ApeCloud MySQL 集群。

创建并连接到 ApeCloud MySQL 集群

开始之前

• 安装 kbcli。

• 安装 KubeBlocks。

• 确保 ApeCloud MySQL 引擎已启用。如果引擎未启用，可参考该文档启用引擎。

  kbcli addon list
  >
  NAME                           TYPE   STATUS     EXTRAS         AUTO-INSTALL   
  ...
  apecloud-mysql                 Helm   Enabled                   true
  ...

• 查看可用于创建集群的数据库类型和版本。

  kbcli clusterdefinition list
  
  kbcli clusterversion list

• 为保持隔离，本教程中创建一个名为 demo 的独立命名空间。

  kubectl create namespace demo

创建集群

KubeBlocks 支持创建两种类型的 ApeCloud MySQL 集群：单机版（Standalone）和集群版（RaftGroup）。单机版仅支持一个副本，适用于对可用性要求较低的场景。 集群版包含三个副本，适用于对高可用性要求较高的场景。为了确保高可用性，所有的副本都默认分布在不同的节点上。

创建 MySQL 单机版。

kbcli cluster create mysql <clustername>

创建 MySQL 集群版。

kbcli cluster create mysql --mode raftGroup <clustername>

如果只有一个节点用于部署三节点集群，请在创建集群时将 topology-keys 设置为 null。

kbcli cluster create mysql --mode raftGroup --topology-keys null <clustername>

备注

• 生产环境中，不建议将所有副本部署在同一个节点上，因为这可能会降低集群的可用性。

• 执行以下命令，查看创建 MySQL 集群的选项和默认值。

  kbcli cluster create mysql -h

连接集群

kbcli cluster connect <clustername>  --namespace <name>

有关详细的数据库连接指南，请参考连接数据库。