跳到主要内容

部署参数说明

API 模块和 Server 模块在启动时参数说明。

FeatureProbe API

Environment variableDefault valueRequiredDescription
spring.datasource.jdbc-url-JDBC 连接地址。示例:jdbc:mysql://{database_ip:port}/{database_name}
spring.datasource.usernameroot连接数据库用户名
spring.datasource.passwordroot连接数据库密码
server.port8080服务端口
TZAsia/Shanghai时区
spring.profiles.activeonline当前生效的 profile
logging.level.rootINFO应用日志级别; INFO/ERROR/WARN/DEBUG
spring.jpa.show-sqlfalse是否显示执行时的 SQL 语句
app.security.jwt.keystore-location./jwt.jks证书文件路径
app.security.jwt.keystore-passwordpassword生成证书时 storepass
app.security.jwt.private-key-passphrasepassword生成证书时的 keypass
app.analysis-urlhttp://127.0.0.1:4006指标分析服务的地址
server-base-urlshttp://127.0.0.1:4007Server服务的地址,多个地址用, 分割,用于降低配置变更延迟

上述参数使用 docker 方式启动程序通过 Environment 传入,如以 jar 包启动通过 java -- 传入.

安全认证配置

FeatureProbe API 作为管理后台,对用户登录认证采用 JWT 标准协议,并使用 RSA256 加密算法签名。为保证安全性,强烈建议重新生成 RSA 密钥文件。

密钥生成方式:

keytool -genkey -alias my-featureprobe-jwt -keyalg RSA -keysize 1024 -keystore fp-jwt.jks -validity 365 -keypass YOU-PRIVATE-KEY-PASSPHRASE -storepass YOU-KEYSTORE-PASSWORD

执行完成后会在当前目录下生成 fp-jwt.jks 文件,参数说明:

  • validity - 证书有效天数
  • keypass - YOU-PRIVATE-KEY-PASSPHRASE
  • storepass - YOU-KEYSTORE-PASSWORD

证书生成后,需要修改启用参数 app.security.jwt.* 来让当前证书在应用程序中生效。

FeatureProbe Server

Environment variableDefault valueRequiredDescription
FP_TOGGLES_URLhttp://127.0.0.1:8080/api/server/toggles连接的 FeatureProbe API 服务地址;用于拉取开关
FP_KEYS_URLhttp://127.0.0.1:8080/api/server/sdk_keys连接的 FeatureProbe API 服务地址;用于拉取 sdk key
FP_EVENTS_URLhttp://127.0.0.1:8080/api/server/events连接的 FeatureProbe API 服务地址;用于上报开关访问事件
FP_ANALYSIS_URL-指标分析服务地址,用于事件上报
FP_SERVER_PORT4007服务端口
FP_REFRESH_SECONDS3轮询拉取开关间隔时间
RUST_LOGinfo应用日志级别; info/error

上述参数无论是以 docker 方式或二进制方式启动,均通过 Environment 传入.