Apollo的基本概念和集成實戰(zhàn)

基本概念

使用場景

是一個分布式的配置中心。適用于微服務(wù)；

核心功能

1. 集中管理不同環(huán)境，不同集群的配置；
2. 配置修改后可以實時推送到應(yīng)用端；
3. 具備規(guī)范的權(quán)限，流程治理特性；

開發(fā)技術(shù)

• 服務(wù)端使用springboot,springcloud開發(fā)，打包后可以直接運行，無需安裝額外的tomcat;
• java客戶端不依賴任何框架,對Spring,SpringBoot的客戶端也有額外支持
• .net客戶端不依賴任何框架

概念

詳細(xì)功能

1. 統(tǒng)一管理不同環(huán)境，不同集群，不同命名空間的配置；
2. 同一份代碼可以部署在不同的集群，可以有不同的配置，比如zk地址
3. 通過命名空間可以方便的支持不同應(yīng)用共享同一份配置，同時還允許應(yīng)用對共享的配置進(jìn)行覆蓋；
4. 配置修改實時生效 （用戶在后臺修改完配置發(fā)布后，客戶端可以在1s內(nèi)收到最新的配置并通知應(yīng)用程序）
5. 版本發(fā)布概念， （所有的配置發(fā)布都有版本概念，可以方便的支持配置的回滾）
6. 灰度發(fā)布（配置發(fā)布后，支隊部分應(yīng)用實例生效，等觀察一段時間后在推送給所有的應(yīng)用）
7. 權(quán)限管理，發(fā)布審核，操作審計
8. 客戶端配置信息監(jiān)控（方便的看到配置被哪些實例使用）
9. 支持多種語言，java和.net ，通過http接口使用也是支持的；
10. 提供開放平臺api給到其它系統(tǒng)修改和發(fā)布操作；
11. 部署簡單

后臺使用

后臺界面操作

客戶端接入文檔

后臺操作

1. 創(chuàng)建項目
2. 分配管理員，（管理項目的權(quán)限分配，創(chuàng)建集群，創(chuàng)建namespace）
3. 分配配置的修改和發(fā)布權(quán)限
4. 添加配置項 ,修改配置項
5. 發(fā)布配置，回滾配置；
6. 讀取配置是在應(yīng)用端使用； 具體見客戶端接入文檔；

公共組件的操作

公共組件： 提供給應(yīng)用使用的其它組織的客戶端代碼，比如cat的客戶端；本質(zhì)上也是應(yīng)用的一部分；
區(qū)別 ： 通常情況下，公共組件的使用的配置由原始開發(fā)團(tuán)隊維護(hù)，但是實際的應(yīng)用在運行時，環(huán)境不一樣，所以我們也允許應(yīng)用在實際使用的時候能夠覆蓋公共組件的部分配置；
需要自己創(chuàng)建自己唯一的namespace ;

公共組件的操作

1. 創(chuàng)建項目
2. 分配項目管理員權(quán)限
3. 創(chuàng)建namespace
4. 添加配置項，發(fā)布；
5. 公共配置的讀取
6. 應(yīng)用關(guān)聯(lián)公共組件并覆蓋公共組件的配置項

集群獨立配置

1. 添加集群,默認(rèn)集群；
2. 多個appId使用同一份配置
3. 同公共組件，關(guān)聯(lián)namespace，寫入公共配置，或者覆蓋公共配置

灰度發(fā)布
操作

1. 創(chuàng)建灰度
2. 灰度配置
3. 灰度規(guī)則的新增，修改
4. 灰度發(fā)布
5. 全量發(fā)布，放棄灰度
6. 發(fā)布?xì)v史

客戶端接入

要求：jdk1.7+ , guava15.0+

客戶端配置參數(shù)

1. app.id (systemProperty > System Environment > springboot application.properties > META-INF/app.properties) 對應(yīng)項目的id
2. apollo.meta 訪問地址 （SystemProperty > SpringBoot > SystemEnvironment>/opt/settings/server.properties > app.properties）
3. 本地緩存路徑 /opt/data/{appId}/config-cache/ key: apollo.cacheDir
4. 環(huán)境配置 key : env
5. 集群配置 key: apollo.cluster

客戶端依賴

 <dependency>
        <groupId>com.ctrip.framework.apollo</groupId>
        <artifactId>apollo-client</artifactId>
        <version>1.1.0</version>
 </dependency>

接入方式對比

API接入

獲取application namespace配置

Config config = ConfigService.getAppConfig(); 
//config instance is singleton for each namespace and is never null
String value = config.getProperty(someKey, someDefaultValue);

獲取公共namespace

String somePublicNamespace = "CAT";
Config config = ConfigService.getConfig(somePublicNamespace); 
//config instance is singleton for each namespace and is never null
String value = config.getProperty(someKey, someDefaultValue);

獲取非properties格式的namespace配置

Config config = ConfigService.getConfig("application.yml");
String value = config.getProperty(someKey, someDefaultValue);

xml格式文件獲取

String someNamespace = "test";
ConfigFile configFile = ConfigService.getConfigFile("test", ConfigFileFormat.XML);
String content = configFile.getContent();

事件監(jiān)聽

Config config = ConfigService.getAppConfig(); 
//config instance is singleton for each namespace and is never null
config.addChangeListener(new ConfigChangeListener() {
    @Override
    public void onChange(ConfigChangeEvent changeEvent) {
        System.out.println("Changes for namespace " + changeEvent.getNamespace());
        for (String key : changeEvent.changedKeys()) {
            ConfigChange change = changeEvent.getChange(key);
            System.out.println(String.format("Found change - key: %s, oldValue: %s, newValue: %s, changeType: %s", change.getPropertyName(), change.getOldValue(), change.getNewValue(), change.getChangeType()));
        }
    }
});

spring方式接入

基于xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:apollo="http://www.ctrip.com/schema/apollo"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
       http://www.ctrip.com/schema/apollo http://www.ctrip.com/schema/apollo.xsd">
    <apollo:config order="2"/>
    <!-- 這個是最復(fù)雜的配置形式，指示Apollo注入FX.apollo和application.yml namespace的配置到Spring環(huán)境中，并且順序在application前面 -->
    <apollo:config namespaces="FX.apollo,application.yml" order="1"/>
    <bean class="com.ctrip.framework.apollo.spring.TestXmlBean">
        <property name="timeout" value="${timeout:100}"/>

基于javaconfig

//這個是最復(fù)雜的配置形式，指示Apollo注入FX.apollo和application.yml namespace的配置到Spring環(huán)境中，并且順序在application前面
@Configuration
@EnableApolloConfig(order = 2)
public class SomeAppConfig {
  @Bean
  public TestJavaConfigBean javaConfigBean() {
    return new TestJavaConfigBean();
  }
}
@Configuration
@EnableApolloConfig(value = {"FX.apollo", "application.yml"}, order = 1)
public class AnotherAppConfig {}

springboot方式接入

直接配置屬性

#加載應(yīng)用對應(yīng)的application namespace的配置
 apollo.bootstrap.enabled = true
 #加載其它namespace 的配置
 apollo.bootstrap.namespaces = application,FX.apollo,application.yml
 #在日志系統(tǒng)啟動之前加載阿波羅
 apollo.bootstrap.eagerLoad.enabled=true

其它說明

一些公共的注解

新增的spring注解

• @ApolloConfig
  用來自動注入Config對象
• @ApolloConfigChangeListener
  用來自動注冊ConfigChangeListener

• @ApolloJsonValue
  用來把配置的json字符串自動注入為對象

  配置的遷移

配置的遷移

1. apollo中創(chuàng)建對應(yīng)的項目；
2. 在應(yīng)用中創(chuàng)建好META-INF/app.properties,并配置好；
3. 原來的配置文件，轉(zhuǎn)換為properties，貼到apollo后臺；

4. 刪除本地的配置；

   本地開發(fā)

5. 修改 /opt/settins/server.properties
   設(shè)置env = Local
6. 準(zhǔn)備本地配置文件 位置：
   Mac/Linux: /opt/data/{appId}/config-cache
   Windows: C:\opt\data{appId}\config-cache
7. 修改本地配置不會檢測到實時變化，需要重啟應(yīng)用；

現(xiàn)有項目改造步驟

1. 去掉disconf的依賴，找到對應(yīng)的xml，去掉申明的配置bean;
2. 搜索對應(yīng)的@Disf，如果在類上，直接去掉，如果在方法或者字段上，替換為@Value注解；

3. 增加apollo的xml配置；

   <beans xmlns="http://www.springframework.org/schema/beans"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xmlns:context="http://www.springframework.org/schema/context"
      xmlns:dubbo="http://code.alibabatech.com/schema/dubbo"
      xmlns:apollo="http://www.ctrip.com/schema/apollo"
      xsi:schemaLocation="http://www.springframework.org/schema/beans
                       http://www.springframework.org/schema/beans/spring-beans-4.0.xsd
                       http://www.springframework.org/schema/context
                       http://www.springframework.org/schema/context/spring-context-4.0.xsd
                       http://code.alibabatech.com/schema/dubbo
                       http://files.sports.lifesense.com/xsd/dubbo.xsd
                       http://www.ctrip.com/schema/apollo
                       http://www.ctrip.com/schema/apollo.xsd">
   
   <apollo:config order="1"/>
   <apollo:config order="2" namespaces="lx-doctor.redis,lx-doctor.global,lx-doctor.filesystem,lx-doctor.kafka,lx-doctor.dubbo,log4j2.xml"/>

4. 因為之前的依賴類路徑下存在mysql.properties ; 而apollo沒有生成那么多的文件；
5. 在apollo后臺，從disconf后臺中把項目都有的配置放到application.properties下；
6. 新建私有命名空間 log4j2.xml,把日志配置copy，放到里面發(fā)布；
7. 如有跟公共配置相同的key,需要重寫的，則關(guān)聯(lián)公共命名空間重寫；
8. 啟動程序，解決編譯錯誤；