Nacos系列---【SpringCloudAlibaba集成Nacos】

少年攻城狮 / 2024-02-26 / 原文

1.查看版本对应关系

官网链接:https://github.com/alibaba/spring-cloud-alibaba/wiki/%E7%89%88%E6%9C%AC%E8%AF%B4%E6%98%8E
这里我以springcloudAlibaba的2021.0.5.0版本为例,展开详细介绍:

2.新建parent项目fast-cloud

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>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.6.13</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <groupId>com.fast</groupId>
    <artifactId>fast-cloud</artifactId>
    <version>1.0.0</version>
    <packaging>pom</packaging>

    <modules>
        <module>fast-auth</module>
        <module>fast-common</module>
        <module>fast-gateway</module>
        <module>fast-service</module>
        <module>fast-service-api</module>
        <module>fast-common-db</module>
    </modules>

    <properties>
        <skipTests>true</skipTests>
        <java.version>1.8</java.version>
        <encoding>UTF-8</encoding>
        <spring-boot.version>2.6.13</spring-boot.version>
        <spring.cloud-version>2021.0.5</spring.cloud-version>
        <spring-cloud-alibaba-version>2021.0.5.0</spring-cloud-alibaba-version>
        <druid.version>1.2.16</druid.version>
        <mybatis-plus-version>3.3.2</mybatis-plus-version>
        <velocity-engine-version>2.3</velocity-engine-version>
        <knife4j-version>2.0.9</knife4j-version>
        <hutool-all.version>5.7.16</hutool-all.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>
    </dependencies>

    <profiles>
        <profile>
            <id>dev</id>
            <properties>
                <!-- 环境标识,需要与Nacos的命名空间id相对应 -->
                <profiles.active>dev</profiles.active>
                <nacos.server>192.168.43.201:8848</nacos.server>
                <!-- 注意:这里的变量要想在application.yml中引用,这里只能用常量赋值-->
                <!--<nacos.group>${project.artifactId}</nacos.group>-->
                <nacos.group>fast-cloud</nacos.group>
            </properties>
            <activation>
                <!-- 默认环境 -->
                <activeByDefault>true</activeByDefault>
            </activation>
        </profile>
        <profile>
            <id>prod</id>
            <properties>
                <!-- 环境标识,需要与Nacos的命名空间id相对应 -->
                <profiles.active>prod</profiles.active>
                <nacos.server>192.168.43.201:8848</nacos.server>
                <!-- 注意:这里的变量要想在application.yml中引用,这里只能用常量赋值-->
                <!--<nacos.group>${project.artifactId}</nacos.group>-->
                <nacos.group>fast-cloud</nacos.group>
            </properties>
        </profile>
    </profiles>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring.cloud-version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <dependency>
                <groupId>com.alibaba.cloud</groupId>
                <artifactId>spring-cloud-alibaba-dependencies</artifactId>
                <version>${spring-cloud-alibaba-version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <dependency>
                <groupId>com.alibaba</groupId>
                <artifactId>druid</artifactId>
                <version>${druid.version}</version>
            </dependency>
            <dependency>
                <groupId>com.baomidou</groupId>
                <artifactId>mybatis-plus-boot-starter</artifactId>
                <version>${mybatis-plus-version}</version>
            </dependency>
            <dependency>
                <groupId>com.baomidou</groupId>
                <artifactId>mybatis-plus-generator</artifactId>
                <version>${mybatis-plus-version}</version>
            </dependency>
            <dependency>
                <groupId>org.apache.velocity</groupId>
                <artifactId>velocity-engine-core</artifactId>
                <version>${velocity-engine-version}</version>
            </dependency>
            <dependency>
                <groupId>com.github.xiaoymin</groupId>
                <artifactId>knife4j-spring-boot-starter</artifactId>
                <version>${knife4j-version}</version>
            </dependency>
            <dependency>
                <groupId>com.github.xiaoymin</groupId>
                <artifactId>knife4j-micro-spring-boot-starter</artifactId>
                <version>${knife4j-version}</version>
            </dependency>
            <dependency>
                <groupId>cn.hutool</groupId>
                <artifactId>hutool-all</artifactId>
                <version>${hutool-all.version}</version>
            </dependency>
        </dependencies>
    </dependencyManagement>

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

</project>

3.新建gateway

3.1pom.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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>com.fast</groupId>
        <artifactId>fast-cloud</artifactId>
        <version>1.0.0</version>
    </parent>
    <groupId>com.gateway</groupId>
    <artifactId>fast-gateway</artifactId>
    <version>1.0.0</version>
    <name>fast-gateway</name>

    <dependencies>
        <!--gateway依赖 -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-gateway</artifactId>
        </dependency>
        <!-- SpringCloud Alibaba Nacos -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
        </dependency>
        <!-- SpringCloud Alibaba Nacos Config -->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
        </dependency>
        <dependency>
            <groupId>com.github.xiaoymin</groupId>
            <artifactId>knife4j-spring-boot-starter</artifactId>
        </dependency>
    </dependencies>

</project>

3.2application.yml

spring:
  profiles:
    # 环境配置
    active: @profiles.active@
  application:
    name: fast-gateway
  config:
    import: optional:nacos:${spring.application.name}.yml
  cloud:
    nacos:
      namespace: ${spring.profiles.active}
      server-addr: @nacos.server@
      username: nacos
      password: nacos
      group: @nacos.group@
      discovery:
        # 注册组
        group: ${spring.cloud.nacos.group}
        namespace: ${spring.cloud.nacos.namespace}
      config:
        namespace: ${spring.cloud.nacos.namespace}
        group: ${spring.cloud.nacos.group}

3.3FastGatewayApplication.java启动类

package com.gateway;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;

@SpringBootApplication
@EnableDiscoveryClient
public class FastGatewayApplication {

    public static void main(String[] args) {
        SpringApplication.run(FastGatewayApplication.class, args);
    }

}

3.4TestController.java

package com.gateway.controller;

import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@Slf4j
@RestController
@RequestMapping("/test")
@RefreshScope
public class TestController {

    @Value("${spring.name:lisi}")
    private String name;

    @GetMapping
    public String  test() {
        return name;
    }
}

4.项目概览

5.Nacos准备

5.1.新建dev命名空间,命名空间名称和ID都叫dev。

5.2.打开配置项列表,在dev命名空间下新增dataId为fast-gateway.yml文件,与3.2的application.yml中的spring.config.import: optional:nacos:${spring.application.name}.yml保持一致,group也要保持一致。(内容添加:spring.name: wangwu123456)

5.3.启动网关项目,访问test接口,在nacos里修改spring.name的值,再访问test接口,发现值变了,说明集成nacos成功了。