基于Apollo实现.NET Core微服务统一配置(测试环境-单机)

本文涉及的产品
注册配置 MSE Nacos/ZooKeeper,118元/月
服务治理 MSE Sentinel/OpenSergo,Agent数量 不受限
云原生网关 MSE Higress,422元/月
简介: 一、前言注:此篇只是为测试环境下的快速入门。后续会给大家带来生产环境下得实战开发。具体的大家可以去看官方推荐。非常的简单明了。以下介绍引用官方内容:Apollo(阿波罗)是携程框架部门研发的分布式配置中心,能够集中化管理应用不同环境、不同集群的配置,配置修改后能够实时推送到应用端,并且具备规范的权限、流程治理等特性,适用于微服务配置管理场景。

一、前言


注:此篇只是为测试环境下的快速入门。后续会给大家带来生产环境下得实战开发。

具体的大家可以去看官方推荐。非常的简单明了。以下介绍引用官方内容:

Apollo(阿波罗)是携程框架部门研发的分布式配置中心,能够集中化管理应用不同环境、不同集群的配置,配置修改后能够实时推送到应用端,并且具备规范的权限、流程治理等特性,适用于微服务配置管理场景。

服务端基于Spring Boot和Spring Cloud开发,打包后可以直接运行,不需要额外安装Tomcat等应用容器。

Java客户端不依赖任何框架,能够运行于所有Java运行时环境,同时对Spring/Spring Boot环境也有额外支持。

.Net客户端不依赖任何框架,能够运行于所有.Net运行时环境。

官方github地址:https://github.com/ctripcorp/apollo/wiki

 

二、环境介绍及安装Apollo


1、环境介绍

虚拟机服务器:CentOS 7.4

IP地址:192.168.250.131

安装包下载:apollo-build-scripts项目

基础软件环境:       

JAVA JDK 1.8+
Mysql 5.7

 

2、安装Apollo

第一步:JAVA环境安装

A、下载JDK 1.8

命令:

wget --no-check-certificate --no-cookie --header "Cookie: oraclelicense=accept-securebackup-cookie;" http://download.oracle.com/otn-pub/java/jdk/8u181-b13/96a7b8442fe848ef90c96a2fad6ed6d1/jdk-8u181-linux-x64.rpm

如果上述命令无法使用,则直接去oracle网站下载即可。

Oracle地址:https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

 

B、下载压缩包后,我们就要解压JDK即可

rpm -ivh jdk-8u181-linux-x64.rpm

 

C、检查 JDK 是否安装完毕

java -version

 

第二步:安装mysql 5.7

由于 apollo需要的mysql数据版本为5.6.5+,因此安装5.7版本的。

具体原因是:Apollo的表结构对timestamp使用了多个default声明,所以需要5.6.5以上版本。

A、此mysql 我才用docker安装即可。简单方便。

B、安装完成后需要把apollo的两个数据库文件执行以下即可

apolloconfigdb.sql

apolloportaldb.sql

执行完毕后就可以在数据库中看到这两个数据库啦

 

第三步:下载Apollo-build-scripts 项目到服务器上 

文件内容

A、然后修改 项目中的 demo.sh 文件里面的数据库地址即可。

具体如下:

 

 B、然后把demo.sh 项目设置可执行权限

 chmod +x demo.sh

 

C、设置完毕后就启动 demo.sh吧

./demo.sh start

 

 启动完毕:

 

打开地址:192.168.250.131:8070

默认账号和密码: apollo /  admin 

 

登录后就可以看到一个demo。

 

注:如果提示系统出错,请稍后几秒钟重试一下,因为通过Eureka注册的服务有一个刷新的延时。

 

 

第四步:开始创建一个自己的项目配置

注:在接下去的.net core 项目中,我们会把swagger的配置信息配置在apollo上。

A、创建项目

 

B、开始配置我们的namespace.

此处的namespace其实直观说是命名空间,也可以说是 分组。

namespace中有分为  public 和private,公有就是共享的,其他项目可以用,私有就是只有特定的项目可以用。

其实这个分组的概念非常的好,也很清楚的隔开每一个项目配置。

创建我的swagger 私有配置

 

C、然后添加配置,添加配置可以选择文本添加或者按钮添加

添加两个  title和 version。

文本添加或者  按钮点击添加都可以。

 

 

然后选择 “发布”即可。

apollo 配置完毕。接下来就要配置.NET Core项目啦。 

 

三、.NET Core中集成Apollo


1、新建一个.net core项目

在appsettings.json 中添加apollo配置

其中 AppId 是项目的唯一标识,就是我们在apollo上创建项目的唯一标识。

  "apollo": {
    "AppId": "LouieSwaggerDemo",
    "MetaServer": "http://192.168.250.131:8080"
  }

 

 

2、在项目中引入apollo包和 swagger包

然后右键项目 选择“属性” 把 调试改为 swagger

 

 

3、在Program.cs 中注入配置

需要注入我们创建的命名空间哟。并且注入到Configuration 配置中。

 

 

4、在Startup.cs中配置一下swagger的信息

其中 Configuration["XXXXX"]   中的字符串名称是  和apollo上面的我们创建的项目的名称要保持一致。

public void ConfigureServices(IServiceCollection services)
        {
            services.AddSwaggerGen(c =>
            {
                c.SwaggerDoc(Configuration["swagger.version"], new Info
                {
                    Version = Configuration["swagger.version"],
                    Title = Configuration["swagger.title"]
                });
                var basePath = PlatformServices.Default.Application.ApplicationBasePath;
                var xmlPath = Path.Combine(basePath, "ApolloConfigureCenter.xml");
                c.IncludeXmlComments(xmlPath);
            });
            services.AddMvc();
        }

        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }
            app.UseSwagger();
            app.UseSwaggerUI(c =>
            {
                c.SwaggerEndpoint("/swagger/v2/swagger.json", Configuration["swagger.title"]);
            });
            app.UseMvc();
        } 

 

 5、至此,项目配置已搞定。我们就可以运行一下啦。

发现配置应用成功。至此,测试环境-单机搭建已经OK。

 

 

四、总结


apollo配置实在是强大,方便管理我们多个微服务应用配置。用起来也是棒棒的。大家如果有时间可以尝试一下。

此篇为apollo下的测试环境单机部署,如果想要运用到生产环境中,就要用上分布式部署啦,官网上也有介绍。

后续我也会继续给大家带来生产环境中的部署。大家尽情期待吧。

 

五、参考资料


0、本文案例代码:github:https://github.com/LouieGuo/ApolloConfigureCenter_Demo

1、Apollo官方github:WIKI

2、Edison Zhou:.NET Core微服务之基于Apollo实现统一配置中心

3、乔达摩:Asp.Net Core与携程阿波罗(Apollo)的第一次亲密接触

 

asp.net core 交流群:787464275 欢迎加群交流
如果您认为这篇文章还不错或者有所收获,您可以点击右下角的【推荐】按钮精神支持,因为这种支持是我继续写作,分享的最大动力!

作者:LouieGuo
声明:原创博客请在转载时保留原文链接或者在文章开头加上本人博客地址,如发现错误,欢迎批评指正。凡是转载于本人的文章,不能设置打赏功能,如有特殊需求请与本人联系!

微信公众号:欢迎关注                                                 QQ技术交流群: 欢迎加群

                

LouieGuo
相关实践学习
如何在云端创建MySQL数据库
开始实验后,系统会自动创建一台自建MySQL的 源数据库 ECS 实例和一台 目标数据库 RDS。
全面了解阿里云能为你做什么
阿里云在全球各地部署高效节能的绿色数据中心,利用清洁计算为万物互联的新世界提供源源不断的能源动力,目前开服的区域包括中国(华北、华东、华南、香港)、新加坡、美国(美东、美西)、欧洲、中东、澳大利亚、日本。目前阿里云的产品涵盖弹性计算、数据库、存储与CDN、分析与搜索、云通信、网络、管理与监控、应用服务、互联网中间件、移动服务、视频服务等。通过本课程,来了解阿里云能够为你的业务带来哪些帮助     相关的阿里云产品:云服务器ECS 云服务器 ECS(Elastic Compute Service)是一种弹性可伸缩的计算服务,助您降低 IT 成本,提升运维效率,使您更专注于核心业务创新。产品详情: https://www.aliyun.com/product/ecs
目录
相关文章
|
2月前
|
测试技术 持续交付 API
深入挖掘探索.NET单元测试
【10月更文挑战第11天】
38 2
|
2月前
|
XML JSON API
ServiceStack:不仅仅是一个高性能Web API和微服务框架,更是一站式解决方案——深入解析其多协议支持及简便开发流程,带您体验前所未有的.NET开发效率革命
【10月更文挑战第9天】ServiceStack 是一个高性能的 Web API 和微服务框架,支持 JSON、XML、CSV 等多种数据格式。它简化了 .NET 应用的开发流程,提供了直观的 RESTful 服务构建方式。ServiceStack 支持高并发请求和复杂业务逻辑,安装简单,通过 NuGet 包管理器即可快速集成。示例代码展示了如何创建一个返回当前日期的简单服务,包括定义请求和响应 DTO、实现服务逻辑、配置路由和宿主。ServiceStack 还支持 WebSocket、SignalR 等实时通信协议,具备自动验证、自动过滤器等丰富功能,适合快速搭建高性能、可扩展的服务端应用。
124 3
|
3月前
|
算法 安全 Java
微服务(四)-config配置中心的配置加解密
微服务(四)-config配置中心的配置加解密
|
3月前
|
消息中间件 监控 开发工具
微服务(三)-实现自动刷新配置(不重启项目情况下)
微服务(三)-实现自动刷新配置(不重启项目情况下)
|
22天前
|
网络安全 Nacos 开发者
Nacos作为流行的微服务注册与配置中心,“节点提示暂时不可用”是常见的问题之一
Nacos作为流行的微服务注册与配置中心,其稳定性和易用性备受青睐。然而,“节点提示暂时不可用”是常见的问题之一。本文将探讨该问题的原因及解决方案,帮助开发者快速定位并解决问题,确保服务的正常运行。通过检查服务实例状态、网络连接、Nacos配置、调整健康检查策略等步骤,可以有效解决这一问题。
34 4
|
22天前
|
Java 网络安全 Nacos
Nacos作为流行的微服务注册与配置中心,其稳定性和易用性备受青睐。
Nacos作为流行的微服务注册与配置中心,其稳定性和易用性备受青睐。然而,实际使用中常遇到“客户端不发送心跳检测”的问题。本文深入探讨该问题的原因及解决方案,帮助开发者快速定位并解决问题,确保服务正常运行。通过检查客户端配置、网络连接、日志、版本兼容性、心跳策略、注册状态、重启应用和环境变量等步骤,系统地排查和解决这一问题。
45 3
|
22天前
|
安全 Nacos 数据库
Nacos是一款流行的微服务注册与配置中心,但直接暴露在公网中可能导致非法访问和数据库篡改
Nacos是一款流行的微服务注册与配置中心,但直接暴露在公网中可能导致非法访问和数据库篡改。本文详细探讨了这一问题的原因及解决方案,包括限制公网访问、使用HTTPS、强化数据库安全、启用访问控制、监控和审计等步骤,帮助开发者确保服务的安全运行。
29 3
|
27天前
|
Web App开发 定位技术 iOS开发
Playwright 是一个强大的工具,用于在各种浏览器上测试应用,并模拟真实设备如手机和平板。通过配置 `playwright.devices`,可以轻松模拟不同设备的用户代理、屏幕尺寸、视口等特性。此外,Playwright 还支持模拟地理位置、区域设置、时区、权限(如通知)和配色方案,使测试更加全面和真实。例如,可以在配置文件中设置全局的区域设置和时区,然后在特定测试中进行覆盖。同时,还可以动态更改地理位置和媒体类型,以适应不同的测试需求。
Playwright 是一个强大的工具,用于在各种浏览器上测试应用,并模拟真实设备如手机和平板。通过配置 `playwright.devices`,可以轻松模拟不同设备的用户代理、屏幕尺寸、视口等特性。此外,Playwright 还支持模拟地理位置、区域设置、时区、权限(如通知)和配色方案,使测试更加全面和真实。例如,可以在配置文件中设置全局的区域设置和时区,然后在特定测试中进行覆盖。同时,还可以动态更改地理位置和媒体类型,以适应不同的测试需求。
32 1
|
2月前
|
测试技术 API 开发者
精通.NET单元测试:MSTest、xUnit、NUnit全面解析
【10月更文挑战第15天】本文介绍了.NET生态系统中最流行的三种单元测试框架:MSTest、xUnit和NUnit。通过示例代码展示了每种框架的基本用法和特点,帮助开发者根据项目需求和个人偏好选择合适的测试工具。
40 3
|
16天前
|
开发框架 安全 .NET
.NET使用Moq开源模拟库简化单元测试
.NET使用Moq开源模拟库简化单元测试~