SpringCloud Alibaba从入门到精通教程（二）- 项目中快速集成配置中心·Nacos服务注册发现功能

本是古典何须时尚 2023-07-25 11:20 85阅读 0赞

# 需求背景 #

> 项目中快速集成配置中心·Nacos服务注册发现功能

# Tips技术点 #

**1. **@EnableDiscoveryClient注解

*  启用Nacos服务注册发现功能

2. 区分不同环境，实现服务注册发现功能

*  登录Nacos控制台，新增dev / test / prod三套不同环境，分别对应：开发环境 / 测试环境 / 生产环境
 *  对控制台不熟，阅读教程：[SpringCloud Alibaba从入门到精通教程（一）- 配置中心Nacos快速入门介绍·Server启动安装][SpringCloud Alibaba_- _Nacos_Server]）

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hlbWluMTAwMw_size_16_color_FFFFFF_t_70][]

# **代码演示** #

## 1. 项目目录结构 ##

**![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hlbWluMTAwMw_size_16_color_FFFFFF_t_70 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命名空间下，发现此服务，代表服务注册发现功能生效了

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hlbWluMTAwMw_size_16_color_FFFFFF_t_70 2][]

可以点击“详情”，查看更多信息。还能进行“下线”操作功能等

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hlbWluMTAwMw_size_16_color_FFFFFF_t_70 3][]

# 区分不同环境用法 #

## 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下消失了

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hlbWluMTAwMw_size_16_color_FFFFFF_t_70 4][]

## 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

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hlbWluMTAwMw_size_16_color_FFFFFF_t_70 5][]

可以看到，此profiles.active=test配置已经生效了，也可以在test命名空间下看到此服务注册成功了

> 注：也可以通过环境变量的方式导入这些值，比如server-addr值、namespace值等

# 完整源码下载 #

我的[Github源码地址：][Github]

[https://github.com/hemin1003/spring-cloud-study/tree/master/spring-cloud-alibaba/microservice-alibaba-nacos-discovery][https_github.com_hemin1003_spring-cloud-study_tree_master_spring-cloud-alibaba_microservice-alibaba-nacos-discovery]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hlbWluMTAwMw_size_16_color_FFFFFF_t_70 6][]

# 其他技术 #

此项目代码案例中，还集成了以下功能：

**1. 开发代码规范**

*  使用lombok组件，让代码更简洁，实现优雅编码

**2. 集成swagger**

十分简单、简洁易用的在线接口文档组件swagger

Swagger入门教程用法：[SpringBoot从入门到精通教程（二十四）- Swagger集成用法][SpringBoot_- Swagger]

# 下一章教程 #

[SpringCloud Alibaba从入门到精通教程（三）- 项目中快速集成配置中心·Nacos配置中心管理功能][SpringCloud Alibaba_- _Nacos]

# 该系列教程 #

[SpringCloud Alibaba从入门到精通教程][SpringCloud Alibaba]

# 我的专栏 #

*  [SpringBoot系列专栏][SpringBoot]
 *  [SpringCloud系列专栏][SpringCloud Alibaba]
 *  [高可用高并发实战][Link 1][专栏][Link 2]
 *  [微服务架构实战][Link 3]
 *  [DevOps实战专栏][DevOps]
 *  [程序化广告实战专栏][Link 2]

至此，全部介绍就结束了

\-------------------------------

[我的CSDN主页][CSDN]

[关于我][Link 4]（个人域名）

[我的开源项目集Github][Github 1]

期望和大家***一起学习，一起成长***，共勉，O(∩\_∩)O谢谢

欢迎交流问题，可加个人QQ 469580884，

或者，加我的群号 **751925591**，一起探讨交流问题

不讲虚的，只做实干家

Talk is cheap，show me the code

![20180411181545874][]

[SpringCloud Alibaba_- _Nacos_Server]: https://blog.csdn.net/hemin1003/article/details/105517901
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hlbWluMTAwMw_size_16_color_FFFFFF_t_70]: /images/20230528/955db60e5ccf4c27920c8a18232311b6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hlbWluMTAwMw_size_16_color_FFFFFF_t_70 1]: /images/20230528/521fbe4462504c578a8435c80f3b2a3e.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hlbWluMTAwMw_size_16_color_FFFFFF_t_70 2]: /images/20230528/af2bd7a71b9945aca2929c1d0cdea5b4.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hlbWluMTAwMw_size_16_color_FFFFFF_t_70 3]: /images/20230528/0b329187bd604ccb9311cc453731983a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hlbWluMTAwMw_size_16_color_FFFFFF_t_70 4]: /images/20230528/d64a872bdda2400a84bf10f90856e496.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hlbWluMTAwMw_size_16_color_FFFFFF_t_70 5]: /images/20230528/5a58177280334af6b8a0d217578aa475.png
[Github]: https://github.com/hemin1003/spring-cloud-study/tree/master/spring-cloud-alibaba
[https_github.com_hemin1003_spring-cloud-study_tree_master_spring-cloud-alibaba_microservice-alibaba-nacos-discovery]: https://github.com/hemin1003/spring-cloud-study/tree/master/spring-cloud-alibaba/microservice-alibaba-nacos-discovery
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hlbWluMTAwMw_size_16_color_FFFFFF_t_70 6]: /images/20230528/b780b5c9544c4860871501e125866163.png
[SpringBoot_- Swagger]: https://blog.csdn.net/hemin1003/article/details/99637936
[SpringCloud Alibaba_- _Nacos]: https://blog.csdn.net/hemin1003/article/details/105517950
[SpringCloud Alibaba]: https://blog.csdn.net/hemin1003/category_9293625.html
[SpringBoot]: https://blog.csdn.net/hemin1003/article/category/9291077
[Link 1]: https://blog.csdn.net/hemin1003/article/category/9292134
[Link 2]: https://blog.csdn.net/hemin1003/article/category/9290971
[Link 3]: https://blog.csdn.net/hemin1003/article/category/9292162
[DevOps]: https://blog.csdn.net/hemin1003/article/category/9292130
[CSDN]: https://blog.csdn.net/hemin1003
[Link 4]: http://heminit.com/about/
[Github 1]: https://github.com/hemin1003
[20180411181545874]: /images/20230528/fe1c94be76294d86a3d4022d5bbae2ef.png