.NET Core 6 使用 Nacos
简介
Nacos 是 Dynamic Naming and Configuration Service的首字母简称,一个更易于构建云原生应用的动态服务发现、配置管理和服务管理平台。
Nacos 致力于帮助您发现、配置和管理微服务。Nacos 提供了一组简单易用的特性集,帮助您快速实现动态服务发现、服务配置、服务元数据及流量管理。
Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。 Nacos 是构建以“服务”为中心的现代应用架构 (例如微服务范式、云原生范式) 的服务基础设施。
相关地址:
特性
-
服务发现和服务健康监测
Nacos 支持基于 DNS 和基于 RPC 的服务发现。服务提供者使用 原生SDK、OpenAPI、或一个独立的Agent TODO注册 Service 后,服务消费者可以使用DNS TODO 或HTTP&API查找和发现服务。
Nacos 提供对服务的实时的健康检查,阻止向不健康的主机或服务实例发送请求。Nacos 支持传输层 (PING 或 TCP)和应用层 (如 HTTP、MySQL、用户自定义)的健康检查。 对于复杂的云环境和网络拓扑环境中(如 VPC、边缘网络等)服务的健康检查,Nacos 提供了 agent 上报模式和服务端主动检测2种健康检查模式。Nacos 还提供了统一的健康检查仪表盘,帮助您根据健康状态管理服务的可用性及流量。
-
动态配置服务
动态配置服务可以让您以中心化、外部化和动态化的方式管理所有环境的应用配置和服务配置。
动态配置消除了配置变更时重新部署应用和服务的需要,让配置管理变得更加高效和敏捷。
配置中心化管理让实现无状态服务变得更简单,让服务按需弹性扩展变得更容易。
Nacos 提供了一个简洁易用的UI (控制台样例 Demo) 帮助您管理所有的服务和应用的配置。Nacos 还提供包括配置版本跟踪、金丝雀发布、一键回滚配置以及客户端配置更新状态跟踪在内的一系列开箱即用的配置管理特性,帮助您更安全地在生产环境中管理配置变更和降低配置变更带来的风险。
-
动态 DNS 服务
动态 DNS 服务支持权重路由,让您更容易地实现中间层负载均衡、更灵活的路由策略、流量控制以及数据中心内网的简单DNS解析服务。动态DNS服务还能让您更容易地实现以 DNS 协议为基础的服务发现,以帮助您消除耦合到厂商私有服务发现 API 上的风险。
Nacos 提供了一些简单的 DNS APIs TODO 帮助您管理服务的关联域名和可用的 IP:PORT 列表.
-
服务及其元数据管理
Nacos 能让您从微服务平台建设的视角管理数据中心的所有服务及元数据,包括管理服务的描述、生命周期、服务的静态依赖分析、服务的健康状态、服务的流量管理、路由及安全策略、服务的 SLA 以及最首要的 metrics 统计数据。
部署
Nacos 容器端口
端口 | 与主端口(8848)偏移量 | 作用 |
---|---|---|
8848 | Http端口,主端口 | |
9848 | 1000 | 客户端gRPC请求服务端口,用户客户端向服务端发起连接和请求 |
9849 | 1001 | 服务端gRPC请求服务端口,用于服务间同步等 |
Derby存储
Nacos 默认使用嵌入式数据库(derby)实现数据的存储
docker run --env MODE=standalone --name nacos -d -p 8848:8848 -p 9848:9848 nacos/nacos-server
Mysql存储
Mysql部署这里不多描述了(推荐8.0版本)。
创建Mysql数据库
CREATE DATABASE IF NOT EXISTS nacos DEFAULT CHARACTER SET utf8mb4 DEFAULT COLLATE utf8mb4_unicode_ci;
在nacos
数据库中执行以下任一脚本
Run容器,注意修改相关配置
docker run -d -p 8848:8848 -p 9848:9848 -p 9849:9849 --privileged=true -e JVM_XMS=256m -e JVM_XMX=256m -e MODE=standalone -e PREFER_HOST_MODE=hostname -e SPRING_DATASOURCE_PLATFORM=mysql -e MYSQL_SERVICE_HOST=172.28.27.140 -e MYSQL_SERVICE_PORT=3306 -e MYSQL_SERVICE_USER=root -e MYSQL_SERVICE_PASSWORD=123456 -e MYSQL_SERVICE_DB_NAME=nacos_config --name nacos nacos/nacos-server:latest
进入容器查看相关配置
docker exec -it nacos bash
cat /home/nacos/conf/application.properties
--如果数据库配置不对,可以参考以下配置以下配置修改 db.url.0 & db.url.1
db.url.0=jdbc:mysql://localhost:3306/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC
修改Mysql数据库配置环境变量信息
--停止容器
docker stop nacos
--停止Docker服务
service docker stop
--修改配置
cat /var/lib/docker/containers/ContainersID/config.v2.json
--启动服务
service docker start
--启动容器
docker start nacos
访问
Web UI主页访问地址:http://host:8848/nacos
http://192.168.1.5:8848/nacos
用户名密码使用nacos/nacos
登录首页
添加配置
添加值然后发布
发布后可以在主页查看
添加命名空间
ASP .NET Core 集成
安装以下Nuget包
nacos-sdk-csharp.AspNetCore
nacos-sdk-csharp.Extensions.Configuration
在appsettings.json
中添加nacos
配置。配置值可以添加多个。服务发现这里不多描述。
{
"Nacos": {
"ServerAddresses": [ "http://192.168.1.5:8848/" ],
//命名空间GUID,public默认没有
"Namespace": "",
"UserName": "nacos",
"Password": "nacos",
// 配置中心
"Listeners": [
{
"Group": "testgroup",
"DataId": "testdataid",
"Optional": false
},
{
"Group": "NET",
"DataId": "netapp",
"Optional": false
},
{
"Group": "NET",
"DataId": "common",
"Optional": false
}
],
// 服务发现
"ServiceName": "net-service",
"GroupName": "NET"
}
}
添加nacos
服务
// 注册服务到Nacos
builder.Services.AddNacosAspNet(builder.Configuration, section: "Nacos");
// 添加配置中心
builder.Configuration.AddNacosV2Configuration(builder.Configuration.GetSection("Nacos"));
Controller
读取配置
using Microsoft.AspNetCore.Mvc;
namespace WebApplication2.Controllers
{
[ApiController]
[Route("[controller]")]
public class WeatherForecastController : ControllerBase
{
private IConfiguration _configuration;
public WeatherForecastController(IConfiguration configuration) => _configuration = configuration;
[HttpGet]
public string Get() => _configuration["LogConfig"];
}
}
服务列表