egg-apollo

使用场景

用于接入 apollo 配置中心，实现启动前动态加载配置进行初始化，与运行时获取最新配置来实现配置热更新，基于ctrip-apollo扩展。

启动前动态加载配置

通过配置 mergeNamespace: application 可以在 egg 启动前(目前在configWillLoad生命周期钩子),将 apollo 的 application 命名空间的配置合入本地文件配置 app.config 中，实现启动前的配置文件加载。

运行时获取配置

可以通过像获取 egg 配置一样的调用方式直接获取 apollo 配置，如 app.config.application 来获得 application 命名空间下的配置信息，也可以通过 app.apollo 来获取 apollo 实例，自行调用 api 获取配置信息。

配置获取在默认配置的情况下都是热更新的。详见后续说明。

安装

npm i @zijin-m/egg-apollo

依赖说明

依赖的 egg 版本

| egg-apollo 版本 | egg 1.x | | --------------- | ------- | | 1.x | 😁 | | 0.x | ❌ |

开启插件

// config/plugin.js
exports.apollo = {
  enable: true,
  package: '@zijin-m/egg-apollo'
};

详细配置

  host: '', // 配置中心地址
  appId: '', // appId
  cluster: 'default', // 默认集群
  namespaces: [ 'application' ], // 默认命名空间
  cachePath: '/tmp/apollo_cache', // 默认缓存目录
  enableUpdateNotification: true, // 默认开启推送更新
  enableFetch: true, // 默认开启定时拉取
  fetchInterval: 5 * 60 * 1000, // 定时拉取间隔
  retry: 10, // 初始化重试次数
  mergeNamespace: '', // 将特定namespace合入本地配置 默认不做
  mountConfig: true, // 将namespaces挂载到本地配置 默认开启

请到 config/config.default.js 查看详细配置项说明。

使用参考

当apollo的某个appId下的application命名空间配置如下时

| key | value | | ------ | ---------------- | | name | apollo | | config | {"key": "value"} | | a.b | 1 | | a.c.d | 2 |

通过app.conig直接获取配置信息。

console.log(app.config.application);
// {
//   name: "apollo",
//   config: {
//     key: "value"
//   },
//   a: {
//     b: 1,
//     c: {
//       d: 2
//     }
//   }
// }

通过这种方式获得配置数据会默认进行 key 的对象合并和 value 的 JSON 格式化，所以推荐使用这种方式,具体的合并方式可以参考properties对 namespaces 合并的规则，但是一般来说不推荐使用 key 合并，而是直接把 value 设置为 JSON 对象更好。

第二种是直接通过app.apollo获取，这种获取方式拿到的配置不会对数据进行任何处理，所以得到的是原始字符串。

app.apollo.namespace().config(); // 获取默认namespace下的全部配置
app.apollo.namespace().get(key); // 获取默认namespace下的某个配置

关于热更新

对于以上两种获取配置的方式，在启用enableUpdateNotification: true后可以获得近实时更新配置，或者启用enableFetch: true(fetchInterval)后，在fetchInterval周期后更新配置。

配置说明

常见配置可以参考ctrip-apollo

mountConfig配置 默认开启

开启后会将namespaces挂载到config下，比如配置namespaces: [ 'application','otherNameSpace' ]的时候你可以通过app.config.application,app.config.otherNameSpace获取 apollo 配置。

mergeNamespace配置

如果你希望将特定namespace的配置合并到config中，可以设置mergeNamespace，如mergeNamespace: 'application'，常见的使用场景是在 egg 启动前更改配置，如将启动的配置放在 apollo 配置中心，否则使用mountConfig进行配置挂载就能满足日常需求。

提问交流

请到 egg issues 异步交流。

License

MIT