# EMQX 配置
# 任务目标
如何使用 bootstrapConfig 字段修改 EMQX 节点配置。
# 配置 EMQX 集群
EMQX 主配置文件为 emqx.conf，从 5.0 版本开始，EMQX 采用 HOCON (opens new window) 作为配置文件格式。
EMQX CRD 支持使用 .spec.bootstrapConfig 字段配置 EMQX 集群，bootstrapConfig 配置可以参考文档：bootstrapConfig (opens new window)。这个字段只允许在创建 EMQX 集群的时候配置，不支持更新。
提示
如果在创建 EMQX 之后需要修改集群配置，请通过 EMQX Dashboard 进行修改。
apiVersion: apps.emqx.io/v2alpha1 kind: EMQX metadata: name: emqx spec: image: emqx:5.0 bootstrapConfig: | listeners.tcp.test { bind = "0.0.0.0:1884" max_connections = 1024000 }Copied!
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
在
.spec.bootstrapConfig字段里面，我们为 EMQX 集群配置了一个 TCP listener，这个 listener 名称为：test，监听的端口为：1884。
将上述内容保存为：emqx-bootstrapConfig.yaml，并执行如下命令部署 EMQX 集群：
$ kubectl apply -f emqx-bootstrapConfig.yaml emqx.apps.emqx.io/emqx createdCopied!
1
2
3
2
3
检查 EMQX 集群状态，请确保 STATUS 为 Running，这可能需要一些时间等待 EMQX 集群准备就绪。
$ kubectl get emqx NAME IMAGE STATUS AGE emqx emqx:5.0 Running 2m55sCopied!
1
2
3
4
2
3
4
# 验证配置更改
查看 EMQX 集群 listener 信息
kubectl exec -it emqx-core-0 -c emqx -- emqx_ctl listenersCopied!
1
输出类似于：
tcp:default listen_on : 0.0.0.0:1883 acceptors : 16 proxy_protocol : false running : true current_conn : 0 max_conns : 1024000 tcp:test listen_on : 0.0.0.0:1884 acceptors : 16 proxy_protocol : false running : true current_conn : 0 max_conns : 1024000Copied!
1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
从输出结果可以看到我们配置的名称为 test 的 listener 已经生效。
本页导航