Apollo学习（一）Apollo初学入门

ゝ一世哀愁。 2022-06-01 08:53 269阅读 0赞

前言

最近公司项目开始用微服务相关的技术设计apollo，自己也是初学者就边学边总结， [部分内容来自官网][Link 1]，大牛请便。

## 1.1 背景 ##

随着程序功能的日益复杂，程序的配置日益增多：各种功能的开关、参数的配置、服务器的地址……

对程序配置的期望值也越来越高：配置修改后实时生效，灰度发布，分环境、分集群管理配置，完善的权限、审核机制……

在这样的大环境下，传统的通过配置文件、数据库等方式已经越来越无法满足开发人员对配置管理的需求。

Apollo配置中心应运而生！

## 1.2 Apollo简介 ##

Apollo（阿波罗）是携程框架部门研发的开源配置管理中心，能够集中化管理应用不同环境、不同集群的配置，配置修改后能够实时推送到应用端，并且具备规范的权限、流程治理等特性。

Apollo支持4个维度管理Key-Value格式的配置：

1.  application (应用)
2.  environment (环境)
3.  cluster (集群)
4.  namespace (命名空间)

同时，Apollo基于开源模式开发，开源地址：[https://github.com/ctripcorp/apollo][https_github.com_ctripcorp_apollo]

# 2、Why Apollo #

正是基于配置的特殊性，所以Apollo从设计之初就立志于成为一个有治理能力的配置发布平台，目前提供了以下的特性：

*  统一管理不同环境、不同集群的配置
    
     *  Apollo提供了一个统一界面集中式管理不同环境（environment）、不同集群（cluster）、不同命名空间（namespace）的配置。
     *  同一份代码部署在不同的集群，可以有不同的配置，比如zookeeper的地址等
     *  通过命名空间（namespace）可以很方便地支持多个不同应用共享同一份配置，同时还允许应用对共享的配置进行覆盖
 *  配置修改实时生效（热发布）
    
     *  用户在Apollo修改完配置并发布后，客户端能实时（1秒）接收到最新的配置，并通知到应用程序
 *  版本发布管理
    
     *  所有的配置发布都有版本概念，从而可以方便地支持配置的回滚
 *  灰度发布
    
     *  支持配置的灰度发布，比如点了发布后，只对部分应用实例生效，等观察一段时间没问题后再推给所有应用实例
 *  权限管理、发布审核、操作审计
    
     *  应用和配置的管理都有完善的权限管理机制，对配置的管理还分为了编辑和发布两个环节，从而减少人为的错误。
     *  所有的操作都有审计日志，可以方便地追踪问题
 *  客户端配置信息监控
    
     *  可以在界面上方便地看到配置在被哪些实例使用
 *  提供Java和.Net原生客户端
    
     *  提供了Java和.Net的原生客户端，方便应用集成
     *  支持Spring Placeholder, Annotation和Spring Boot的ConfigurationProperties，方便应用使用（需要Spring 3.1.1+）
     *  同时提供了Http接口，非Java和.Net应用也可以方便地使用
 *  提供开放平台API
    
     *  Apollo自身提供了比较完善的统一配置管理界面，支持多环境、多数据中心配置管理、权限、流程治理等特性。不过Apollo出于通用性考虑，不会对配置的修改做过多限制，只要符合基本的格式就能保存，不会针对不同的配置值进行针对性的校验，如数据库用户名、密码，Redis服务地址等
     *  对于这类应用配置，Apollo支持应用方通过开放平台API在Apollo进行配置的修改和发布，并且具备完善的授权和权限控制
 *  部署简单
    
     *  配置中心作为基础服务，可用性要求非常高，这就要求Apollo对外部依赖尽可能地少
     *  目前唯一的外部依赖是MySQL，所以部署非常简单，只要安装好Java和MySQL就可以让Apollo跑起来
     *  Apollo还提供了打包脚本，一键就可以生成所有需要的安装包，并且支持自定义运行时参数

# 3、Apollo at a glance #

## 3.1 基础模型 ##

如下即是Apollo的基础模型：

1.  用户在配置中心对配置进行修改并发布
2.  配置中心通知Apollo客户端有配置更新
3.  Apollo客户端从配置中心拉取最新的配置、更新本地配置并通知到应用

![basic-architecture][]

## 3.2 界面概览 ##

![apollo-home-screenshot][]

上图是Apollo配置中心中一个项目的配置首页

*  在页面左上方的环境列表模块展示了所有的环境和集群，用户可以随时切换。
 *  页面中央展示了两个namespace(application和FX.apollo)的配置信息，默认按照表格模式展示、编辑。用户也可以切换到文本模式，以文件形式查看、编辑。
 *  页面上可以方便地进行发布、回滚、灰度、授权、查看更改历史和发布历史等操作

## 3.3 添加/修改配置项 ##

用户可以通过配置中心界面方便的添加/修改配置项，更多使用说明请参见[应用接入指南][Link 2]

![edit-item-entry][]

输入配置信息：

![edit-item][]

## 3.4 发布配置 ##

通过配置中心发布配置：

![publish-items][]

填写发布信息：

![publish-items][publish-items 1]

## 3.5 客户端监听配置变化（Java API样例） ##

配置发布后，就能在客户端获取到了，以Java为例，获取配置的示例代码如下。Apollo客户端还支持和Spring整合，更多客户端使用说明请参见[Java客户端使用指南][Java]和[.Net客户端使用指南][.Net]。

Config config = ConfigService.getAppConfig();
    Integer defaultRequestTimeout = 200;
    Integer requestTimeout = config.getIntProperty("requestTimeout", defaultRequestTimeout);

## 3.6 客户端监听配置变化 ##

通过上述获取配置代码，应用就能实时获取到最新的配置了。

不过在某些场景下，应用还需要在配置变化时获得通知，比如数据库连接的切换等，所以Apollo还提供了监听配置变化的功能，Java示例如下：

Config config = ConfigService.getAppConfig();
    config.addChangeListener(new ConfigChangeListener() {
      @Override
      public void onChange(ConfigChangeEvent changeEvent) {
        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()));
         }
      }
    });

## 3.7 Spring集成样例 ##

Apollo和Spring也可以很方便地集成，只需要标注`@EnableApolloConfig`后就可以通过`@Value`获取配置信息：

@Configuration
    @EnableApolloConfig
    public class AppConfig {}

@Component
    public class SomeBean {
        @Value("${request.timeout:200}")
        private int timeout;
    
        @ApolloConfigChangeListener
        private void someChangeHandler(ConfigChangeEvent changeEvent) {
            if (changeEvent.isChanged("request.timeout")) {
                refreshTimeout();
            }
        }
    }

[Link 1]: https://github.com/ctripcorp/apollo/wiki/Apollo%E9%85%8D%E7%BD%AE%E4%B8%AD%E5%BF%83%E4%BB%8B%E7%BB%8D?spm=a2c4e.11153940.blogcont74601.16.1b034f36HWlAZj#1what-is-apollo
[https_github.com_ctripcorp_apollo]: https://github.com/ctripcorp/apollo
[basic-architecture]: /images/20220601/e002aa7034664a02af9efc630620cf31.png
[apollo-home-screenshot]: /images/20220601/fe120917cec84cfb9fe815764ee8471f.png
[Link 2]: https://github.com/ctripcorp/apollo/wiki/%E5%BA%94%E7%94%A8%E6%8E%A5%E5%85%A5%E6%8C%87%E5%8D%97
[edit-item-entry]: https://github.com/ctripcorp/apollo/raw/master/doc/images/edit-item-entry.png
[edit-item]: https://github.com/ctripcorp/apollo/raw/master/doc/images/edit-item.png
[publish-items]: https://github.com/ctripcorp/apollo/raw/master/doc/images/publish-items-entry.png
[publish-items 1]: https://github.com/ctripcorp/apollo/raw/master/doc/images/publish-items.png
[Java]: https://github.com/ctripcorp/apollo/wiki/Java%E5%AE%A2%E6%88%B7%E7%AB%AF%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97
[.Net]: https://github.com/ctripcorp/apollo/wiki/.Net%E5%AE%A2%E6%88%B7%E7%AB%AF%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97