ADNC 配置节点详细说明

1. 服务公共配置

adnc\src\Demo\Shared\resources\appsettings.shared.Development.json

1.1 RegisterType

服务注册类型：
- Direct：不进行注册，服务间调用通过 URI 地址，详见 RpcInfo 节点。
- Consul：注册到 Consul，服务间调用通过服务名，详见 RpcInfo 节点。
- CoreDns：注册到 K8S，服务间调用通过 K8S 内部域名，详见 RpcInfo 节点。

"RegisterType": "Direct"

1.2 Basic

Basic 认证信息：服务间调用采用 Basic 认证
- UserName：用户名
- Password：密码

"Basic": {
    "UserName": "adnc",
    "Password": "yvMRER0wzSStw2Va0z59PNQd0lqeMYIP"
}

1.3 RpcInfo

服务调用配置信息：
- Polly:Enable：是否启用 Polly 策略
  - true：启用
  - false：禁用
- Address：服务地址配置
  - Service：服务名称
  - Direct：RegisterType = Direct 时的服务地址
  - Consul：RegisterType = Consul 时的服务地址
  - CoreDns：RegisterType = CoreDns 时的服务地址

"RpcInfo": {
    "Polly": {
        "Enable": false
    },
    "Address": [
        {
            "Service": "adnc-demo-admin-api",
            "Direct": "http://localhost:50010",
            "Consul": "http://adnc-demo-admin-api",
            "CoreDns": "http://adnc-demo-admin-api.default.svc.cluster.local"
        },
        {
            "Service": "adnc-demo-maint-api",
            "Direct": "http://localhost:50020",
            "Consul": "http://adnc-demo-maint-api",
            "CoreDns": "http://adnc-demo-maint-api.default.svc.cluster.local"
        },
        {
            "Service": "adnc-demo-cust-api",
            "Direct": "http://localhost:50030",
            "Consul": "http://adnc-demo-cust-api",
            "CoreDns": "http://adnc-demo-cust-api.default.svc.cluster.local"
        }
    ]
}

1.4 Redis

Redis：缓存数据库配置信息
- Provider：客户端驱动，目前仅支持 StackExchange
- EnableLogging：是否启用日志记录
- SerializerName：序列化方式，支持 json、binary、proto
- EnableBloomFilter：是否启用布隆过滤器
- Dbconfig:ConnectionString：Redis 连接字符串

"Redis": {
    "Provider": "StackExchange",
    "EnableLogging": true,
    "SerializerName": "json",
    "EnableBloomFilter": false,
    "Dbconfig": {
        "ConnectionString": "62.234.187.128:13379,password=football,defaultDatabase=0,ssl=false,sslHost=null,connectTimeout=4000,allowAdmin=true"
    }
}

1.5 Caching

Caching：缓存相关配置信息（依赖 Redis 实现）
- MaxRdSecond：缓存过期时间增加的最大随机秒数，用于防止缓存雪崩
- LockMs：分布式锁定时长（毫秒）
- SleepMs：未获取到分布式锁时的休眠时长（毫秒）
- EnableLogging：是否启用缓存操作日志
- PollyTimeoutSeconds：Polly 超时时间，用于缓存与数据库同步补偿机制
- PenetrationSetting：缓存穿透防护相关配置
  - Disable：是否禁用穿透防护
  - BloomFilterSetting：布隆过滤器配置
    - Name：布隆过滤器名称
    - Capacity：容量
    - ErrorRate：误判率

"Caching": {
    "MaxRdSecond": 30,
    "LockMs": 6000,
    "SleepMs": 300,
    "EnableLogging": true,
    "PollyTimeoutSeconds": 11,
    "PenetrationSetting": {
        "Disable": true,
        "BloomFilterSetting": {
            "Name": "adnc:$SHORTNAME:bloomfilter:cachekeys",
            "Capacity": 10000000,
            "ErrorRate": 0.001
        }
    }
}

1.6 RabbitMQ

RabbitMQ：消息队列配置信息
- HostName：RabbitMQ 主机地址
- Port：端口号
- VirtualHost：虚拟主机名
- UserName：用户名
- Password：密码

"RabbitMq": {
    "HostName": "62.234.187.128",
    "Port": "5672",
    "VirtualHost": "/",
    "UserName": "admin",
    "Password": "football"
}

1.7 SysLogDb

SysLogDb：登录/审计日志数据库配置信息
- DbType：数据库类型，支持 mysql、sqlserver、oracle
- ConnectionString：数据库连接字符串

"SysLogDb": {
    "DbType": "mysql",
    "ConnectionString": "Server=62.234.187.128;Port=13308;database=adnc_syslog;uid=root;pwd=alpha.netcore;connection timeout=30;"
}

1.8 Consul

Consul：服务注册与发现相关配置信息
- ServiceName：服务名称占位符
- ServerTags：服务标签
- HealthCheckUrl：健康检查地址
- HealthCheckIntervalInSecond：健康检查间隔（秒）
- DeregisterCriticalServiceAfter：健康检查失败后注销服务的时间（秒）
- Timeout：超时时间（秒）

"Consul": {
    "ServiceName": "$SERVICENAME",
    "ServerTags": [ "urlprefix-/$SHORTNAME" ],
    "HealthCheckUrl": "$RELATIVEROOTPATH/health-24b01005-a76a-4b3b-8fb1-5e0f2e9564fb",
    "HealthCheckIntervalInSecond": 6,
    "DeregisterCriticalServiceAfter": 20,
    "Timeout": 6
}

1.9 Logging

Logging：日志相关配置信息
- LogContainer：日志记录方式，支持 console、file、loki，分别对应 adnc\src\Demo\Shared\resources\NLog 目录下的配置文件
- LogLevel：日志级别配置
Loki：当 Logging:LogContainer = loki 时，从该节点读取 Loki 连接信息

"Logging": {
    "IncludeScopes": true,
    "LogContainer": "console",
    "LogLevel": {
        "Default": "Information",
        "Adnc": "Debug",
        "Microsoft": "Information"
    }
},
"Loki": {
    "Endpoint": "http://10.2.8.5:3100",
    "UserName": "",
    "Password": ""
}

1.10 CorsHosts

CorsHosts：浏览器跨域域名配置信息，* 表示允许所有域名访问

"CorsHosts": "*"

1.11 JWT

JWT：Token 创建与认证相关配置信息

"JWT": {
    "ValidateIssuer": true,
    "ValidIssuer": "adnc",
    "ValidateIssuerSigningKey": true,
    "SymmetricSecurityKey": "alphadotnetcoresecurity24b010055e0f2e9564fb",
    "ValidateAudience": true,
    "ValidAudience": "manager",
    "ValidateLifetime": true,
    "RequireExpirationTime": true,
    "ClockSkew": 1,
    "RefreshTokenAudience": "manager",
    "Expire": 6000,
    "RefreshTokenExpire": 10080
}

1.12 SkyWalking

SkyWalking：链路跟踪客户端配置信息
- ServiceName：服务名称

"SkyWalking": {
    "ServiceName": "$SERVICENAME",
    "Namespace": "adnc",
    "HeaderVersions": [
        "sw8"
    ],
    "Sampling": {
        "SamplePer3Secs": -1,
        "Percentage": -1.0,
        "IgnorePaths": [ "/*/health-24b01005-a76a-4b3b-8fb1-5e0f2e9564fb", "http://**/appsettings", "/**/swagger.json", "http://**/loki/api/v1/push" ]
    },
    "Logging": {
        "Level": "Error",
        "FilePath": "txtlogs\\skyapm-{Date}.log"
    },
    "Transport": {
        "Interval": 3000,
        "ProtocolVersion": "v8",
        "QueueSize": 30000,
        "BatchSize": 3000,
        "gRPC": {
            "Servers": "62.234.187.128:11800",
            "Timeout": 10000,
            "ConnectTimeout": 10000,
            "ReportTimeout": 600000,
            "Authentication": ""
        }
    }
}

2. 单服务专属配置

以下以 Admin.Api 服务的开发环境和生产环境配置为例：
adnc\src\Demo\Admin.Api\appsettings.Development.json
adnc\src\Demo\Admin.Api\appsettings.Production.json

2.1 `appsettings.Development.json`

ConfigurationType：配置文件类型
- File：服务启动时加载 appsettings.shared.Development.json
Mysql：业务数据库连接信息
Kestrel：服务 URL 与端口配置信息

{
    "ConfigurationType": "File",
    "Mysql": {
        "ConnectionString": "Server=127.0.0.1;Port=13308;database=adnc_admin;uid=root;pwd=alpha.netcore;connection timeout=30;"
    },
    "Kestrel": {
        "Endpoints": {
            "Default": {
                "Url": "http://0.0.0.0:50010"
            },
            "Grpc": {
                "Url": "http://0.0.0.0:50011",
                "Protocols": "Http2"
            }
        }
    }
}

2.2 `appsettings.Production.json`

ConfigurationType：配置文件类型
- Consul：服务启动时从 Consul 获取配置
Consul：Consul 相关配置信息
- ConsulUrl：Consul 服务地址
- ConsulKeyPath：配置信息 Key 路径

{
  "ConfigurationType": "Consul",
  "Consul": {
    "ConsulUrl": "http://10.2.8.5:8500",
    "ConsulKeyPath": "adnc/production/shared/appsettings,adnc/production/$SHORTNAME/appsettings"
  }
}

2.3 获取配置相关代码

public static WebApplicationBuilder AddConfiguration(this WebApplicationBuilder builder, IServiceInfo serviceInfo)
{
    var configurationType = builder.Configuration.GetValue<string>(NodeConsts.ConfigurationType) ?? ConfigurationTypeConsts.File;
    switch (configurationType)
    {
        case ConfigurationTypeConsts.File:
            builder.Configuration.AddJsonFile($"{AppContext.BaseDirectory}/appsettings.shared.{builder.Environment.EnvironmentName}.json", true, true);
            break;
        case ConfigurationTypeConsts.Consul:
            var consulOption = builder.Configuration.GetSection(NodeConsts.Consul).Get<ConsulOptions>();
            if (consulOption is null || consulOption.ConsulKeyPath.IsNullOrWhiteSpace())
            {
                throw new NotImplementedException(NodeConsts.Consul);
            }
            else
            {
                consulOption.ConsulKeyPath = consulOption.ConsulKeyPath.Replace("$SHORTNAME", serviceInfo.ShortName);
                builder.Configuration.AddConsulConfiguration(consulOption, true);
            }
            break;
        case ConfigurationTypeConsts.Nacos:
            throw new NotImplementedException(nameof(ConfigurationTypeConsts.Nacos));
        case ConfigurationTypeConsts.Etcd:
            throw new NotImplementedException(nameof(ConfigurationTypeConsts.Etcd));
        default:
            throw new NotImplementedException(nameof(configurationType));
    }
    
    // ....

    return builder;
}

—— 完 ——

如有帮助，欢迎 Star & Fork。

posted @ 2026-04-27 08:00 风口旁的猪阅读(6) 评论(0) 收藏举报

刷新页面返回顶部

风口旁的猪

代码改变世界，开源推动社区

ADNC 配置节点详细说明

ADNC 配置节点详细说明

1. 服务公共配置

1.1 RegisterType

1.2 Basic

1.3 RpcInfo

1.4 Redis

1.5 Caching

1.6 RabbitMQ

1.7 SysLogDb

1.8 Consul

1.9 Logging

1.10 CorsHosts

1.11 JWT

1.12 SkyWalking

2. 单服务专属配置

2.1 appsettings.Development.json

2.2 appsettings.Production.json

2.3 获取配置相关代码

2.1 `appsettings.Development.json`

2.2 `appsettings.Production.json`