ABP微服务系列学习-对接Apollo配置中心

柔光的暖阳◎ 2024-03-16 15:58 7阅读 0赞

前面我们把服务都已经成功启动，并且对接前端Angular界面。  
但是在微服务结构中，多个服务意味着需要配置多个配置文件，这时就需要引入配置中心这玩意了。  
配置中心有很多现成的方案，比如携程的阿波罗，K8S自带的ConfigMap等等。  
这里介绍一下如何对接携程的阿波罗配置中心。

### 部署Apollo服务[\#][Link 1] ###

在开发环境，我们可以使用Docker一键搭建我们Apollo服务。  
安装部署过程直接看官方文档[Apollo][]  
这里就不赘述了。  
使用docker-compsoe up启动服务后看到日志说明启动成功。

apollo-quick-start    | Started [66]
    apollo-quick-start    | Waiting for config service startup...
    apollo-quick-start    | Config service started. You may visit http://localhost:8080 for service status now!
    apollo-quick-start    | Waiting for admin service startup.
    apollo-quick-start    | Admin service started
    apollo-quick-start    | ==== starting portal ====
    apollo-quick-start    | Portal logging file is ./portal/apollo-portal.log
    apollo-quick-start    | Application is running as root (UID 0). This is considered insecure.
    apollo-quick-start    | Started [247]
    apollo-quick-start    | Waiting for portal startup...
    apollo-quick-start    | Portal started. You can visit http://localhost:8070 now!

浏览器打开http://localhost:8080或者http://127.0.0.1:8080可以看到界面

![254a08e122557579cdcde2987571414b.png][]

浏览器打开http://localhost:8070或者http://127.0.0.1:8070可以看到管理界面

### 添加配置[\#][Link 2] ###

在管理界面输入账号apollo，密码admin即可进入管理后台。  
然后我们根据服务创建应用，每一个服务对应一个应用

![e496ae79770943cf4da760ec2f0f5218.png][]

这里按照服务创建了5个应用

#### 删除默认Namespcae[\#][Link 3] ####

点击应用名称进去应用管理，先删除默认自带的Namespace application，因为默认的Namespace是properties类型，不符合我们JSON的配置。虽然能读取，但是识别内容都是字符串。

![e856e63641acbfa007dfcf5a9f775968.png][]

#### 创建新的Namespace[\#][Link 4] ####

在应用管理界面左下角，可以看到添加Namespace的按钮，点击添加Namespace。

![ccb98a4d584955b226eb707f05e76637.png][]

然后输入我们的配置名称，以及配置类型，配置类型选择JSON  
  
创建完成后我们返回应用管理页面修改配置，把我们服务中appsettings.json文件内容复制到配置里面。  
  
网关服务的配置，多个配置文件就添加多个Namespace  
  
这里每一个Namespace就相当于一个文件的概念。  
更详细的说明可以看官网文档介绍 [Apollo][Apollo 1]

#### 发布配置[\#][Link 5] ####

修改配置内容后，一定要点击发布，不然配置不会生效。

### 微服务对接Apollo配置中心[\#][Link 6] ###

#### 安装nuget[\#][Link 7] ####

Apollo官网有.net的sdk，nuget包名字是Com.Ctrip.Framework.Apollo.Configuration。  
在微服务shared模块的FunShow.Shared.Hosting.AspNetCore项目中添加Com.Ctrip.Framework.Apollo.Configuration引用。

#### 配置[\#][Link 8] ####

然后封装一下IHostBuilder的扩展方法

using Microsoft.Extensions.Configuration;
    using Microsoft.Extensions.Hosting;
    
    namespace FunShow.Shared.Hosting.AspNetCore
    {
    public static class ApolloConfigurationExtension
        {
            public static IHostBuilder UseApollo(this IHostBuilder builder)
            {
                return builder
                    .ConfigureAppConfiguration((config) =>
                    {
                        config.AddApollo(config.Build().GetSection("apollo"));
                    });
            }
        }
    }

然后在每个服务的Program代码中的HostBuilder添加UseApollo方法

var builder = WebApplication.CreateBuilder(args);
                builder.Host
                    .AddAppSettingsSecretsJson()
                    .UseAutofac()
                    .UseApollo() //添加Apollo配置中心
                    .UseSerilog();

最后修改每个服务的appsettings.json文件，只需要配置apollo的参数，比如:

{
      "apollo": {
        "AppId": "FunShowWebGateway",
        "ConfigServer": [ "http://localhost:8080" ],
        "Namespaces": [ "appsettings.json", "yarp.json" ]
      }
    }

这里AppId指的是我们创建应用时指定的AppId。  
ConfigServer是请求配置中心的服务地址，注意不是8070端口，8070是管理后台的端口。  
Namespaces则是指明我们需要加载的配置文件名称。  
为什么不是appsettings而是appsettings.json呢，我们上面创建的Namespaces明明只是写了名字是appsettings。  
因为这里的.json是向底层说明我们这个文件用json格式解析，如果不加.json后缀，则默认使用properties格式解析内容，官方默认支持json和xml后缀的文件解析。别的后缀可以自行扩展。

### 启动服务[\#][Link 9] ###

所有配置都发布以及我们的服务代码都修改完成后，我们就可以尝试启动服务啦~  
执行我们的run-tye.ps1脚本，可以看到服务全部正常启动。

![246998928f1664ceacd11adea63bad89.png][]

这里就不上那么多图片了，稍微放两个图就可以了。  
好了，到这我们就成功接入apollo配置中心了。

[Link 1]: https://www.cnblogs.com/fanshaoO/p/17192180.html#%E9%83%A8%E7%BD%B2apollo%E6%9C%8D%E5%8A%A1
[Apollo]: https://www.apolloconfig.com/#/zh/deployment/quick-start-docker
[254a08e122557579cdcde2987571414b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/9eb354be870f49c7b8bc098153744f2e.png
[Link 2]: https://www.cnblogs.com/fanshaoO/p/17192180.html#%E6%B7%BB%E5%8A%A0%E9%85%8D%E7%BD%AE
[e496ae79770943cf4da760ec2f0f5218.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/ad54c6d0e05d46d28eabf6f2807aea30.png
[Link 3]: https://www.cnblogs.com/fanshaoO/p/17192180.html#%E5%88%A0%E9%99%A4%E9%BB%98%E8%AE%A4namespcae
[e856e63641acbfa007dfcf5a9f775968.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/84175d71f14c49aea6d1da062f277c32.png
[Link 4]: https://www.cnblogs.com/fanshaoO/p/17192180.html#%E5%88%9B%E5%BB%BA%E6%96%B0%E7%9A%84namespace
[ccb98a4d584955b226eb707f05e76637.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/2c9bc530289944aabe78f14bbfb46061.png
[Apollo 1]: https://www.apolloconfig.com/#/zh/design/apollo-core-concept-namespace?id=_1-%E4%BB%80%E4%B9%88%E6%98%AFnamespace
[Link 5]: https://www.cnblogs.com/fanshaoO/p/17192180.html#%E5%8F%91%E5%B8%83%E9%85%8D%E7%BD%AE
[Link 6]: https://www.cnblogs.com/fanshaoO/p/17192180.html#%E5%BE%AE%E6%9C%8D%E5%8A%A1%E5%AF%B9%E6%8E%A5apollo%E9%85%8D%E7%BD%AE%E4%B8%AD%E5%BF%83
[Link 7]: https://www.cnblogs.com/fanshaoO/p/17192180.html#%E5%AE%89%E8%A3%85nuget
[Link 8]: https://www.cnblogs.com/fanshaoO/p/17192180.html#%E9%85%8D%E7%BD%AE
[Link 9]: https://www.cnblogs.com/fanshaoO/p/17192180.html#%E5%90%AF%E5%8A%A8%E6%9C%8D%E5%8A%A1
[246998928f1664ceacd11adea63bad89.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/e1543c68a8674915959f46b1204e9b8b.png