# 业务配置

## 业务配置原理

### 配置文件数据结构

基于Tars框架的业务服务的配置文件信息分为三层级别，应用配置、Set应用配置、服务配置和节点配置。

应用级为最高一级的配置文件，在同一应用（业务）下都可以被引用；

Set应用配置继承自应用级配置，即一个Set应用配置必须有相应的应用级配置；

服务和节点配置都可以引用应用配置信息和Set应用配置，并且节点配置默认继承服务配置的内容。

优先级：节点配置 > 服务配置 > Set应用配置 > 应用配置

如下图所示：

![](https://211854462-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKWVpRE8j8fOTPPSus%2Fuploads%2Fgit-blob-c69f86b84c4a4f0d49c13c5a19412d3cc0ae856c%2Ftars_config_jiegoutu.png?alt=media)

Tars框架通过两个数据表来维护这些配置信息，t\_config\_files和t\_config\_references。

t\_config\_files表的主要信息：服务配置文件名称、配置文件类型、配置文件所属服务名，配置文件所属set分组，配置文件所属节点ip以及配置文件的索引id值以及该服务所在set分组信息。

如下图所示：

![](https://211854462-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKWVpRE8j8fOTPPSus%2Fuploads%2Fgit-blob-9e718f6805115c7486d2fb5ede755f1756a6f66c%2Ftars_config_table1.png?alt=media)

t\_config\_references表的主要信息：配置文件的索引id以及该id所引用的配置文件索引id。

如下图所示：

![](https://211854462-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKWVpRE8j8fOTPPSus%2Fuploads%2Fgit-blob-2d0ef9058ea2a5fdca934417050b5f1d17e71dd7%2Ftars_config_table2.png?alt=media)

注意：本文所指的引用配置文件都是指应用配置文件或者相应的Set配置文件。

### 实现原理

根据上述配置文件内容结构，Tars框架提供了从`tarsconfig`服务获取应用级配置信息和服务级配置信息（包括同时获取引用配置信息）的接口。

注意:

* 每种语言的tars库都包含了api,可以从tarscofig获取配置文件
* 业务配置的格式, 你可以根据你的需要选择, 框架是不处理和理解业务配置的

#### 获取应用级配置

目前业务服务获取应用级配置信息的方式是使用框架中提供的addAppConfig接口,该接口负责向configServer服务拉取相应的应用配置文件到本地目录。

```
bool addAppConfig(const string &filename);
```

首先向`tarsconfig`获取应用级配置信息，同时判断该业务服务是否有set分组信息，如果有则获取相应set分组内的配置信息，最后把配置信息保存到本地文件中。

注意set配置优先级高于应用配置。

主要逻辑如下图：

![](https://211854462-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKWVpRE8j8fOTPPSus%2Fuploads%2Fgit-blob-d4e215f03c580d5404d430a7f0ba3e52d6bcd839%2Ftars_config_appconfig.png?alt=media)

拉取应用配置的结果图如下：

![](https://211854462-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKWVpRE8j8fOTPPSus%2Fuploads%2Fgit-blob-2566f7181161dce802b14fb0ced8d185d10516b7%2Ftars_config_appconfig_result.png?alt=media)

#### 获取服务级配置

目前业务获取服务级别的配置信息方式是使用框架中提供的addConfig接口实现,该接口负责向configServer服务拉取相应的服务配置文件到本地目录。

```
bool addConfig(const string &filename);
```

获取服务级的配置信息主要分为三个步骤：

1.首先以服务名、配置文件名、set分组信息和配置信息等级为检索条件，获取配置信息等级为“服务级别”的配置信息和索引id

2.其次，通过（1）中索引id从数据表t\_config\_referencses获取该id所引用的配置信息索引id（references\_id)，索引id的具体对应关系如下图：

![](https://211854462-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKWVpRE8j8fOTPPSus%2Fuploads%2Fgit-blob-82f19b28012e564af9842a428db749118496c691%2Ftars_config_references.png?alt=media)

如果存在引用信息，则检索数据表t\_config\_files中references\_id对应的配置信息，同时检索该references\_id对应的配置文件是否有“Set级配置信息”，如果有则再获取该set级别配置信息。

3.按顺序合并2和2中获取的配置信息，2为先1其次。

4.再次以服务名、配置文件名、服务所属节点ip和配置信息等级为检索条件，获取配置信息等级为节点级别的配置信息和索引id，然后重复2和3步骤。

5.最终返回给业务服务的服务级配置信息的组成顺序是：服务级的引用配置信息+服务级配置信息+节点级引用配置信息+节点级配置信息。

**这里配置文件合并以后, 就是按照文本的顺序合并, 因此如果你使用json之类的配置格式, 可能会格式非法!**

## 业务配置示例

### 应用配置

在业务树上选择相应的应用（业务），在右边打开的管理界面选择“应用配置”一页，就可以进行添加配置、编辑配置等操作。如下图：

![](https://211854462-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKWVpRE8j8fOTPPSus%2Fuploads%2Fgit-blob-1c7ffd33f86d8cd9d8789e17fc3ccac005e688e3%2Ftars_config_app1.png?alt=media)

添加应用配置Test.conf,如下图：

![](https://211854462-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKWVpRE8j8fOTPPSus%2Fuploads%2Fgit-blob-f76ad376e1be8421ebcf036ed9948061bbfe3843%2Ftars_config_app2.png?alt=media)

### Set配置

在业务树上选择相应的Set分组，在右边打开的管理界面选择“Set配置”一页，就可以进行添加配置、编辑配置等操作，如下图：

![](https://211854462-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKWVpRE8j8fOTPPSus%2Fuploads%2Fgit-blob-ba0330a9b7dbca7d2f5123c9d036f2b8836923de%2Ftars_config_set1.png?alt=media)

添加应用配置Test.conf,如下图：

![](https://211854462-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKWVpRE8j8fOTPPSus%2Fuploads%2Fgit-blob-1f193f8bc263d9d7d64087f605bdc7a9c0e4fd19%2Ftars_config_set2.png?alt=media)

> * 注意：只有添加了相应的应用配置文件，才能添加相应的Set配置。

### 服务配置

在左边的业务树选择需要维护的业务服务，点击左边打开的管理界面中“服务配置”一页，就可以进行服务配置的的添加、编辑和删除等操作。如下图：

![](https://211854462-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKWVpRE8j8fOTPPSus%2Fuploads%2Fgit-blob-3ac046d2043d3582a475fd785d79f1717c8d09ca%2Ftars_config_server1.png?alt=media)

添加应用配置Test.conf,如下图：

![](https://211854462-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKWVpRE8j8fOTPPSus%2Fuploads%2Fgit-blob-fb0c2607b57f310197068a7a85b4217f14949b6c%2Ftars_config_server2.png?alt=media)

在服务配置里就可以引用上一级的配置内容（即所属应用(业务）的应用配置的内容以及所属Set的配置内容）如下图：

![](https://211854462-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKWVpRE8j8fOTPPSus%2Fuploads%2Fgit-blob-66d444c39f4e51bb3d4e9e96c3fa79baf73fbe10%2Ftars_config_server3_ref1.png?alt=media)

![](https://211854462-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKWVpRE8j8fOTPPSus%2Fuploads%2Fgit-blob-392c0deca579a7bec4bc244518ed441574f87b96%2Ftars_config_server3_ref2.png?alt=media)