???????使用gitee来存储代码,我们修改或者增加新功能时,就不需要把本地的jar编译好上传服务器,直接使用CI/CD来完成部署,里面已经支持Maven的构建与上传到远程服务器上完成项目的部署。这一次的记录,不需要你们买服务器,虽说服务器新用户一年也就八九十块钱,但是我们也可以不花钱学会,因为我打算使用本地电脑虚拟机新建一个Linux,然后搭配免费的内外穿透工具来完成本次的教学.
本地Linux
:本次教学不涉及虚拟机Linux的安装如需购买可以看往期教程购买一台服务器安装 青龙面版 撸京豆gitee的账号
:去注册gitee账号映射工具(cpolar)
:下载Linux的版本Cpolar官网下载,Linux版本
我们去下载Linux版本
可以看官网已经列举出来Linux的安装步骤
我这使用Xshell连接本地虚拟机中的Linux
输入下载代码使用Curl方式
curl -L https://www.cpolar.com/static/downloads/install-release-cpolar.sh | sudo bash
查看版本号
cpolar version
登录cpolar官网后台,点击左侧的验证,查看自己的认证token,之后将token贴在命令行里
cpolar authtoken 自己的Authtoken
设置Cpolar开机自启
sudo systemctl enable cpolar
现在我们启动Cpolar,实现内网穿透,我们先开启一个http的8080端口
cpolar http 8080
???????如果我们使用接口软件来访问该地址,我们正好有java的8080端口程序在运行,则会接收到请求信息。(前提是本地Linux开启了对应端口号的防火墙)
注意:ctrl+c是退出Cpolar,每一次退出启动Cpolar的域名都会变
Cpolar的后台也可以看到对应的url地址
防火墙设置
service iptables status 查看防火墙状态
service iptables stop 关闭防火墙
service iptables start 启动防火墙
防火墙状态是启动的
我们需要关闭防火墙
查看防火墙放行的端口号(上面直接关闭防火墙可以不需要以下操作)
iptables -L -n
可以看出当前并没有放行8080的防火墙端口号,我们需要放行端口才能通过映射访问本地服务器
Linux 放行防火墙端口号,用于外界访问
## 开启
iptables -A INPUT -p tcp --dport 端口号 -j ACCEPT
## 保存配置
service iptables save
## 重启
service iptables restart
???????到这里内网穿透的基本就配置完成了,由于开启了Cpolar后Xshell就不能输入命令行,所以你们可以在开一个新的选项卡。
???????由于我们还没有写java程序,所以访问Cpolar的地址显示没有运行网站服务器,后续我们把代码上到本地服务器来看效果就直观了
创建好Gitee账号后,我们点击右上角的加号进行新建仓库
创建自己的仓库,仓库名称使用英文
仓库创建好后,我们需要把仓库拉取到本地
???????我们在本地选择好文件夹目录,使用英文的目录,然后使用命令拉取下来,提示拉取一个空的仓库,我们到时候会把这个目录当做IDEA的开发目录,到时候代码就可以推送到远程上
该目录只有一个.git,里面存放着当前仓库git的一些配置信息
我们创建一个web服务我们先勾选,Spring web依赖,没有勾选也没事,到时候在pom.xml中添加依赖也行
???????创建好工程后,我们看下界面是否有git的图标,没有就去下载个git插件,这样我们就可以可视化的拉取代码,推送代码到远程分支,和切换分支等操作。
由于我这个版本所有捆绑git插件所以不需要下载,有关git的插件,如果你们的IDEA没有git插件可以去插件市场里面下载
git插件
直接去下载安装git插件,然后重启IDEA,这样插件才能生效,可以看往期文章 IDEA工具插件(持续更新中…)
???????红色文件的是没被git管理的文件,绿色的文件是添加到git管理的文件,这样我们提交推送远程的时候就可以把绿色文件推送到远程
选择好需要添加的文件,我们
右键选择添加到 VCS
把
application.properties
名称修改成application.yml
# 应用服务 WEB 访问端口
server:
port: 8080
???????至于写什么呢?要不用我以前写的,传递对应城市返回对应城市的天气消息,这样项目也不会那么无味,因为之前接口什么的已经分析好了,我直接请求接口就可以获取对应城市的天气信息,如果对如何分析天气接口感兴趣的可以前往往期文章【手把手教你】如何获取中国天气网,获取想要城市的天气-图文并茂-分析代码
层级结构
ApiController 代码
/**
* @Author itmei
* @Date 2023/12/20 20:33
* @description: 控制层
* @Title: ApiController
* @Package com.itmei.cicddemo.demos.controller
*/
@RestController
@RequestMapping("/api")
public class ApiController {
@Resource
private ApiService apiService;
/**
*
* @return
*/
@GetMapping("/cityWeatherDetails")
public ResultData cityWeatherDetails(String city) {
JSONObject realWeather = apiService.getRealWeather(city);
return ResultData.success(realWeather);
}
}
ResultData 代码
/**
* @Author itmei
* @Date 2022/4/10 11:38
* @Version 1.0
*/
public class ResultData extends HashMap<String, Object> {
private static final long serialVersionUID = 1L;
/**
* 异常Code
*/
private static final Integer HTTP_STATUS_ERROR = 500;
/**
* 成功Code
*/
private static final Integer HTTP_STATUS_SUCCESS = 200;
/**
* 状态码
*/
public static final String CODE_TAG = "code";
/**
* 提示信息
*/
public static final String MSG_TAG = "msg";
/**
* 具体内容
*/
public static final String DATA_TAG = "data";
/**
* token
*/
public static final String TOKEN_TAG = "token";
/**
* 返回空数据
*/
public ResultData() {
}
/**
* 初始化一个新创建的 ResultData 对象
*
* @param code 状态码
* @param msg 返回内容
*/
public ResultData(int code, String msg) {
this.put(CODE_TAG, code);
this.put(MSG_TAG, msg);
}
/**
* 初始化一个新创建的 ResultData 对象
*
* @param code 状态码
* @param msg 返回内容
* @param data 数据对象
*/
public ResultData(int code, String msg, Object data) {
this.put(CODE_TAG, code);
this.put(MSG_TAG, msg);
/**
* 判断是否有数据
*/
if (data != null && !"".equals(data)) {
this.put(DATA_TAG, data);
}
}
/**
* 返回成功消息
*
* @param code 状态码
* @param msg 返回内容
* @param data 数据对象
* @return ResultData
*/
public static ResultData success(int code, String msg, Object data) {
return new ResultData(code, msg, data);
}
/**
* 返回成功消息
*
* @param msg 成功提示信息
* @param data 数据对象
* @return
*/
public static ResultData success(String msg, Object data) {
return new ResultData(HTTP_STATUS_SUCCESS, msg, data);
}
/**
* 返回成功提示信息
*
* @param msg 成功提示信息
* @return
*/
public static ResultData success(String msg) {
return ResultData.success(msg, null);
}
public static ResultData success(Object data) {
return ResultData.success("操作成功" , data);
}
public static ResultData success() {
return ResultData.success("操作成功");
}
/**
* 错误提示
*
* @return
*/
public static ResultData error() {
return error(HTTP_STATUS_ERROR, "操作失败");
}
/**
* 错误提示
*
* @param msg 数据内容
* @return
*/
public static ResultData error(String msg) {
return error(HTTP_STATUS_ERROR, msg);
}
/**
* 返回错误信息
*
* @param msg 返回内容
* @param data 数据对象
* @return
*/
public static ResultData error(String msg, Object data) {
return new ResultData(HTTP_STATUS_ERROR, msg, data);
}
/**
* 返回错误消息
*
* @param code
* @param msg
* @return
*/
public static ResultData error(int code, String msg) {
return new ResultData(code, msg, null);
}
/**
* 方便链式调用
*
* @param key
* @param value
* @return
*/
@Override
public ResultData put(String key, Object value) {
super.put(key, value);
return this;
}
}
GlobalExceptionHandler 代码
/**
* @Author itmei
* @Date 2023/12/20 20:58
* @description: 全局异常捕获类
* @Title: GlobalExceptionHandler
* @Package com.itmei.cicddemo.demos.exception
*/
@RestControllerAdvice
public class GlobalExceptionHandler {
private static final Logger log = LoggerFactory.getLogger(GlobalExceptionHandler.class);
/**
* 全局异常
*/
@ExceptionHandler(Exception.class)
public ResultData handleException(Exception e, HttpServletRequest request)
{
String requestURI = request.getRequestURI();
log.error("请求地址'{}',发生系统异常.", requestURI, e);
return ResultData.error(e.getMessage());
}
}
ApiService 代码
/**
* @Author itmei
* @Date 2023/12/20 20:34
* @description: 服务层
* @Title: ApiService
* @Package com.itmei.cicddemo.demos.service
*/
@Service
public class ApiService {
private static Map<String,Long> cityAreaIdMap = new HashMap<>();
/**
* 项目启动后会调用该方法
* 获取所有城市AreaId
*
* @return
*/
@PostConstruct
public void getCity() {
String cityJs = "https://j.i8tq.com/weather2020/search/city.js";
//发送请求获取数据
String cityStr = HttpUtil.createGet(cityJs).header("Referer", "http://www.weather.com.cn/").execute().body();
//需要解析数据
String cityJson = cityStr.replace("var city_data =", "");
//创建集合存储数据
//使用 NAMECN:AREAID
JSONObject entries = JSONUtil.parseObj(cityJson);
Set<String> keys = entries.keySet();
for (String key : keys) {
//System.out.println("第一层 省" + key);
Set<String> citys = entries.getJSONObject(key).keySet();
for (String city : citys) {
//System.out.println("--第二层 城市" + city);
Set<String> areas = entries.getJSONObject(key).getJSONObject(city).keySet();
for (String area : areas) {
//System.out.println("---第三层 区:" + area);
JSONObject jsonObject = entries.getJSONObject(key).getJSONObject(city).getJSONObject(area);
//System.out.println(jsonObject.toString());
cityAreaIdMap.put(jsonObject.getStr("NAMECN"), jsonObject.getLong("AREAID"));
}
}
}
}
private Long cityAreaIdMap(String city) {
Long areaId = cityAreaIdMap.get(city);
if (ObjectUtil.isEmpty(areaId)) {
throw new RuntimeException("查询 "+ city +" 城市异常,确认城市是否正确!");
}
return areaId;
}
/**
* 获取实时城市天气
*
* @param city
* @return
*/
public JSONObject getRealWeather(String city) {
//取出对应城市的areaid
Long areaId = cityAreaIdMap(city);
//实时天气的地址
String REALWEATHER_URL = "http://d1.weather.com.cn/sk_2d/";
//拼接请求地址
String uri = REALWEATHER_URL + areaId + ".html";
String res = HttpUtil.createGet(uri).timeout(10000).header("Referer", "http://www.weather.com.cn/").execute().body();
//替换数据不然会影响json的解析
String json = res.replace("var dataSK=", "");
return JSONUtil.parseObj(json);
}
}
完整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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.itmei</groupId>
<artifactId>cicd-demo</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>cicd-demo</name>
<description>
用于演示gitee的CI/CD的Spring Boot项目,该项目的功能定义用于获取对应城市的天气消息等功能
</description>
<properties>
<java.version>1.8</java.version>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
<spring-boot.version>2.6.13</spring-boot.version>
<hutool.version>5.8.0.M2</hutool.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>
<!--java常用工具-->
<dependency>
<groupId>cn.hutool</groupId>
<artifactId>hutool-all</artifactId>
<version>${hutool.version}</version>
</dependency>
</dependencies>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>${spring-boot.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<build>
<!--添加打包的名称-->
<finalName>cicd-weather</finalName>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.8.1</version>
<configuration>
<source>1.8</source>
<target>1.8</target>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<version>${spring-boot.version}</version>
<configuration>
<mainClass>com.itmei.cicddemo.CicdDemoApplication</mainClass>
</configuration>
<executions>
<execution>
<id>repackage</id>
<goals>
<goal>repackage</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
启动成功后,打印程序端口号以及启动时间2.5秒
使用你们自己熟悉的接口工具如ApiFox,ApiPost,PostMan等
请求接口:/api/cityWeatherDetails?city=福州
响应结果:
{
"msg": "操作成功",
"code": 200,
"data": {
"nameen": "fuzhou",
"cityname": "福州",
"city": "101230101",
"temp": "8.3",
"tempf": "46.9",
"WD": "西北风",
"wde": "NW",
"WS": "2级",
"wse": "5km/h",
"SD": "93%",
"sd": "93%",
"qy": "1018",
"njd": "16km",
"time": "21:30",
"rain": "0",
"rain24h": "0",
"aqi": "20",
"aqi_pm25": "20",
"weather": "多云",
"weathere": "Cloudy",
"weathercode": "d01",
"limitnumber": "",
"date": "12月20日(星期三)"
}
}
传递错误测试查看错误效果
响应结果:
{
"msg": "查询 奥尔良 城市异常,确认城市是否正确!",
"code": 500
}
现在确定代码没问题了,我们可以通过IDEA的可视化界面操作git,把代码推送gitee的仓库中了。
选择需要提交的文件,怎么选择多个文件呢,你按着Shift+文件就会被多选,然后我们右键点击提交文件
需要注意的是当前提交的是本地git仓库,远程现在还是没有代码的
点完这个推送后代码就会推送到远程gitee的仓库中
增加项目打jar包的名称,记得推送到远程哦
???????到这里我们就完成了代码的编写和git的代码推送。看到这里了给自己加加油吧,因为你也可以通过传递不同的城市,获取对应城市天气详情数据,动手敲起来,你一定可以得到收获的。
在我们的仓库中选择,流水线
选择不自动创建,我们自己创建
我们自己点击创建流水线
把配置项添加进去,需要注意的是里面的
cicd-demo
你们都替换成GiteeGo应用名吧,然后需要注意的是./target/cicd-weather.jar
这个是git进行maven编译时需要帮他指定在那个目录下,不然找jar的位置
version: '1.0'
name: master-pipeline
displayName: MasterCi
triggers:
trigger: auto
push:
branches:
include:
- master
stages:
- name: compile
displayName: 编译
strategy: naturally
trigger: auto
steps:
- step: build@maven
name: build_maven
displayName: Maven 构建
jdkVersion: 8
mavenVersion: 3.3.9
commands:
- '# mvn -B clean package -Dmaven.test.skip=true'
- ''
- mvn clean package -Dmaven.test.skip=true -U -e -X -B
artifacts:
- name: BUILD_ARTIFACT
path:
- ./target/cicd-weather.jar
caches:
- ~/.m2
strategy: {}
- step: publish@general_artifacts
name: publish_general_artifacts
displayName: 上传制品
dependArtifact: BUILD_ARTIFACT
artifactName: cicd-demo
strategy: {}
dependsOn: build_maven
- name: release
displayName: 发布
strategy: naturally
trigger: auto
steps:
- step: deploy@agent
name: deploy_agent
displayName: 主机部署
hostGroupID:
ID: 192.168.0.45
hostID:
- 76f3
deployArtifact:
- name: cicd-demo
target: ~/gitee_go/deploy
source: build
dependArtifact: BUILD_ARTIFACT
script:
- '# 功能:部署脚本会在部署主机组的每台机器上执行'
- '# 修改APP_NAME为GiteeGo应用名'
- APP_NAME=cicd-demo
- 'APP_HOME_DIR=/home/giteeAuto/giteeJar/${APP_NAME} # 存放jar包放到这个目录下'
- 'APP_HOME_BACK_DIR=/home/giteeAuto/giteeJar/${APP_NAME}/back # 把之前存在的jar备份到该目录下'
- 'APP_HOME_DIR_TARGET=${APP_HOME_DIR}/ #解压后的包名称需要提取里面的jar'
- 'APP_HOME_DIR_TARGET_NAME=cicd-weather #解压后的包名称'
- ''
- mkdir -p ${APP_HOME_DIR}
- mkdir -p ${APP_HOME_BACK_DIR}
- ''
- ''
- 'JAR_NAME=${APP_HOME_DIR}/${APP_HOME_DIR_TARGET_NAME}.jar # jar包的路径名字'
- 'JAR_BACK_NAME=${APP_HOME_BACK_DIR}/${APP_HOME_DIR_TARGET_NAME}.jar # 备份jar包的路径名字'
- ''
- ''
- echo 'Gitee自动化开始运行 备份之前jar包'
- ''
- if [ -f ${JAR_NAME} ];then
- echo "文件存在则移动文件到备份中"
- mv ${JAR_NAME} ${JAR_BACK_NAME}_`date '+%Y%m%d_%H.%M.%S'`
- else
- echo "文件不存在忽略"
- fi
- ''
- echo 'Gitee自动化开始运行 解压到指定目录中'
- tar zxvf ~/gitee_go/deploy/${APP_NAME}.tar.gz -C ${APP_HOME_DIR}
- echo '-----解压完成----'
- ''
- cd ${APP_HOME_DIR}/
- ./deploy.sh restart
- ''
- echo '-----项目重启完成----'
- ''
notify: []
strategy:
retry: '0'
需要改动的地方
添加Linux主机
复制下来,粘贴到我们本地内网穿透的服务器命令行中
回到gitee的页面,可以看到我们本地的电脑已经在线了,这个时候在去配置我们的流水线
点击保存,并确认创建流水线
我们可以看到,创建后自动给我们执行了流水线并且完成了Maven的编译,和成品的上传
???????但是在发布到我们本地服务时发生了异常,出现问题不可怕,可怕的是今天写的有点晚了,都快11点了,保命要紧今天就先写到这,明天再出来解决错误问题。
错误提示没有wget命令导致的,我们回到本地Linux 命令行查看是否也提示没有这个命令
可以看出的确没有这个命令,提示-bash: wget: command not found
,那我们我们要安装wget
命令
使用yum 命令进行安装
yum -y install wget
可以看到又出现其他问题了,你们没有出现的可以忽略,这个是因为我的虚拟磁盘已经满了,需要清理下
## 查看根目录下的所有大于100M的文件并输出
find / -size +100M -type f -exec ls -l {} \;
rm -
???????然后cd 到需要输出的文件下使用rm命令进行删除,可别再根目录使用
rm -rf *
删除哦不然你就完犊子了,保守一点你们还是用rm -rf 文件名称
进行删除,删除完成后/dev/sda3 释放了2.3g的内存,我们接着使用命令安装wget
安装成功
wget
后的日志输出
回到流水线,我们点击失败的发布,然后点击重新执行,看看效果
???????其实到这一步了,并不是真正意义上的失败,因为我们还有一个启动程序Linux的sh脚本没有上传到本地服务器上,但是对应流水线来说的确是失败的,因为没有./deploy.sh 文件
现在我们在看下我们本地的linux服务是不是创建了对应的文件,和把对应的jar包解压到对应的位置上
???????本地服务器已经有正常的文件了,这一步是流水线自动把打包好的jar包拉取到本地,然后按照我们的linux命令进行执行的,是不是就很方便了。
???????因为这个流水线配置是比较早的版本,当时是有优化了下这个流水线配置,直接把运行的脚本添加到项目中,然后通过我们设置的命令运行启动脚本,我现在才想起来,所以就不去动之前的流水线配置了,不然有些读者可能会看懵了,配置和流水线输出的结果不一致,产生迷惑。
我们在代码中新建bin目录并且把运行脚本添加进去,创建的bin目录是和src同级的,不要搞错了,还有记得修改脚本中的运行jar名称
我们先更新远程的代码,本次拉取远程的代码是流水线的配置文件会拉到我们的工程中.
该目录下的存放着我们的流水线配置,我们可以直接在这上面修改流水线配置,我们把流水线配置下然后再一起推送到远程
添加三处位置
- ./bin/deploy.sh
- 'DEPLOY_NAME=deploy.sh #运行脚本文件'
- 'echo ''########## Gitee自动化开始运行 服务重启 ##########'''
- cd ${APP_HOME_DIR}/
- '#增加可执行权限'
- chmod +x ${DEPLOY_NAME}
- ./${DEPLOY_NAME} restart
提交git
由于我这个流水线设置的是有推送就会,自动运行流水线,完成代码的编译和发布
这里截图给你们看下代码配置,在git 的图形视图中的关系
???????到这里,流水线的自动编译和发布远程,就完成了,但是我们严谨一点,我们看下本地的程序是否正常运行,边写文章边写代码,就没有顺利过,都要踩踩坑,把你们可能出现的问题都列举出来,并解决,这个问题是提示没有主类进行加载,
这一步问题出现在打包上
pom.xml 去除
<skip>true</skip>
,我已经把前面的pom.xml代码已经去除了,你们应该不会发生这个错误了
<skip>true</skip> 这个配置用来控制是否跳过该插件的执行,
默认值是 false,即不跳过。设置为 true 可以跳过 spring-boot-maven-plugin 插件的执行,
这意味着 Maven 不会对项目进行打包和构建,也不会生成可执行的 JAR 文件。
提交git自动执行流水线
见证奇迹的时候到了,运行命令查看jar的运行情况
非常好执行成功,接下来我们就配合Cpolar内网穿透实现接口的请求
由于开启了Cpolar后Xshell就不能输入命令行,所以你们可以在开一个新的选项卡
cpolar http 8080
确保我们的java程序,正在运行中,然后再一个内网穿透来映射我们的本地java服务
使用你们自己熟悉的接口工具如ApiFox,ApiPost,PostMan等
复制域名添加到接口请求工具中
请求地址:
http://66ae370d.r9.cpolar.top/api/cityWeatherDetails?city=福州
???????可以看出,内网穿透调用了我们的服务并且返回了数据给我们,这里使用内网穿透,所以会更慢一点点,因为要多走一个Cpolar的服务器,在转发到我们这个,但是问题也不大。
???????终于在第三个晚上完成了这篇,巨多东西要总结,零零散散的知识点也多,不知不觉每个晚上都要写2~3个小时之间,现在距离我写总结已经是晚上10点半了,由于工作的原因,这一年写的博客没有去年的一半多,所以希望我写的文章可以帮助一些人,因为谁都是从不会到会的,依稀记得之前学校读书,当时小白的我虽说把代码写好了,本地IDEA也可以跑起来,但是网页就是打不开,我还在CSDN寻求帮助,可惜没有热度看到的人也微乎其微,当时我就下定决心,把最近学习的,可能帮助到读者的知识点写下来,也增强了知识点,学的东西多了,忘的也多了,回过头想想之前好像这个知识点我有总结,也可以回顾之前写的文章。今年2023年也到尾声了离2024年也就不到十几天的时间,希望新的一年可以多做些有意义的事情,大家一起加油🥳。