如何将deployment.toml硬编码端口替换为环境名并实现端口偏移自动生效

• 优先使用配置文件内置表达式计算能力：支持TOML动态配置的中间件普遍支持在配置项中插入算术表达式，你只需要将deployment.toml中原硬编码的端口配置替换为「全局偏移量+基础端口」的表达式格式即可，示例如下：

  # 原硬编码写法
  # transport.amqp.port = 5672
  # transport.telemetry.port = 9611
  # transport.analysis.port = 9711
  
  # 替换为支持偏移的表达式写法
  transport.amqp.port = ${server.offset + 5672}
  transport.telemetry.port = ${server.offset + 9611}
  transport.analysis.port = ${server.offset + 9711}
  

  注意：表达式中的全局偏移参数名需要和你配置中的实际定义一致，比如多数中间件的全局偏移配置为[server] offset = 0，就用server.offset作为偏移变量。
  调整完成后你只需要修改server.offset的值一次，所有关联端口都会自动计算生成偏移后的值，无需逐个修改硬编码端口。

• 如果你的产品版本不支持TOML表达式计算，可以在节点启动脚本中增加预处理逻辑：读取偏移量参数后用命令批量替换配置文件中的硬编码端口，示例命令：

  # 传入偏移量参数，比如偏移1就传PORT_OFFSET=1
  export PORT_OFFSET=1
  sed -i "s/= 5672/= $((5672 + $PORT_OFFSET))/g" deployment.toml
  sed -i "s/= 9611/= $((9611 + $PORT_OFFSET))/g" deployment.toml
  sed -i "s/= 9711/= $((9711 + $PORT_OFFSET))/g" deployment.toml
  

  把所有需要偏移的端口都加入替换规则，启动节点前执行一次脚本即可完成全量端口调整。

TOML配置天然支持读取系统环境变量，你可以直接把硬编码的端口值替换为环境变量引用，按需设置变量值即可：

• 基础替换写法：

  transport.amqp.port = ${env.AMQP_PORT}
  transport.telemetry.port = ${env.TELEMETRY_PORT}
  transport.analysis.port = ${env.ANALYSIS_PORT}
  

• 启动节点前设置对应环境变量即可生效，示例：

  export AMQP_PORT=5673
  export TELEMETRY_PORT=9612
  export ANALYSIS_PORT=9712
  sh bin/start.sh
  

• 如果需要同时兼容环境变量、端口偏移、默认值三种场景，可以使用优先级配置写法：

  # 优先级：环境变量 > 偏移计算端口 > 5672默认值
  transport.amqp.port = ${env.AMQP_PORT:${server.offset + 5672:5672}}
  

内容的提问来源于stack exchange，提问作者Museb Momin