如何利用apollo实现配置文件的灰度发布？

前言

在上一篇，通过dubbo的版本号控制，我们实现了一个服务的简单的灰度发布过程，在真实的项目环境中，灰度发布的应用场景是很多的，服务接口存在灰度的需求，本篇再介绍另一种比较常见的灰度需求场景，即配置文件的灰度发布

配置文件简介

如今，微服务架构盛行下，不管是互联网大厂，还是规模较小的团队，都有一套自己的中央配置文件管理中心，各个微服务模块都能接入中央配置文件，进行统一的使用，现如今，配置中心的技术选择也是非常丰富的，比如springcloud技术栈下的springcloud-config，springcloud-alibaba下自研的nacos，传统的配置中心disconf，携程出品的apollo等，都是不错的选择

不管外观如何变化，他们的作用都是相同的，那就是统一管理微服务的配置，起到统一管理，统一维护，统一调度的作用

在这种形势下，实际的业务中就出现了这么一种情况，配置管理中心可能存在针对不同环境，比如 dev,test，prod等环境各自的一套配置文件，但实际上，这还是无法满足某些场景下的要求的

举例来说，像上一篇介绍的，服务接口需要做到灰度使用，利用不同的版本号进行控制，从而达到新功能和之前稳定版本功能做到动态切换的效果，而配置文件是控制程序中某些业务的关键信息，同样需要做到类似的功能，这种情况下该如何实现呢？

在一些开源的配置管理技术框架中，它们为了满足这样的需求就实现了类似的灰度发布的功能，本篇将介绍如何利用apollo实现配置文件的灰度发布

apollo简介与快速搭建

关于apollo的介绍，网上有大量的参考和学习资料，主要想说的是，apollo是一款非常好用的配置管理工具，应用于各个大中小型互联网公司，可以无缝整合到很多java框架下，代码侵入性低，而配置文件修改后实时生效是它的一大亮点

快速搭建过程

本篇基于centos7或者阿里云

1、安装java环境

安装JDK1.8及以上（省略）

2、安装mysql

安装mysql5.7及以上（省略）

3、github下载源码包

下载Release版本

其主要的目录文件如上图所示，首先，在mysql中执行下sql目录下的两个sql脚本，apollo的运行依赖数据库

4、将解压后的文件上传至服务器

修改demo.sh，主要修改连接数据库信息

修改内容如下，主要将数据库连接信息配置成自己的数据库IP即可

修改完毕后，启动apollo，只需要执行命令: sh demo.sh start 即可，等待服务启动完毕之后，浏览器访问：http://IP:8070，然后输入默认登录用户名和密码 apollo/admin 即可进入apollo主页面

关于apollo的具体使用本文不做过多赘述，有兴趣的同学可以深入学习

5、apollo创建一个项目

为了后文使用演示，这里快速创建一个app，和一个namespace，创建也非常简单，只需要点击 "创建应用"即可

默认是application应用，当然可以通过创建新的namespace的方式新建一个新的namespace，这个是为了各自的项目管理自身的配置文件进行使用，为了方便测试，这里我们在application应用下，创建了一个叫做dubbo的namespace，随机添加几个配置文件，即key/value的数据

友情提醒：注意appId，工程中后面有使用

以上的准备工作到此结束

演示工程步骤

提前准备一个springboot工程

1、添加核心依赖

主要包括springboot和apollo客户端连接依赖

 

    org.springframework.boot
    spring-boot-starter-web
    2.2.1.RELEASE



    com.ctrip.framework.apollo
    apollo-client
    1.5.1

 

2、配置文件

 

server:
  port: 8001

#连接apollo的配置
app:
  id: provider
apollo:
  meta: http://IP:8080
  bootstrap:
    enabled: true
    namespaces: dubbo

 

3、apollo连接测试

在工程中写一个接口，测试一下是否能从apollo上面读取到配置，测试读取一下下面这个配置

 

@Value("${uyun:default}")
private String uyunname;

@GetMapping("/getUyunName")
public String getUyunName(){
    return uyunname;
}

 

启动项目，浏览器访问一下该接口，可以看到能成功访问到apollo，说明与apollo的整合完毕

如何解决本文开篇谈到的使用apollo实现配置文件的灰度发布呢？回到apollo，我们注意到这里有个“灰度”按钮

这是什么意思呢？简单理解就是，使用这个灰度按钮的功能，可以对当前的配置文件进行一份拷贝，类似备份，同时我们可以对灰度的配置进行添加，修改，删除等操作，而灰度文件的修改不会影响到主配置文件，下面我们对 "dubbo"这个配置文件做一下灰度的配置吧

点击“灰度”

可以看到，灰度创建的内容是对主配置文件的全量拷贝，当然灰度配置也需要像主配置文件那样进行发布之后才能使用的，点击发布，弹出一个需要我们设置灰度规则的框

简单解释下，既然是灰度发布的配置文件，自然不能让所有的客户端访问到，这里apollo提供了几种配置规则方式，这里我选择了直接配置IP的方式，将本机的IP填进去，然后保存，再次发布即可

这个规则的含义就是，当前dubbo的这个灰度配置文件，只能允许我的本机IP进行访问，接下来就让我们做一下验证吧

4、灰度配置测试

在工程中新增一个接口，同时给灰度配置文件中新增2个配置

 

@Value("${name:default}")
  private String uname;

  @Value("${age:default}")
  private String age;

  @GetMapping("/getUyunName")
  public String getUyunName(){
      return uyunname;
  }

 

将本机的其中一个项目启动，访问新增的这个接口，可以发现，能够成功访问到灰度文件中的配置信息

为了验证灰度的功能，我们将项目打成jar包，部署到服务器上，服务器的IP不在灰度配置列表中，理论上是无法访问到 age 这个新增的配置的

成功启动后，浏览器直接访问云服务器上面的这个接口，这时，可以发现，同样的接口，由于IP未配置在灰度规则中，将无法读取到age这个配置的值

踩坑提醒

如果使用的是阿里云或者其他云服务器部署apollo的时候，本地项目连接apollo的时候会一直报apollo的连接超时问题，这个问题的解决办法是，在启动的配置vm中，添加如下参数即可

 

-Dapollo.configService=http://apollo部署的主机IP:8080

 

审核编辑：刘清