chore: update emqx.conf's note

This commit is contained in:
某文 2023-04-18 20:18:46 +08:00
parent fbadfc06e4
commit 444196922c
1 changed files with 13 additions and 9 deletions

View File

@ -1,13 +1,17 @@
## NOTE: ## NOTE:
## The order of priority for configuration is: ## The EMQX configuration is prioritized (overlayed) in the following order:
## environment variables, 'etc/emqx.conf', and 'data/configs/cluster.hocon'. ## `cluster.hocon < emqx.conf < environment variables`.
## 1. Settings in environment variables starting with 'EMQX_' are given the highest priority.
## 2. Configuration settings in the 'etc/emqx.conf' file may be overwritten by environment variables. ## Settings in environment variables that begin with 'EMQX_' have the highest priority
## 3. Changes made through the EMQX dashboard UI, management HTTP API, or CLI ## and will override any settings in the `etc/emqx.conf` file.
## overwrite the 'data/configs/cluster.hocon' file at runtime.
## 4. If you modify a configuration setting using the API, the change takes effect immediately. ## Changes made through the EMQX dashboard UI, management HTTP API, or CLI
## 5. However, if the same setting is configured differently in the 'etc/emqx.conf' file, ## will be written into the `data/configs/cluster.hocon` file at runtime and will take effect immediately.
## 'etc/emqx.conf' takes priority after a reboot.
## However, if the same configuration items are set differently in the `etc/emqx.conf` file,
## the runtime updates will be overridden by the settings in `etc/emqx.conf` after the node restarts.
## To avoid confusion, it is highly recommend NOT to have the same config keys in both `cluster.hocon` and `emqx.conf`.
## All configuration details can be found in emqx.conf.example ## All configuration details can be found in emqx.conf.example