配置集群参数
本文档将说明如何配置集群参数。
从 v0.9.0 开始，KubeBlocks 支持数据库参数配置动态渲染。当数据库实例的规格发生变化时（例如，用户进行了实例的升降配），KubeBlocks 会根据新的规格自动匹配适用的参数模板。这是因为不同规格的数据库实例可能需要不同的最佳参数配置以优化性能和资源利用率。当用户选择不同的数据库实例规格时，KubeBlocks 会自动检测并确定适用于新规格的最佳数据库参数配置，以确保数据库在新规格下具有最优的性能和配置。
配置动态渲染功能简化了数据库规格调整的过程。用户无需手动更改数据库参数，KubeBlocks 会自动处理参数的更新和配置，以适应新的规格。这样可以节省时间和精力，并减少由于参数设置不正确而导致的性能问题。
需要注意的是，配置动态渲染功能并不适用于所有参数。有些参数可能需要手动进行调整和配置。此外，如果你对数据库参数进行了手动修改，KubeBlocks 在更新数据库参数模板时可能会覆盖手动修改。因此，在使用动态调整功能时，建议先备份和记录自定义的参数设置，以便在需要时进行恢复。
查看参数信息
查看集群的配置文件。
kbcli cluster describe-config mycluster
从元信息中可以看到，集群 mycluster 有一个名为 my.cnf 的配置文件。
你也可以查看此配置文件和参数的详细信息。
查看当前配置文件的详细信息。
kbcli cluster describe-config mycluster --show-detail查看参数描述。
kbcli cluster explain-config mycluster | head -n 20查看指定参数的使用文档。
kbcli cluster explain-config mycluster --param=innodb_buffer_pool_size --config-specs=mysql-replication-configMySQL 目前支持多个模板，可通过
--config-specs来指定一个配置模板。执行kbcli cluster describe-config mysql-cluster查看所有模板的名称。输出
component: mysql
template meta:
ConfigSpec: mysql-replication-config ComponentName: mysql ClusterName: mycluster
Configure Constraint:
Parameter Name: innodb_buffer_pool_size
Allowed Values: [5242880-18446744073709552000]
Scope: Global
Dynamic: true
Type: integer
Description: The size in bytes of the memory buffer innodb uses to cache data and indexes of its tables- Allowed Values：定义了参数的有效值范围。
- Dynamic: 决定了参数配置的生效方式。根据被修改参数的生效类型，有动态和静态两种不同的配置策略。
Dynamic为true时，参数动态生效，可在线配置。Dynamic为false时，参数静态生效，需要重新启动 Pod 才能生效。
- Description：描述了参数的定义。
配置参数
使用 configure 命令配置参数
以下示例以配置 max_connections 和 innodb_buffer_pool_size 为例。
查看
max_connections和innodb_buffer_pool_size的当前值。kbcli cluster connect myclustermysql> show variables like '%max_connections%';
>
+-----------------+-------+
| Variable_name | Value |
+-----------------+-------+
| max_connections | 167 |
+-----------------+-------+
1 row in set (0.04 sec)mysql> show variables like '%innodb_buffer_pool_size%';
>
+-------------------------+-----------+
| Variable_name | Value |
+-------------------------+-----------+
| innodb_buffer_pool_size | 134217728 |
+-------------------------+-----------+
1 row in set (0.00 sec)调整
max_connections和innodb_buffer_pool_size的值。kbcli cluster configure mycluster --set=max_connections=600,innodb_buffer_pool_size=512M备注确保设置的值在该参数的 Allowed Values 范围内。如果设置的值不符合取值范围，系统会提示错误。例如：
kbcli cluster configure mycluster --set=max_connections=200,innodb_buffer_pool_size=2097152
error: failed to validate updated config: [failed to cue template render configure: [mysqld.innodb_buffer_pool_size: invalid value 2097152 (out of bound >=5242880):
343:34
]
]查看参数配置状态。
Status.Progress展示参数配置的整体状态，而Conditions展示详细信息。kbcli cluster describe-ops mycluster-reconfiguring-pxs46 -n default输出
Spec:
Name: mycluster-reconfiguring-pxs46 NameSpace: default Cluster: mycluster Type: Reconfiguring
Command:
kbcli cluster configure mycluster --components=mysql --config-specs=mysql-replication-config --config-file=my.cnf --set innodb_buffer_pool_size=512M --set max_connections=600 --namespace=default
Status:
Start Time: Jul 05,2024 19:00 UTC+0800
Completion Time: Jul 05,2024 19:00 UTC+0800
Duration: 2s
Status: Succeed
Progress: 2/2
OBJECT-KEY STATUS DURATION MESSAGE
Conditions:
LAST-TRANSITION-TIME TYPE REASON STATUS MESSAGE
Jul 05,2024 19:00 UTC+0800 WaitForProgressing WaitForProgressing True wait for the controller to process the OpsRequest: mycluster-reconfiguring-pxs46 in Cluster: mycluster
Jul 05,2024 19:00 UTC+0800 Validated ValidateOpsRequestPassed True OpsRequest: mycluster-reconfiguring-pxs46 is validated
Jul 05,2024 19:00 UTC+0800 Reconfigure ReconfigureStarted True Start to reconfigure in Cluster: mycluster, Component: mysql
Jul 05,2024 19:00 UTC+0800 Succeed OpsRequestProcessedSuccessfully True Successfully processed the OpsRequest: mycluster-reconfiguring-pxs46 in Cluster: mycluster
Warning Events: <none>连接到数据库，验证参数是否按预期配置。
整体搜索过程有 30 秒的延迟，因为 kubelet 需要一些时间同步对 Pod 卷的修改。
kbcli cluster connect myclustermysql> show variables like '%max_connections%';
>
+-----------------+-------+
| Variable_name | Value |
+-----------------+-------+
| max_connections | 600 |
+-----------------+-------+
1 row in set (0.04 sec)mysql> show variables like '%innodb_buffer_pool_size%';
>
+-------------------------+-----------+
| Variable_name | Value |
+-------------------------+-----------+
| innodb_buffer_pool_size | 536870912 |
+-------------------------+-----------+
1 row in set (0.00 sec)
使用 edit-config 命令配置参数
KubeBlocks 提供了一个名为 edit-config 的工具，帮助以可视化的方式配置参数。
Linux 和 macOS 系统可以使用 vi 编辑器编辑配置文件，Windows 系统可以使用 notepad。
编辑配置文件。
kbcli cluster edit-config mycluster --config-specs=mysql-replication-config备注- MySQL 目前支持多个模板，需通过
--config-spec指定一个配置模板。执行kbcli cluster describe-config mysql-cluster查看所有模板的名称。 - 如果集群中有多个组件，请使用
--components参数指定一个组件。
- MySQL 目前支持多个模板，需通过
查看参数配置状态。
kbcli cluster describe-ops xxx -n default连接到数据库，验证参数是否按预期配置。
kbcli cluster connect mycluster备注edit-config不能同时编辑静态参数和动态参数。- KubeBlocks 未来将支持删除参数。
查看历史记录并比较参数差异
配置完成后，你可以搜索历史配置并比较参数差异。
查看参数配置历史记录。
kbcli cluster describe-config mycluster
>
component: mysql
ConfigSpecs Meta:
CONFIG-SPEC-NAME FILE ENABLED TEMPLATE CONSTRAINT RENDERED COMPONENT CLUSTER
mysql-replication-config my.cnf true oracle-mysql8.0-config-template oracle-mysql8.0-config-constraints mycluster-mysql-mysql-replication-config mysql mycluster
agamotto-configuration agamotto-config.yaml false mysql-agamotto-configuration mycluster-mysql-agamotto-configuration mysql mycluster
agamotto-configuration agamotto-config-with-proxy.yaml false mysql-agamotto-configuration mycluster-mysql-agamotto-configuration mysql mycluster
History modifications:
OPS-NAME CLUSTER COMPONENT CONFIG-SPEC-NAME FILE STATUS POLICY PROGRESS CREATED-TIME VALID-UPDATED
mycluster-reconfiguring-pxs46 mycluster mysql mysql-replication-config my.cnf Succeed syncDynamicReload 2/2 Jul 05,2024 19:00 UTC+0800 {"my.cnf":"{\"mysqld\":{\"innodb_buffer_pool_size\":\"512M\",\"max_connections\":\"600\"}}"}
mycluster-reconfiguring-x52fb mycluster mysql mysql-replication-config my.cnf Succeed syncDynamicReload 2/2 Jul 05,2024 19:04 UTC+0800 {"my.cnf":"{\"mysqld\":{\"max_connections\":\"1000\"}}"}
从上面可以看到，有三个参数被修改过。
比较这些改动，查看不同版本中配置的参数和参数值。
kbcli cluster diff-config mycluster-reconfiguring-pxs46 mycluster-reconfiguring-x9zsf
>
DIFF-CONFIGURE RESULT:
ConfigFile: my.cnf TemplateName: mysql-replication-config ComponentName: mysql ClusterName: mycluster UpdateType: update
PARAMETERNAME mycluster-reconfiguring-pxs46 mycluster-reconfiguring-x9zsf
max_connections 600 2000
innodb_buffer_pool_size 512M 1G