WTM框架使用技巧之:CI/CD(持续集成/持续部署)
阅读原文时间:2023年07月08日阅读:8

1. 什么是WTM框架?

  一个快速、灵活、社区活跃、最最最最高效的.netcore 后台管理系统。详见 https://wtmdoc.walkingtec.cn/

  欢迎大家付费支持WTMPlus,反哺社区(我已充值,还未使用,等vue3版本)。

2. 通过本文可以实现什么?

通过使用主流的开源软件或技术实现WTM项目自动化部署到ubuntu系统。

  1. 通过Gitee管理WTM项目代码
  2. 通过Jenkins获取代码提交事件,从而生成WTM镜像
  3. 容器运行WTM镜像

3. 你需要准备什么?

  1. 准备一台Ubuntu云服务器(或虚拟机安装花生壳,因为要用到外网)
  2. ubuntu、git、docker的基础知识(没了解过也无所谓,我会手摸手)
  3. 准备好耐心,本文适合对ubuntu不是很熟悉,但是想把WTM运行在Ubuntu上的朋友。包括git、gitee配置、jenkins安装配置部署,很多都是一劳永逸的,坚持下来,会有收获

4. 安装配置基础环境

4.1关于gitee

4.1.1 什么是gitee

国产免费git源码管理平台

4.1.2 gitee可以干什么

多人协作 、代码备份、触发自动化构建(webhook)

4.1.3 下载安装git https://git-scm.com/download/win

4.1.4 下载安装tortoisegit及语言包 https://tortoisegit.org/download/

4.2  git管理WTM代码

4.2.1 新建WTM项目

简单起见,先使用sqlite

4.2.2 gitee注册、登陆

4.2.3 gitee管理wtm代码

新建代码仓

复制代码仓地址

克隆代码仓,输入代码仓地址

wtm代码放入git所在文件夹

提交代码

推送代码

刷新gitee页面,可以看到提交的代码

4.3 关于docker

4.3.1 什么是docker

将WTM和.netcore运行时打包在一起,生成一个镜像,从而运行在任何操作系统中

4.3.2 docker安装

sudo curl -fsSL https://get.docker.com | bash -s docker

4.4 关于Jenkins

4.4.1 jenkins

基于java的持续集成工具,用来实现自动获取gitee提交事件,拉去代码、编译代码、构建WTM镜像、运行WTM镜像。

4.4.2 jenkins安装

注意这里没有持久化。

sudo docker run -d --restart always --name testjenkins -p 8888:8080 -p 50001:50000 -e TZ="Asia/Shanghai" \
-v /var/run/docker.sock:/var/run/docker.sock -v $(which docker):/usr/bin/docker -d jenkins/jenkins:lts

进入jenkins容器

cat /var/jenkins_home/secrets/initialAdminPassword

查看jenkins初始密码

cat /var/jenkins_home/secrets/initialAdminPassword

修改docker权限

sudo chmod 777 /var/run/docker.sock

访问主机9090端口,用户名jenkins 密码是刚刚获取到的

系统管理=>插件管理=>高级=>最下方升级站点 输入  https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

4.4.3 安装gitee插件

4.4.4 gitee新增令牌

4.4.5 jenkings 配置gitee插件

系统管理=>系统配置

添加Gitee凭据,用自己的gitee用户名和密码

4.4.6 新建任务

**

生成一个webhook密码,先记下来

构建新增shell,等下步执行完后再保存

#!/bin/bash
echo start
docker build -t wtmtest .
docker stop wtmapp
docker rm wtmapp
docker run -d --restart always --name wtmapp -p 8888:80 wtmtest
docker restart wtmapp

配置gitee的webhook,保存后,再保存上一步的jenkins

5.修改WTM源码

wtm MVC项目配置文件新增,以防止其余的多语言看起来比较乱

zh-Hans,en

6.修改Dockerfile

#See https://aka.ms/containerfastmode to understand how Visual Studio uses this Dockerfile to build your images for faster debugging.

FROM mcr.microsoft.com/dotnet/aspnet:5.0-buster-slim AS base
WORKDIR /app
EXPOSE 80

RUN apt-get update
RUN apt-get install libgdiplus -y
RUN apt-get install nano -y

FROM mcr.microsoft.com/dotnet/sdk:5.0-buster-slim AS build
WORKDIR /src
COPY ["WTMtest/WTMtest.csproj", "WTMtest/"]
RUN dotnet restore "WTMtest/WTMtest.csproj"
COPY . .
WORKDIR "/src/WTMtest"
RUN dotnet build "WTMtest.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "WTMtest.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .

ENV TZ=Asia/Shanghai

ENTRYPOINT ["dotnet", "WTMtest.dll"]

7. 提交、推送源码

8. 查看jenkins

  耐心等待,第一次比较慢,看网络环境要10-20分钟左右,后面就会很快,因为有了基础镜像

9. 查看wtm页面

访问云服务器的8888端口(别忘了打开防火墙),可以看到经典的WTM桌面啦。

重点是我们修改过的页面