开云-快速搭建 SpringCloud 微服务开发环境的脚手架

2024-12-15

快速搭建 SpringCloud 微办事开辟情况的脚手架时候：2024-12-13 21:11:33 手机看文章

扫描二维码随时随地手机看文章

1、微办事的简介

微办事是可以自力摆设、程度扩大、自力拜候的办事单位。Java 中常见最小的微办事单位就是基在 SpringBoot 框架的一个自力项目。一个微办事只做一件事（单一职责），多个微办事组合才能称之为一个完全的项目或产物。那末多个微办事的就需要来治理，而 SpringCloud 就是兼顾这些微办事的年夜管家。它是一系列有序框架的调集，简单易懂、易摆设易保护的散布式系统开辟东西包。

今天介绍的开源项目就是基在 SpringCloud2.1 的脚手架，让项目开辟快速进入营业开辟，而不需过量时候破费在架构搭建上，下面就让我们一路来看看这个项目标利用吧。

2、项目布局

这里以一个网关（gateway-admin）微办事来讲明。

项目目次布局以下图：

目次申明： db：项目初始化数据库剧本。 docker：Docker 设置装备摆设文件目次，将微办事打包为 docker 镜像（image）。 config：项目设置装备摆设信息目次，包罗数据库设置装备摆设，动静转化设置装备摆设等。 dao：数据库操作目次，首要对底层数据进行增删查改。 entity：项目实体类目次。 events：事务处置目次。 exception：异常处置目次，经由过程面向切面处置全局异常。 rest：微办事节制器目次，也就是对外供给的接口。 service：微办事营业层目次。 GatewayAdminApplication：微办事 SpringBoot 进口类。 resources：项目设置装备摆设文件目次。 test：项目单位测试目次。 pom.xml：maven 项目对象模子文件。 3、实战操作 3.1 条件确保当地安装 Git、Java8、Maven。懂一些 SpringMVC 的常识，由于 SpringBoot 是基在 SpringMVC 演变而来的。懂一些利用容器引擎 Docker、Docker-compose 的常识。 3.2 微办事架构申明

一个完全的项目，微办事架构一般包罗下面这些办事：

注册中间（经常使用的框架 Nacos、Eureka）同一网关（经常使用的框架 Gateway、Zuul）认证中间（经常使用手艺实现方案 Jwt、OAuth）散布式事务（经常使用的框架 Txlcn、Seata）文件办事营业办事

3.3 运行项目

下面介绍了三种运行的体例：

第一种：一键运行

Linux 和 Mac 系统下可在项目根目次下履行./install.sh快速搭建开辟情况。

第二种：当地情况运行

不保举此方式，但仍是简单介绍下。

根本情况安装：mysql、redis，rabbitmq

情况运行：

git clone https://github.com/zhoutaoo/SpringCloud.git #克隆项目

安装认证公共包到当地 maven 仓库，履行以下号令：

cd commonmvn clean install #安装认证公共包到当地 maven 仓库

安装注册中间 Nacos

下载 Nacos[2] 履行以下号令：

unzip nacos-server-0.9.0.zip OR tar -xvf nacos-server-0.9.0.tar.gz cd nacos/binbash startup.sh -m standalone # Linux 启动号令 cmd startup.cmd # Windows 启动号令

运行网关办事、认证办事、营业办事等

这里以网关办事为例：履行 GatewayAdminApplication.java

留意：认证办事（auth）、网关办事（gateway）、组织治理办事（sysadmin）需要履行数据库初始化剧本。

可经由过程 swager 接口：http://localhost:8445/swagger-ui.html 测试是不是搭建成功，假如能正常拜候暗示办事启动成功。

申明：

application.yml 文件首要设置装备摆设 rabbitmq，redis， mysql 的毗连信息。

spring: rabbitmq: host: 美金{RABBIT_MQ_HOST:localhost} port: 美金{RABBIT_MQ_PORT:5672} username: 美金{RABBIT_MQ_USERNAME:guest} password: 美金{RABBIT_MQ_PASSWORD:guest} redis: host: 美金{REDIS_HOST:localhost} port: 美金{REDIS_PORT:6379} #password: 美金{REDIS_PASSWORD:} lettuce: pool: max-active: 300 datasource: driver-class-name: com.mysql.jdbc.Driver url: jdbc:美金{DATASOURCE_DBTYPE:mysql}://美金{DATASOURCE_HOST:localhost}:美金{DATASOURCE_PORT:3306}/sc_gateway?characterEncoding=UTF-8 useUnicode=true useSSL=false username: 美金{DATASOURCE_USERNAME:root} password: 美金{DATASOURCE_PASSWORD:root123}

bootstrap.yml 文件首要设置装备摆设办事根基信息（端口，办事名称），注册中间地址等。

server: port: 美金{SERVER_PORT:8445} spring: application: name: gateway-admin cloud: nacos: discovery: server-addr: 美金{REGISTER_HOST:localhost}:美金{REGISTER_PORT:8848} config: server-addr: 美金{REGISTER_HOST:localhost}:美金{REGISTER_PORT:8848} file-extension: yml sentinel: transport: dashboard: 美金{SENTINEL_DASHBOARD_HOST:localhost}:美金{SENTINEL_DASHBOARD_PORT:8021}

第三种：Docker 情况运行

根本情况安装

经由过程 docker 号令安装

# 安装redis docker run -p 6379:6379 --name redis -d docker.io/redis:latest --requirepass "123456" # 安装mysql docker run --name mysql5.7 -p 3306:3306 -e MYSQL_ROOT_PASSWORD=root123 -d docker.io/mysql:5.7 # 安装rabbitmq docker run -d -p 15672:15672 -p 5672:5672 -e RABBITMQ_DEFAULT_USER=admin -e RABBITMQ_DEFAULT_PASS=admin --name rabbitmq docker.io/rabbitmq:latest

也能够经由过程 docker-compose 号令安装

cd docker-composedocker-compose up -d #docker-compose 安装mysql，redis，rabbitmq 办事

下载项目到当地

git clone https://github.com/zhoutaoo/SpringCloud.git #克隆项目

安装认证公共包到当地 maven 仓库履行以下号令：

cd common mvn install #安装认证公共包到当地maven仓库

docker-compose 运行 Nacos

cd docker-composedocker-compose -f docker-compose.yml -f docker-compose.nacos.yml up -d nacos #启动注册中间

构建动静中间镜像

cd ./center/busmvn package mvn docker:build cd docker-compose #启动动静中间 docker-compose -f docker-compose.yml -f docker-compose.center.yml up -d bus-server

需要构建镜像的其他办事有：（注：操作和动静中间镜像构建体例近似）

网关治理办事（gateway-admin、gateway-web）

组织办事（sysadmin/organization）

认证办事（auth/authentication-server）

授权办事（auth authorization-server）

治理台办事（monitor/admin）

3.4 运行结果

Nacos 办事中间

所有办事都正常启动，在 nacos 治理中间可查看，实例数暗示运行此办事的个数，值为 1 可以理解为办事正常启动。