Skip to content

如何快速规避使用上的坑

HaojunRen edited this page May 31, 2024 · 3 revisions

服务名大小写规则

  • 在配置文件(application.properties、application.yaml等)里,定义服务名(spring.application.name)不区分大小写,但强烈建议小写
  • 在规则文件(Xml、Json)里,涉及的服务名必须小写
  • 在传递的n-d-开头的参数(Header、Parameter和Cookie)里,涉及的服务名必须小写
  • 在Nacos、Apollo、Consul、Etcd、Redis、Zookeeper等远程配置中心的Key,涉及的服务名必须小写

上述服务名大小写规则,适用于所有文档

规则策略配置和业务配置的关系

规则策略配置和业务配置没有任何关系,两者基于不同的底层而实现的

  • 规则策略配置基于Nacos Client底层而扩展,用法非常简单,如果网关名或者服务名叫a-service,元数据组metadata.group=b-group,对应到Nacos配置中心,该配置的DataId为a-service,Group=b-group
  • 业务配置基于如下依赖而进行,Nepxion Discovery默认并没有引入如下依赖,需要使用者自行引入,用法非常丰富,使用上在集成Nepxion Discovery前后无任何差异
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>

网关控制逻辑

极简版指南示例,分支为6.x.x-simple,提供的代码,需要注意如下逻辑

  • 网关支持任何自定义业务的Header传入,但缺省默认拒绝前端n-d-xxx的Header传入,该设计的初衷是在生产环境下,前端人员可能并不了解后端服务部署的情况,由前端管控后端服务蓝绿灰度发布,存在一定的风险,故默认关闭,只能通过在配置中心配置规则策略的方式来实施。如果希望接受n-d-version传入,用法请参考如何设置全链路蓝绿灰度发布由前端或者网关来执行
  • 最佳做法是业务的Header通过配置中心配置的规则策略,转化成n-d-xxx的Header,进行全链路传递




2017-2050 ©Nepxion Studio Apache License

           

Total visits

讲义篇

集成篇

概念篇

实践篇

功能篇

配置篇

扩展篇

测试篇

升级篇

贡献篇

Clone this wiki locally