SOFAArk 配置说明

SOFAArk 配置目录

SOFAArk 的配置目录不是必须存在，如果需要，统一放在工程根目录${baseDir}/conf/ark下。执行 sofa-ark-maven-plugin 打包时，会自动将该目录下的配置打包至 Ark 包。Ark 包置目录示例如下：

├── META-INF
│    └── MANIFEST.MF
├── SOFA-ARK
│    ├── biz
│    │    └── demo-0.0.1-SNAPSHOT-ark-biz.jar
│    └── container
│         └── sofa-ark-all-0.6.0-SNAPSHOT.jar
├── com
│    └── alipay
│         └── sofa
│              └── ark
│                   ├──...
│
└── conf
     └── ark
          ├── bootstrap-dev.properties
          ├── bootstrap.properties
          └── log
               └── logback-conf.xml

上述 conf/ark 目录可以配置 SOFAArk 容器的启动配置以及日志配置。conf/ark/bootstrap.properties 是 SOFAArk 容器默认启动配置文件，配置内容包括：日志配置、Plugin 激活和钝化配置、Biz 激活和钝化配置。

日志配置

SOFAArk 容器日志内部实现使用 logback，日志配置参数包括：

• logging.path：容器日志目录根路径，默认打印在${user.admin}/logs目录。

  此项只影响 SOFAArk 容器日志路径，不影响应用日志，应用自身日志由自身配置决定。

• logging.level.com.alipay.sofa.ark：设置 SOFAArk 容器日志级别，默认为 INFO。

• logging.config.com.alipay.sofa.ark：指定自定义日志配置文件名，用于覆盖 SOFAArk 容器自带的日志配置文件。建议自定义配置文件放在conf/ark/log目录中。

• sofa.middleware.log.com.alipay.sofa.ark.console：配置容器日志是否打印在 console，默认为false。

• sofa.middleware.log.com.alipay.sofa.ark.console.level：配合sofa.middleware.log.com.alipay.sofa.ark.console配置项使用。如果打印在 console，此项项用于配置 SOFAArk 容器打印在 console 的日志级别。

插件配置

• ark.plugin.active.include：指定激活哪些插件，多个插件使用英文逗号（,）分隔。默认激活 Ark 包中所有的插件。

• ark.plugin.active.exclude：指定排除哪些插件，多个插件使用英文逗号（,）分隔。默认为空。

  重要

  如果同时配置了这两个属性，以ark.plugin.active.include为准。

Biz 配置

• ark.biz.active.include：指定激活哪些 Biz，多个 Biz 使用英文逗号（,）分隔。默认激活 Ark 包中所有的 Biz。

• ark.biz.active.exclude：指定排除哪些 Biz，多个 Biz 使用英文逗号（,）分隔。默认为空。

• com.alipay.sofa.ark.master.biz：指定宿主 Biz 名，默认设置为宿主 Biz。如果 Ark 包中只有一个 Biz，则无需设置此项；否则需要根据实际情况设置。

  重要

  如果同时配置了前两个属性，以ark.biz.active.include为准。

动态配置

SOFAArk 提供了对接 Zookeeper 的插件，用于动态接收 Biz 指令。配置格式如下：

com.alipay.sofa.ark.config.address=zookeeper://ip:port?key1=value1&key2=value2

Profile 机制

SOFAArk 容器默认使用bootstrap.properties配置，实际开发中，可能根据运行环境加载不同的配置。SOFAArk 提供了 profile 机制，当您指定 profile 值时，SOFAArk 容器会加载bootstrap-${profile}.properties配置文件。

指定 profile 的配置的方式如下：

• 通过 -D VM 参数传入

  例如：-Dark.profile=dev,dev2，多个值使用英文逗号（,）隔开。

• 通过应用启动参数传入

  例如：java -jar demo-executable-ark.jar -Aprofile=dev,dev2，多个值英文逗号（,）隔开。