需求背景
项目中快速集成配置中心·Nacos服务注册发现功能
Tips技术点
1. @EnableDiscoveryClient注解
- 启用Nacos服务注册发现功能
2. 区分不同环境,实现服务注册发现功能
- 登录Nacos控制台,新增dev / test / prod三套不同环境,分别对应:开发环境 / 测试环境 / 生产环境
- 对控制台不熟,阅读教程:SpringCloud Alibaba从入门到精通教程(一)- 配置中心Nacos快速入门介绍·Server启动安装)
代码演示
1. 项目目录结构
2. pom.xml依赖组件
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<artifactId>microservice-alibaba-nacos-discovery</artifactId>
<packaging>jar</packaging>
<parent>
<groupId>com.minbo.cloud.alibaba</groupId>
<artifactId>spring-cloud-alibaba-study-parent</artifactId>
<version>0.0.1-SNAPSHOT</version>
</parent>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
</dependency>
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>swagger-bootstrap-ui</artifactId>
</dependency>
<!-- 服务注册发现功能 -->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>
</dependencies>
</project>
3. bootstrap.yaml配置文件
这里的namespace值,使用的是:dev环境对应的命名空间id值
spring:
application:
name: microservice-alibaba-nacos-discovery
profiles:
active: dev
cloud:
nacos:
discovery:
server-addr: 127.0.0.1:8848
namespace: 2bc5565f-453f-4b1c-bde4-eafe23bdb2f0
# server
server:
port: 9090
4. 启动类
添加@EnableDiscoveryClient注解
package com.minbo.cloud.alibaba;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import com.github.xiaoymin.swaggerbootstrapui.annotations.EnableSwaggerBootstrapUI;
/**
* 程序主入口
*
* @author Minbo
*
*/
@SpringBootApplication
@EnableSwaggerBootstrapUI
@EnableDiscoveryClient
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
5. 服务注册是否成功
启动项目后,可以在dev命名空间下,发现此服务,代表服务注册发现功能生效了
可以点击“详情”,查看更多信息。还能进行“下线”操作功能等
区分不同环境用法
1. 使用配置文件:bootstrap.yaml.bak
把上面的bootstrap.yaml重命名成bootstrap.yaml2,把bootstrap.yaml.bak命名成bootstrap.yaml
# 不同的环境使用不同的配置,通过指定启动参数使用不同的profile,比如:
# 开发环境:java -jar xxx.jar --spring.profiles.active=dev
# 生产环境:java -jar xxx.jar --spring.profiles.active=prod
spring:
application:
name: microservice-alibaba-nacos-discovery
profiles:
active: test
# server
server:
port: 9090
#下面这一行务必不能少,区分不同环境配置,而且必须是三个字符"-"
---
spring:
profiles: dev
cloud:
nacos:
discovery:
server-addr: 127.0.0.1:8848
namespace: 2bc5565f-453f-4b1c-bde4-eafe23bdb2f0
---
spring:
profiles: test
cloud:
nacos:
discovery:
server-addr: 127.0.0.1:8848
namespace: 47247e4c-b018-4c63-92cd-ebbc119eef7f
---
spring:
profiles: prod
cloud:
nacos:
discovery:
server-addr: 127.0.0.1:8848
namespace: 9d3bb62a-14c5-43aa-ac05-6576caa5be2b
2. 通过profiles.active激活不同环境配置
如使用:test,可以看到服务已经注册到此命名空间下了,而dev下消失了
3. 脚本启动服务包
不同的环境使用不同的配置,通过指定启动参数使用不同的profile,比如:
- 开发环境:java -jar xxx.jar --spring.profiles.active=dev
- 生产环境:java -jar xxx.jar --spring.profiles.active=prod
可以进到此项目根目录下,执行:
java -jar target/microservice-alibaba-nacos-discovery.jar --spring.profiles.active=test
可以看到,此profiles.active=test配置已经生效了,也可以在test命名空间下看到此服务注册成功了
注:也可以通过环境变量的方式导入这些值,比如server-addr值、namespace值等
完整源码下载
其他技术
此项目代码案例中,还集成了以下功能:
1. 开发代码规范
- 使用lombok组件,让代码更简洁,实现优雅编码
2. 集成swagger
十分简单、简洁易用的在线接口文档组件swagger
Swagger入门教程用法:SpringBoot从入门到精通教程(二十四)- Swagger集成用法
下一章教程
SpringCloud Alibaba从入门到精通教程(三)- 项目中快速集成配置中心·Nacos配置中心管理功能
该系列教程
我的专栏
至此,全部介绍就结束了
-------------------------------
-------------------------------
关于我(个人域名)
期望和大家一起学习,一起成长,共勉,O(∩_∩)O谢谢
欢迎交流问题,可加个人QQ 469580884,
或者,加我的群号 751925591,一起探讨交流问题
不讲虚的,只做实干家
Talk is cheap,show me the code