跳到主要内容

配置集群参数

本文档将说明如何配置集群参数。

从 v0.9.0 开始，KubeBlocks 支持数据库参数配置动态渲染。当数据库实例的规格发生变化时（例如，用户进行了实例的升降配），KubeBlocks 会根据新的规格自动匹配适用的参数模板。这是因为不同规格的数据库实例可能需要不同的最佳参数配置以优化性能和资源利用率。当用户选择不同的数据库实例规格时，KubeBlocks 会自动检测并确定适用于新规格的最佳数据库参数配置，以确保数据库在新规格下具有最优的性能和配置。

配置动态渲染功能简化了数据库规格调整的过程。用户无需手动更改数据库参数，KubeBlocks 会自动处理参数的更新和配置，以适应新的规格。这样可以节省时间和精力，并减少由于参数设置不正确而导致的性能问题。

需要注意的是，配置动态渲染功能并不适用于所有参数。有些参数可能需要手动进行调整和配置。此外，如果您对数据库参数进行了手动修改，KubeBlocks 在更新数据库参数模板时可能会覆盖手动修改。因此，在使用动态调整功能时，建议先备份和记录自定义的参数设置，以便在需要时进行恢复。

  1. 获取集群的配置文件。

    kubectl edit configurations.apps.kubeblocks.io mycluster-postgresql -n demo

  2. 按需配置参数。以下实例中添加了 spec.configFileParams，用于配置 max_connections 参数。

    spec:
      clusterRef: mycluster
      componentName: postgresql
      configItemDetails:
      - configFileParams:
          my.cnf:
            parameters:
              max_connections: "600"
        configSpec:
          constraintRef: postgresql14-cc
          defaultMode: 292
          keys:
          - postgresql.conf
          name: postgresql-configuration
          namespace: kb-system
          templateRef: postgresql-configuration
          volumeName: postgresql-config
        name: postgresql-configuration
      - configSpec:
          defaultMode: 292

  3. 连接集群，确认配置是否生效。

    1. 获取用户名和密码。

      kubectl get secrets -n demo mycluster-conn-credential -o jsonpath='{.data.username}' | base64 -d
      >
      root

      kubectl get secrets -n demo mycluster-conn-credential -o jsonpath='{.data.password}' | base64 -d
      >
      2gvztbvz

    2. 连接集群，验证参数是否按预期配置。

      kubectl exec -ti -n demo mycluster-postgresql-0 -- bash

      root@mycluster-postgresql-0:/home/postgres# psql -U postgres -W
      Password: tf8fhsv2
      >
      postgres=# show max_connections;
      max_connections
      -----------------
      600
      (1 row)
备注

如果您无法找到集群的配置文件，您可以切换到 kbcli 页签，使用相关命令查看集群当前的配置文件。

kbcli cluster describe-config mycluster -n demo