#|【Spring Cloud】新闻头条微服务项目（环境搭建及框架准备）微服务|spring|boot|java|后端|spr

文章图片

个人简介：

> 个人主页：赵四司机
> 学习方向：JAVA后端开发
> 种一棵树最好的时间是十年前，其次是现在！
> ?往期文章：SpringBoot项目整合微信支付
> 喜欢的话麻烦点点关注喔，你们的支持是我的最大动力。

前言：

最近在做一个基于SpringCloud+Springboot+Docker的新闻头条微服务项目，现在项目开发进入了尾声，我打算通过写文章的形式进行梳理一遍，并且会将梳理过程中发现的Bug进行修复，有需要改进的地方我也会继续做出改进。这一系列的文章我将会放入微服务项目专栏中，这个项目适合刚接触微服务的人作为练手项目，假如你对这个项目感兴趣你可以订阅我的专栏进行查看，需要资料可以私信我，当然要是能给我点个小小的关注就更好了，你们的支持是我最大的动力。

目录
一：项目介绍
1.项目功能描述
2.所用技术栈介绍
二：项目搭建
1.Nacos环境搭建
（1）容器运行环境选择
（2）Nacos安装
2.导入初始工程
（1）项目依赖环境
（2）初始工程结构
三：接口工具及前端集成
1.接口工具
快速集成
2.前端集成
（1）前端项目部署思路
（2）配置nginx

一：项目介绍 1.项目功能描述该项目是一个文章体裁类的项目，面对三种不同群体（用户、自媒体创作人、管理员）有三种不同的客户端（App移动端、自媒体创作端、管理端），而这三者之间可以通过Feign实现相互调用。
在App移动端，用户可以查看文章并且能够对文章进行点赞、收藏、关注作者等操作，除此之外，在App端最后还利用xxl-job实现定时计算文章热度，用Kafka Stream实时计算文章热度。在自媒体创作端，创作者可以上传图片素材，对自己创作的稿件进行管理，还能创作并发布文章。在管理端，管理员登录之后可以实现对创作者申请的审核，对文章的管理，对敏感词的管理等。
2.所用技术栈介绍这是一个基于Springboot和SpringCloud的微服务项目，负载均衡层面主要采用Nginx来实现反向代理，采用阿里的Nacos作为注册中心，中间件涉及到图像识别OCR技术以及简单的自然语言处理，微服务层面主要是Springboot+Spring Cloud+Docker，数据层包括Mysql、MongoDB、Kafka、Redis，持久层采用的是Mybatis-Plus，用到的开发工具有git、maven、junit、xxl-job、Kafka Stream。
二：项目搭建 1.Nacos环境搭建（1）容器运行环境选择
刚开始做项目时候我采用的是自己电脑的虚拟机作为Docker容器的运行环境，但是我发现这样做相当占内存，运行容器两三个我的电脑内存使用量就达到90%+了，这样到后面肯定是不定的。所以我就想到了云服务器，由于我是新用户，我选用的服务器时腾讯云的轻量级服务器，可以直接选择集成了Cents+Docker的服务器，一步到位，而且对容器管理起来很方便。

文章图片

当然要是你的电脑性能够好选择虚拟机作为Docker容器运行环境也是可以的，执行的命令都是一样的。
（2）Nacos安装
首先你要确保你的服务器是安装有Docker的，如果没有安装的可以自行安装一下，至于Docker的了解以及Docker的常用命令可以查看我这篇文章：认识Docker&Docker常用命令解析
在安装好Docker之后，执行如下命令拉取Nacos镜像：

docker pull nacos/nacos-server:1.2.0

创建容器：

docker run --env MODE=standalone --name nacos --restart=always-d -p 8848:8848 nacos/nacos-server:1.2.0

这里对相关参数做简要说明：

MODE=standalone 单机版
--restart=always 开机启动
-p 8848:8848 映射端口
-d 创建一个守护式容器在后台运行

完成上述操作之后打开浏览器输入http://你自己服务器ip:8848/nacos，假如出现如下页面说明Nacos安装成功：

文章图片
需要注意一点，假如你用的是云服务器，你需要确保你的服务器防火墙8848端口是对外开放的，这样你才能访问到云服务器中的容器，后续凡是要创建容器映射端口的均需要自己去开放相应端口。
2.导入初始工程（1）项目依赖环境

JDK1.8
Intellij Idea
maven
Git

（2）初始工程结构

文章图片

tbug-headlines：父工程，同一管理项目依赖，继承Springboot
tbug-headlines-common：一些通用配置
tbug-headlines-feign-api：feign对外的接口
tbug-headlines-model：pojo、dto
tbug-headlines-utils：通用的工具
tbug-headlines-gateway：管理网关工程
tbug-headlines-service：管理微服务
tbug-headlines-test：一些测试案例

三：接口工具及前端集成 1.接口工具接口测试工具我选用的是Apifox，当然你也可以选择Postman，萝卜青菜各有所爱，都是傻瓜式安装，这里就不赘述了。当然我感觉一个Knife4j就足够了，什么是Knife4j呢？knife4j是为Java MVC框架集成Swagger生成Api文档的增强解决方案,前身是swagger-bootstrap-ui,取名kni4j是希望它能像一把匕首一样小巧,轻量,并且功能强悍! 该UI增强包主要包括两大核心功能：文档说明和在线调试。
快速集成
1.在tbug-headlines-common模块中的pom.xml文件中引入knife4j的依赖,如下：

com.github.xiaoymin knife4j-spring-boot-starter

2.创建Swagger配置文件

package com.my.common.swagger; import com.github.xiaoymin.knife4j.spring.annotations.EnableKnife4j; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.Import; import springfox.bean.validators.configuration.BeanValidatorPluginsConfiguration; import springfox.documentation.builders.ApiInfoBuilder; import springfox.documentation.builders.PathSelectors; import springfox.documentation.builders.RequestHandlerSelectors; import springfox.documentation.service.ApiInfo; import springfox.documentation.spi.DocumentationType; import springfox.documentation.spring.web.plugins.Docket; import springfox.documentation.swagger2.annotations.EnableSwagger2; @Configuration @EnableSwagger2 @EnableKnife4j @Import(BeanValidatorPluginsConfiguration.class) public class Swagger2Configuration {@Bean(value = "https://www.it610.com/article/defaultApi2") public Docket defaultApi2() { Docket docket=new Docket(DocumentationType.SWAGGER_2) .apiInfo(apiInfo()) //分组名称 .groupName("1.0") .select() //这里指定Controller扫描包路径 .apis(RequestHandlerSelectors.basePackage("com.my")) .paths(PathSelectors.any()) .build(); return docket; } private ApiInfo apiInfo() { return new ApiInfoBuilder() .title("土豆头条API文档") .description("土豆头条API文档") .version("1.0") .build(); } }

3.添加配置
在Spring.factories中新增配置

文章图片

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\ com.my.common.swagger.Swagger2Configuration,\

4.访问
浏览器输入http://host:port/doc.html
2.前端集成（1）前端项目部署思路

文章图片

通过nginx来进行配置，功能如下

通过nginx的反向代理功能访问后台的网关资源，主要流程是当用户的访问路径匹配到app的路径时候nginx就会将该访问进行代理转发，这时候你实际访问的是http://localhost:51601。
通过nginx的静态服务器功能访问前端静态页面，见下面配置，tbug-headlines-app.conf文件中监听的是8801端口，当我们访问8801端口，nginx就会读取root里面的静态资源供我们访问，首先加载的是index.html。

（2）配置nginx
①先安装好nginx，然后将app-web文件放在一个文件夹下待用。
②配置nginx.conf文件
在nginx安装的conf目录下新建一个文件夹headlines.conf,在当前文件夹中新建tug-headlines-app.conf文件，配置文件内容如下：

upstreamtbug-app-gateway{ server localhost:51601; }server { listen 8801; location / { root D:/headlinesPro/headlinesApp-web/; index index.html; } location ~/app/(.*) { proxy_pass http://tbug-app-gateway/$1; proxy_set_header HOST $host; # 不改变源请求头的值 proxy_pass_request_body on; #开启获取请求体 proxy_pass_request_headers on; #开启获取请求头 proxy_set_header X-Real-IP $remote_addr; # 记录真实发出请求的客户端IP proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; #记录代理信息 } }

注意：路径自己设置成自己的。
③修改nginx.conf
把里面注释的内容和静态资源配置相关删除，改成如下配置

#usernobody; worker_processes1; events { worker_connections1024; }http { includemime.types; default_typeapplication/octet-stream; sendfileon; keepalive_timeout65; include headlines.conf/*.conf; server { listen8888; server_namelocalhost; location / { roothtml; indexindex.html index.htm; }error_page500 502 503 504/50x.html; location = /50x.html { roothtml; }}}

④启动nginx