doc:添加cicd文档模块
This commit is contained in:
橙子
264
Yi.Doc.Md/04.橙子运维CICD教程/03.Jenkins流水线配置.md
Normal file
264
Yi.Doc.Md/04.橙子运维CICD教程/03.Jenkins流水线配置.md
Normal file
@@ -0,0 +1,264 @@
|
||||
## jenkins流水线
|
||||
|
||||
在上一章，已经将核心的环境给安装了，接下来我们可进行jenkins的流水线配置
|
||||
|
||||
> 这里开始配置的前提，需要将推荐插件下载，不安装插件流水线的功能都没有，同时检测`Publish Over SSH`插件是否已经安装，需要这个插件进行远程执行命令
|
||||
|
||||
## 配置凭据
|
||||
我们需要先将密钥配置好，因为我们等下的流水线的git拉去代码要将密钥进行登录
|
||||
|
||||
在`系统管理/凭据/系统/全局凭据 (unrestricted)`中添加一个用户名和密码的凭据，这里我们可以填写我们git仓库的的账号即可
|
||||
|
||||
## 配置免密登录
|
||||
这一步至关重要，由于我们会远程向其他服务器执行命名，需要先配置免密登录。
|
||||
|
||||
通常来说，jenkins只做拉去代码，打包发布成可执行的包，至于执行包发布给谁，可以通过ssh发送，对应的服务器只需要收到包，解压，然后直接启动即可，如果服务器资源不够，也可以考虑`127.0.0.1`当远程服务器
|
||||
|
||||
``` shell
|
||||
#获取rsa密钥对
|
||||
ssh-keygen -t rsa\
|
||||
|
||||
#将密钥进行拷贝
|
||||
ssh-copy-id -i /root/.ssh/id_rsa.pub root\@localhost
|
||||
```
|
||||
按以上的提示一步一步回车即可
|
||||
|
||||
如果提示命令没有找到，需安装openssh客户端
|
||||
``` shell
|
||||
yum -y install openssh-clients\
|
||||
```
|
||||
## Publish over SSH配置
|
||||
由于我们使用到这个插件进行命令与文件的传输
|
||||
|
||||
需要在`系统管理/System/Publish over SSH`中进行配置这个插件
|
||||
|
||||
主要就是针对的上方的免密登录功能
|
||||
|
||||
以下详细介绍每一个配置吧~
|
||||
``` shell
|
||||
name: 只是一个标识
|
||||
|
||||
Hostname: 远程ip，如果是本机可以localhost
|
||||
|
||||
Username：远程登录用户名，可以root
|
||||
|
||||
Remote Directory：远程传输根目录，待会传输文件的目录会拼接上这个，我是习惯传输到/home下，所以可以填写/home
|
||||
|
||||
Key 输入框粘贴 `/root/.ssh/id_rsa` 中的密钥，全部都要粘贴进去哦~
|
||||
```
|
||||
保存之前，可以进行测试，看以下是否成功！
|
||||
|
||||
## 环境变量配置
|
||||
如果之前配置的环境变量，不是系统环境变量，需要单独为jenkins赋上
|
||||
|
||||
不然执行命令，将提示命令未找到，主要是dotnet与npm
|
||||
|
||||
我们可以在`系统管理/System`中的全局属性下有一个`环境变量`
|
||||
``` shell
|
||||
key: PATH
|
||||
value: /usr/share/Modules/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin:/opt/dotnet:/opt/nodejs/node-v18.13.0-linux-x64/bin
|
||||
```
|
||||
|
||||
### 后端脚本编写
|
||||
|
||||
有了环境，我们可以将我们的代码手动发布上传，测试一下是否可以手动执行dotnet运行，如果成功，将说明环境安装成功
|
||||
|
||||
之后，我们可以写两个脚本，一个启动、一个关闭，放到我们的程序入口，关于程序的启动和关闭，可以由脚本来控制会减少很多的问题及困难
|
||||
|
||||
我们其实已经在程序里带出来了，就是框架中的`start.sh`及`end.sh`
|
||||
|
||||
``` shell
|
||||
#!/bin/bash
|
||||
./end.sh
|
||||
nohup dotnet Yi.Abp.Web.dll > /dev/null 2>&1 &
|
||||
echo "Yi-启动成功!"
|
||||
|
||||
|
||||
#!/bin/bash
|
||||
kill $(lsof -t -i:19001)
|
||||
echo "Yi-进程已关闭"
|
||||
|
||||
```
|
||||
|
||||
编写启动和停止脚本，我们还要给它赋值权限，否则不是一个有效的执行文件
|
||||
|
||||
``` shell
|
||||
chmod +x start.sh
|
||||
chmod +x end.sh
|
||||
```
|
||||
|
||||
> 这里如果提示：unix编码问题 ^M
|
||||
可以使用vim进行转码
|
||||
``` shell
|
||||
vim test.sh
|
||||
:set ff=unix
|
||||
:wq
|
||||
|
||||
```
|
||||
|
||||
|
||||
## 流水线编写
|
||||
|
||||
好了，到了这步，如果你一切顺利，恭喜你，准备进入流水线的脚本编写了
|
||||
|
||||
> 心急吃不了热豆腐，我们得静下心来，这块需要慢慢配置，一点一点调试
|
||||
|
||||
首页->新建任务->流水线
|
||||
|
||||
> 以下脚本为Yi框架的cicd脚本，后端与前端及各个项目是不一样
|
||||
|
||||
我这里已经将脚本编写好，可根据实际情况进行更改，主要是密钥和授权等
|
||||
|
||||
### 后端流水线脚本：
|
||||
``` java
|
||||
pipeline {
|
||||
agent any
|
||||
|
||||
stages {
|
||||
stage('git') {
|
||||
steps {
|
||||
git branch: 'abp', credentialsId: '38c9c74f-8658-4b8d-9ee7-d4c9923ef042', url: 'https://gitee.com/ccnetcore/Yi.git'
|
||||
echo '仓库克隆成功'
|
||||
}
|
||||
}
|
||||
stage('build') {
|
||||
steps {
|
||||
sh """
|
||||
cd Yi.Abp.Net8/src/Yi.Abp.Web;
|
||||
dotnet publish -c Release;
|
||||
"""
|
||||
echo '构建成功'
|
||||
}
|
||||
}
|
||||
stage('zip') {
|
||||
steps {
|
||||
sh """
|
||||
mkdir -p ./publish
|
||||
7za a ./publish/publish_01.zip ./Yi.Abp.Net8/src/Yi.Abp.Web/bin/Release/net8.0/publish/*;
|
||||
"""
|
||||
echo '压缩包成功'
|
||||
}
|
||||
}
|
||||
stage('publish') {
|
||||
steps {
|
||||
sshPublisher(publishers: [sshPublisherDesc(configName: 'ccnetcore', transfers: [sshTransfer(cleanRemote: false, excludes: '', execCommand: '''cd /home/yi/net8
|
||||
echo 开始解压
|
||||
unzip -o /home/yi/build/publish_01.zip -d ./
|
||||
echo 开始启动
|
||||
sh start.sh
|
||||
echo 启动成功''', execTimeout: 120000, flatten: false, makeEmptyDirs: false, noDefaultExcludes: false, patternSeparator: '[, ]+', remoteDirectory: 'yi/build', remoteDirectorySDF: false, removePrefix: 'publish', sourceFiles: 'publish/publish_01.zip')], usePromotionTimestamp: false, useWorkspaceInPromotion: false, verbose: true)])
|
||||
echo '发布成功'
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
```
|
||||
### 前端rbac脚本：
|
||||
``` shell
|
||||
pipeline {
|
||||
agent any
|
||||
|
||||
stages {
|
||||
stage('git') {
|
||||
steps {
|
||||
git branch: 'abp', credentialsId: '38c9c74f-8658-4b8d-9ee7-d4c9923ef042', url: 'https://gitee.com/ccnetcore/Yi.git'
|
||||
echo '仓库克隆成功'
|
||||
}
|
||||
}
|
||||
stage('build') {
|
||||
steps {
|
||||
sh """
|
||||
cd Yi.RuoYi.Vue3;
|
||||
npm config set registry https://registry.npm.taobao.org;
|
||||
npm i;
|
||||
npm run build:prod;
|
||||
"""
|
||||
echo '构建成功'
|
||||
}
|
||||
}
|
||||
stage('zip') {
|
||||
steps {
|
||||
sh """
|
||||
mkdir -p ./publish
|
||||
7za a ./publish/publish_rbac_01.zip ./Yi.RuoYi.Vue3/dist/*;
|
||||
"""
|
||||
echo '压缩包成功'
|
||||
}
|
||||
}
|
||||
stage('publish') {
|
||||
steps {
|
||||
sshPublisher(publishers: [sshPublisherDesc(configName: 'ccnetcore', transfers: [sshTransfer(cleanRemote: false, excludes: '', execCommand: '''cd /home/yi/rbac
|
||||
echo 开始解压
|
||||
unzip -o /home/yi/build/publish_rbac_01.zip -d ./
|
||||
echo 替换完成''', execTimeout: 120000, flatten: false, makeEmptyDirs: false, noDefaultExcludes: false, patternSeparator: '[, ]+', remoteDirectory: 'yi/build', remoteDirectorySDF: false, removePrefix: 'publish', sourceFiles: 'publish/publish_rbac_01.zip')], usePromotionTimestamp: false, useWorkspaceInPromotion: false, verbose: true)])
|
||||
echo '发布成功'
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
```
|
||||
|
||||
### 前端bbs脚本
|
||||
``` shell
|
||||
pipeline {
|
||||
agent any
|
||||
|
||||
stages {
|
||||
stage('git') {
|
||||
steps {
|
||||
git branch: 'abp', credentialsId: '38c9c74f-8658-4b8d-9ee7-d4c9923ef042', url: 'https://gitee.com/ccnetcore/Yi.git'
|
||||
echo '仓库克隆成功'
|
||||
}
|
||||
}
|
||||
stage('build') {
|
||||
steps {
|
||||
sh """
|
||||
cd Yi.Bbs.Vue3;
|
||||
npm config set registry https://registry.npm.taobao.org;
|
||||
npm install;
|
||||
npm run build;
|
||||
"""
|
||||
echo '构建成功'
|
||||
}
|
||||
}
|
||||
stage('zip') {
|
||||
steps {
|
||||
sh """
|
||||
mkdir -p ./publish
|
||||
7za a ./publish/publish_bbs_01.zip ./Yi.Bbs.Vue3/dist/*;
|
||||
"""
|
||||
echo '压缩包成功'
|
||||
}
|
||||
}
|
||||
stage('publish') {
|
||||
steps {
|
||||
sshPublisher(publishers: [sshPublisherDesc(configName: 'ccnetcore', transfers: [sshTransfer(cleanRemote: false, excludes: '', execCommand: '''cd /home/yi/bbs
|
||||
echo 开始解压
|
||||
unzip -o /home/yi/build/publish_bbs_01.zip -d ./
|
||||
echo 替换完成''', execTimeout: 120000, flatten: false, makeEmptyDirs: false, noDefaultExcludes: false, patternSeparator: '[, ]+', remoteDirectory: 'yi/build', remoteDirectorySDF: false, removePrefix: 'publish', sourceFiles: 'publish/publish_bbs_01.zip')], usePromotionTimestamp: false, useWorkspaceInPromotion: false, verbose: true)])
|
||||
echo '发布成功'
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
```
|
||||
|
||||
编写完成之后，可以逐步一下一下进行测试，看看哪里有问题再进行更改
|
||||
|
||||
> 以上脚本，都是一步一个脚印，一晚一行代码磨出来的，比较适合现在的场景，可推荐使用，坑比较少
|
||||
|
||||
## 进阶
|
||||
后续，你可以尝试`gitlab+jenkins+harbor+docker+k8s`的路线，这块橙子也是搭建过好几次，但需求点过于多，比较费劲，同时一般只有非常大型的项目才用的上，再次就不过多赘述了，想讲实战讲清楚，估计是当前篇幅至少10倍以上，里面的坑我之前pdf简单汇总了一次，大概就有23面以上，现在可能很有很多工具，安装应该没有那么简单了，不过我还暂时没有去接触的场景，如果你想像我一样，可以一起播撒这颗种子，让更多人的收获
|
||||
|
||||
## 结语
|
||||
可以看的出来，一个大家认为很简答的cicd，如果像从零开始一下一下搭建出来，坑还是蛮多的，爬出这些坑也是比较费事，并没有网上说的那么容易
|
||||
|
||||
本人这种环境搭建不下10次以上，也只是`无他，熟能生巧而已`
|
||||
|
||||
> 搞的多了，也就麻了，水来土挡，坑来我填
|
||||
|
||||
最后，如果你这边怀着激动心情，讲上述的过程全部跑成功了,那么恭喜你啦~我亲爱的朋友，这篇文章教程就有它真正的意义了！
|
||||
|
||||
Reference in New Issue
Block a user