微服务一、SpringCloudAlibaba(2021版本)+Nacos-从零开始、安装、配置、使用和父子项目搭建

瑶山

已于 2023-08-01 16:39:07 修改

阅读量4.7k

点赞数 5

分类专栏： Java 文章标签： java spring cloud alibaba nacos 微服务父子工程

于 2021-07-29 14:26:31 首次发布

本文链接：https://blog.csdn.net/qq_44695727/article/details/117998412

版权

Java 专栏收录该内容

117 篇文章 14 订阅

订阅专栏

Spring Cloud Alibaba 包含组件

Spring Cloud Alibaba 功能

下载安装：

地址

启动

创建Spring Boot并注册服务到nacos中

下一篇：微服务二、SpringCloudAlibaba(2021版本)+Nacos+Sentinel流量安全控制以及问题解决

了解一下

之前有做过一段时间的SpringCloud 的项目，用的Eureka注册中心，但是Eureka开源版本停止更新，Spring Cloud Netflix 项目进入维护模式，将不再开发新的组件，所以抽空扒了扒替代的。

停止更新主要是对Eureka 2.0而言的，Spring Cloud Netflix中一直使用的都是1.x，所以跟目前用户其实没多大关系。但是，Eureka将来更多提升是不太会有了。所以，如果希望注册中心有更多强大功能的话，需要另辟蹊径，比如：

Spring Cloud Alibaba下的Nacos

nacos是阿里巴巴研发的一个集注册中心与配置中心于一体的管理平台，

常见的注册中心：

Eureka（原生，2.0遇到性能瓶颈，停止维护）
Zookeeper（支持，专业的独立产品。例如：dubbo）
Consul（原生，GO语言开发）
Nacos

Nacos 可以与 Spring, Spring Boot, Spring Cloud 集成，并能代替 Spring Cloud Eureka, Spring Cloud Config。

Spring Cloud：

提起微服务，不得不提 Spring Cloud 全家桶系列，SpringCloud 是若干个框架的集合，提供了服务治理、服务网关、智能路由、负载均衡、断路器、监控跟踪、分布式消息队列、配置管理等领域的解决方案。

Spring Cloud 通过 Spring Boot 风格的封装，屏蔽掉了复杂的配置和实现原理，最终给开发者留出了一套简单易懂、容易部署的分布式系统开发工具包。Spring Cloud 包含以下组件，主要以 Netflix 开源为主：

preview

Spring Cloud Alibaba

同 Spring Cloud 一样，Spring Cloud Alibaba 是阿里巴巴提供的微服务开发一站式解决方案，是阿里巴巴开源中间件与 Spring Cloud 体系的融合。包含开发分布式应用微服务的必需组件，方便开发者通过 Spring Cloud 编程模型轻松使用这些组件来开发分布式应用服务。

只需添加一些注解和少量配置，就可将 Spring Cloud 应用接入阿里微服务解决方案，通过阿里中间件来迅速搭建分布式应用系统。
Spring Cloud Alibaba 跟官方的组件或其它的第三方实现如 Netflix, Consul，Zookeeper 等对比，具备了更多的功能

Spring Cloud Alibaba 包含组件

preview

阿里开源组件

Nacos：一个更易于构建云原生应用的动态服务发现、配置管理和服务管理平台。
Sentinel：把流量作为切入点，从流量控制、熔断降级、系统负载保护等多个维度保护服务的稳定性。
RocketMQ：开源的分布式消息系统，基于高可用分布式集群技术，提供低延时的、高可靠的消息发布与订阅服务。
Dubbo：在国内应用非常广泛的一款高性能 Java RPC 框架。
Seata：阿里巴巴开源产品，一个易于使用的高性能微服务分布式事务解决方案。
Arthas：开源的Java动态追踪工具，基于字节码增强技术，功能非常强大。

阿里商业化组件

Alibaba Cloud ACM：一款在分布式架构环境中对应用配置进行集中管理和推送的应用配置中心产品。
Alibaba Cloud OSS：阿里云对象存储服务（ OSS），是阿里云提供的云存储服务。
Alibaba Cloud SchedulerX：阿里中间件团队开发的一款分布式任务调度产品，提供秒级、精准的定时（基于 Cron 表达式）任务调度服务。

Alibaba Cloud SMS: 覆盖全球的短信服务，友好、高效、智能的互联化通讯能力，帮助企业迅速搭建客户触达通道。

还可以集成 Spring Cloud 组件，Zuul，OpenFeign等网关，Spring Cloud Stream 消息组件

Spring Cloud Alibaba 功能

服务注册与发现

Spring Cloud Alibaba 基于 Nacos 提供 spring-cloud-alibaba-starter-nacos-discovery & spring-cloud-alibaba-starter-nacos-config 实现了服务注册 & 配置管理功能。依靠 @EnableDiscoveryClient 进行服务的注册，兼容 RestTemplate & OpenFeign 的客户端进行服务调用。

适配 Spring Cloud 服务注册与发现标准，默认集成了 Ribbon 的支持。

支持多协议的服务调用

Spring Cloud 默认的服务调用依赖 OpenFeign 或 RestTemplate 使用 REST 进行调用。
使用 @DubboTransported 注解可将底层的 Rest 协议无缝切换成 Dubbo RPC 协议，进行 RPC 调用。

服务限流降级

Spring Cloud Alibaba 基于 Sentinel，对 Spring 体系内基本所有的客户端，网关进行了适配，

默认支持 WebServlet、WebFlux, OpenFeign、RestTemplate、Spring Cloud Gateway, Zuul, Dubbo 和 RocketMQ 限流降级功能的接入。

Sentinel应用比较简单，只需引入 starter，即可生效，可以在运行时通过控制台实时修改限流降级规则，还支持查看限流降级 Metrics 监控。

微服务消息驱动

支持为微服务应用构建消息驱动能力，基于 Spring Cloud Stream 提供 Binder 的新实现: Spring Cloud Stream RocketMQ Binder，

也新增了 Spring Cloud Bus 消息总线的新实现 Spring Cloud Bus RocketMQ。

分布式事务

使用 Seata 解决微服务场景下面临的分布式事务问题。

使用 @GlobalTransactional 注解，在微服务中传递事务上下文，可以对业务零侵入地解决分布式事务问题。

分布式配置管理

支持分布式系统中的外部化配置，配置更改时自动刷新。

天然支持云原生

云原生是一种专门针对云上应用而设计的方法，用于构建和部署应用，以充分发挥云计算的优势。

阿里云的商业化组件OSS，schedulerx等，开发者可以在阿里云上实现对象存储，分布式任务调度等功能。

下载安装：

地址

启动

下载对应版本的Nacos Server，到安装目录的bin目录下执行命令(standalone代表着单机模式运行，非集群模式),此处下载的是官网推荐的稳定版本为1.4.2：

liunx: ./startup.sh -m standalone
window: startup.cmd -m standalone

没有配置集群直接点击startup.cmd启动会报错

启动后访问 http://localhost:8848/nacos

输入账号nacos 密码nacos 进入nacos控制台

安装成功！

C:\Users\Administrator\AppData\Local\Temp\2\librocksdbjni976150487986297510.dll: Can't find dependent libraries

缺少Visual C++ Redistributable for Visual Studio 2015
下载vc_redist.x64.exe进行安装
下载链接 https://www.microsoft.com/zh-cn/download/confirmation.aspx?id=48145

创建Spring Boot并注册服务到nacos中

创建Spring Boot v2.4.7

创建Spring Boot项目：此处版本2.4.7，依赖可按需选择

选择 Spring Initializr（初始化），选择Project SDK 1.8，默认 SpringBoot 脚手架

Group：也就是 groupId，项目组织唯一的标识符，对应main目录里Java的目录结构，一般第一段为域，第二段公司，第三段项目名，例com.alibaba.nacos
Artifact：artifactId，项目的唯一的标识符，项目名，项目根目录名称
Type：默认Maven Project就行
Language： Java
Packaging：打包方式，Jar
Java Version：坚持JDK 1.8
Version：当前项目的版本，SNAPSHOT 为快照的意思
Name：定义项目名称
Description：项目描述信息
Package：定义 main.java 目录下的结构

Spring Cloud、Spring Cloud Alibaba、Spring Boot Version版本选择：版本对应关系：

pom

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.4.7</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.zw</groupId>
    <artifactId>cloud-nacos-demo-center</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>cloud-nacos-demo-center</name>
    <description>Demo project for Spring Boot</description>

    <properties>
        <java.version>1.8</java.version>
        <spring-cloud.version>2021.1</spring-cloud.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>

        <!--引入nacos client依赖-->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
        </dependency>
    </dependencies>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>com.alibaba.cloud</groupId>
                <artifactId>spring-cloud-alibaba-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

yml

server:
  port: 8081
spring:
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848
        group: DEV_GROUP # 应用分组默认为：DEFAULT_GROUP
  application:
    name: demo-center

启动项目

构建父子项目和Nacos动态配置管理

构建父项目：

按照上面步骤创建一个spring boot项目，注意第二张图，type选 Maven POM,项目名：cloud-nacos-demo

版本还是选2.4.7，依赖选择了 Spring Web

pom文件打包方式改成pom：

<packaging>pom</packaging>

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.4.7</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.demo</groupId>
    <artifactId>cloud-nacos-demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>cloud-nacos-demo</name>
    <description>Demo project for Spring Cloud Nacos</description>
    <packaging>pom</packaging>
    
    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

构建子Module：

重复上方在创建 SpringBoot 项目时的步骤，Type为Maven Project，Next 下一步，Group与Parent项目保持一致，Artifact修改为Module项目作用域名称, 注意版本2.4.7，暂且创建以下几个模块

cloud-nacos-common-utils
cloud-nacos-common-redis
cloud-nacos-common-entity
cloud-nacos-customer-center
cloud-nacos-console-center

packaging 包含三个值 Jar、War、Pom，默认 Jar的方式

Jar： 内部调用或作为服务进行发布使用
War： 需要部署的项目
Pom： 寓意为一个父级项目，一般作为项目聚合和依赖传递使用

modules 代表了 Parent 项目下的子 Module

    <packaging>pom</packaging>

    <modules>
        <module>cloud-nacos-common-entity</module>
        <module>cloud-nacos-common-redis</module>
        <module>cloud-nacos-common-utils</module>
        <module>cloud-nacos-console-center</module>
        <module>cloud-nacos-customer-center</module>
    </modules>

修改 Module Pom.xml 的 Parent 信息

    <parent>
        <groupId>com.demo</groupId>
        <artifactId>cloud-nacos-demo</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </parent>

验证

先打包下父项目

BUILD SUCCESS！

cloud-nacos-common-utils下创建TestUtil

package com.demo.utils;

public class TestUtil {

    public static void test() {
        System.out.println("this is cloud-nacos-common-utils TestUtil test()");
    }
}

删除pom文件build标签和内容（同时也删除父项目pom的build），启动类，以及resources、test文件夹, 只保留pom和src文件夹（同时也可依法修改另外几个common工程）

cloud-nacos-console-center

引入utils依赖

        <dependency>
            <groupId>com.demo</groupId>
            <artifactId>cloud-nacos-common-utils</artifactId>
            <version>0.0.1-SNAPSHOT</version>
        </dependency>

创建TestController

package com.demo.controller;
import com.demo.utils.TestUtil;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class TestController {

    @GetMapping("/test")
    public String test() {
        TestUtil.test();
        return "111111";
    }
}

启动项目。访问 http://localhost:8080/test

配置成功！

Error:(3, 32) java: 程序包org.springframework.boot不存在，找到下图位置，勾选上

如果遇到有其他错误，如编译通过还找不到包之类的，多clean、install几下, 毕竟这样能解决很多maven项目问题

统一管理依赖版本

在多模块的项目中，如果父 pom 中引入依赖，则子模块会全盘接受父 pom 中引入的依赖，即使它本身不需要这个依赖。Maven中的dependencyManagement元素提供了一种管理依赖版本号的方式。如果有多个子项目都引用同一样依赖，可避免在每个子项目里声明一个版本。

当想升级或切换到另一个版本时，只需要在顶层父容器里更新，而不需要逐个修改子项目
如果某个子项目需要另外的一个版本，只需要声明version即可
dependencyManagement中定义的只是依赖的声明，并不实现引入，因此子项目需要显式的声明需要用的依赖。

在父项目的POM.xml中配置：

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
                <version>1.2.3.RELEASE</version>
            </dependency>
        </dependencies>
    </dependencyManagement>

子项目则无需指定版本信息

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

改造cloud-nacos-console-center和cloud-nacos-common-utils的pom文件

删除父pom中已有的依赖项

刷新下maven，重启项目，

Spring Cloud + Nacos

nacos文档示例项目

父pom文件添加

    <properties>
        <java.version>1.8</java.version>
        <spring-cloud.version>2021.1</spring-cloud.version>
    </properties>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>2020.0.0</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <dependency>
                <groupId>com.alibaba.cloud</groupId>
                <artifactId>spring-cloud-alibaba-dependencies</artifactId>
                <version>${spring-cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

服务注册/发现/消费

pom

修改子模块：cloud-nacos-console-center、cloud-nacos-customer-center，添加pom依赖项

        <!--lombok依赖-->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>

        <!--引入nacos client依赖-->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-openfeign</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-loadbalancer</artifactId>
        </dependency>

spring cloud的 Netflix ribbon 和 feign 的区别与选用：

Ribbon 是一个基于 HTTP 和 TCP 客户端的负载均衡器它可以在客户端配置 ribbonServerList（服务端列表），然后轮询请求以实现均衡负载，
联合 Eureka 使用时ribbonServerList 会被 DiscoveryEnabledNIWSServerList 重写，从 Eureka 注册中心获取服务端列表同时它也会用 NIWSDiscoveryPing 来取代 IPing，通过 Eureka 来确定服务端是否已经启动。使用 HttpClient 或 RestTemplate 模拟http请求。

Feign 是在 Ribbon的基础上进行了一次改进，是一个使用起来更加方便的 HTTP 客户端。面向接口；然后在上面添加注解即可，不需要自己构建http请求。然后就像是调用自身工程的方法调用

这里选用Feign

        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-openfeign</artifactId>
        </dependency>

启动类加注解

@EnableDiscoveryClient // 开启服务注册
@EnableFeignClients // 开启feign远程调用

yml

customer-center yml文件

server:
  port: 8081
spring:
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848
        group: DEV_GROUP
  application:
    name: customer-center

console-center yml文件

server:
  port: 8082
spring:
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848
        group: DEV_GROUP
  application:
    name: console-center

配置cloud-nacos-customer-center，创建如下图的项目结构

ConsoleApiService （调用console-center的服务）

package com.demo.rpc;

import com.demo.rpc.impl.ConsoleApiServiceFallback;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;

// value 代表要调用的服务
// 设置configuration属性为  feign的  配置 比如日志记录
// fallback 消费端 降级方案
@FeignClient(value = "console-center", fallback = ConsoleApiServiceFallback.class)
public interface ConsoleApiService {

    @GetMapping("/test")
    String test();
}

ConsoleApiServiceFallback

package com.demo.rpc.impl;

import com.demo.rpc.ConsoleApiService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Component;

@Slf4j
@Component
public class ConsoleApiServiceFallback implements ConsoleApiService {

    @Override
    public String test() {
        log.error("test fail :remote call console-center test method fail");
        return null;
    }
}

UserController

package com.demo.controller;

import com.demo.config.ConfigProperties;
import com.demo.rpc.ConsoleApiService;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.annotation.Resource;

@RestController
public class UserController {

    @Resource
    ConfigProperties properties;

    @Resource
    ConsoleApiService consoleApiService;

    @GetMapping("/test")
    public String getUser() {

        return consoleApiService.test();
    }
}

验证

启动两个模块：cloud-nacos-console-center、cloud-nacos-customer-center

分别访问：http://localhost:8082/test，http://localhost:8081/test

消费成功！

Nacos 配置管理

依赖

        <!--启用配置服务-->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
        </dependency>

版本兼容问题：

SpringBoot2.4.0，使用新版本的 Spring Could Config Client 时，这个版本的配置方式发生了大改动（困扰我一个上午。。）

Spring Cloud文档地址

通过查看文档发现，Spring Boot 2.4 引入了一种通过spring.config.import属性导入配置数据的新方法。在新版中将spring.cloud.bootstrap.enabled默认设置为false不启用, 若要bootstrap配置生效，加入以下依赖
        
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-bootstrap</artifactId>
        </dependency>

yml

server:
  port: 8081

同级新建bootstrap.yml

spring:
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848
        group: DEV_GROUP
        #register-enabled: true # 是否开启注册服务（默认true）
      config: # 配置中心
        server-addr: localhost:8848  # 地址
        prefix: config  # 默认为 spring.application.name 的值
        file-extension: yml
        #refresh-enabled: true # 是否开启动态刷新（默认true）
  application:
    name: customer-center
  profiles:
    active: dev

创建配置类：ConfigProperties

package com.demo.config;

import lombok.Data;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.stereotype.Component;

@RefreshScope
@Component
@Data
public class ConfigProperties {

    @Value("${test:0}")
    private String test;

    @Value("${test1:0}")
    private String test1;

    @Value("${test2:0}")
    private String test2;

    @Value("${resource.test3:0}")
    private String test3;
}

修改UserController

package com.demo.controller;

import com.demo.config.ConfigProperties;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.annotation.Resource;

@RestController
public class UserController {

    @Resource
    ConfigProperties properties;

    @GetMapping("/test")
    public String getUser() {

        return "test=" + properties.getTest()
                + "; test1=" + properties.getTest1()
                + "; test2=" + properties.getTest2()
                + "; test3=" + properties.getTest3()
                ;
    }
}

启动

查看日志的最后：[add-listener] ok, tenant=, dataId=config.yml, group=DEFAULT_GROUP, cnt=1

打开Nacos控制台-配置管理-配置列表-右上角的+号新增配置

访问：http://localhost:8081/test（项目未重启）

修改配置内容，再次访问：http://localhost:8081/test（项目未重启）

下一篇：微服务二、SpringCloudAlibaba(2021版本)+Nacos+Sentinel流量安全控制以及问题解决

本来想一篇搞完的，但是后来发现内容实在太多，也耗时了很久，最后还是决定分开8！不然怕是一直是草稿！

微服务二、SpringCloudAlibaba(2021版本)+Nacos+Sentinel流量安全控制+OpenFeign+Gateway以及问题解决

瑶山

关注

5
点赞
踩
31

收藏

觉得还不错? 一键收藏
打赏
0
评论
微服务一、SpringCloudAlibaba(2021版本)+Nacos-从零开始、安装、配置、使用和父子项目搭建

之前有做过一段时间的SpringCloudEureka的项目，但是Eureka开源版本停止更新有一段时间了，所以抽空扒了扒替代的。停止更新主要是对Eureka 2.0而言的，Spring Cloud Netflix中一直使用的都是1.x，所以跟目前用户其实没多大关系。但是，Eureka将来更多提升是不太会有了。所以，如果希望注册中心有更多强大功能的话，需要另辟蹊径，比如：Spring Cloud Alibaba下的Nacosnacos是阿里巴巴研发的一个集注册中心与配置中心于一体的管理平台，.
复制链接

扫一扫