.Net Core 使用jenkins 部署到远程服务器docker
最近一直在研究docker和kubernetes,小型的项目其实也用不到k8s,本文就是描述如何用jenkins 进行构建asp.net core 3.1项目并且发布到远程服务器docker容器中。本文也是对自己学习过程中的记录。
本文包含以下技术点:
1、CentOS 7 安装Jenkins与必要的配置
2、CentOS 7 安装 Git 与 dotnet core sdk
3、Jenkins全局配置与构建任务的配置
一、CentOS 7 安装Jenkins与必要的配置
首先需要安装java环境,因为Jenkins基于java。java的安装可参考 :https://www.cnblogs.com/stulzq/p/9286878.html
可以去Jenkins官网去下载rpm包,但是网速太慢了,这里推荐用 清华大学开源软件镜像站 去下载 Jenkins的rpm包。如下图:
这里下载2.223的最新版本,在centos 中使用: sudo wget https://mirrors4.tuna.tsinghua.edu.cn/jenkins/redhat/jenkins-2.223-1.1.noarch.rpm 命令进行下载:
然后使用命令:rpm -ivh jenkins-2.223-1.1.noarch.rpm 安装
配置jenkins 用户为root,这里可以避免很多权限问题,如下图:
使用命令 systemctl restart jenkins 重启jenkins。然后使用命令:systemctl status jenkins 查看下jenkins是否正常启动,如下图:
这时,我们就可以通过 http://ip:8080 进行访问了。具体的初始化配置,这里就略过,可以自行百度。
初始化jenkins的过程中,jenkins会让我们安装一些 推荐的插件,我们选择后,有些插件会安装失败,是因为软件源的问题。我们可以选择跳过,然后进入jenkins。
这里可以在 系统管理--》插件管理--》高级 选项卡中 的配置中,配置清华软件镜像站的地址 https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json,替换官方默认的地址,
然后我们再修复插件的安装。如下图:
我们利用jenkins构建完asp.net core 程序后,需要将发布好的文件推送到远程linux服务器中,还需要远程执行脚本,操作远程服务器的Docker,这时我们需要安装插件 Publish Over SSH
在 系统管理--》插件管理--》可选插件 选项卡中搜索该插件并进行安装。到这来我们就完成了 CenrOS 安装jenkins 并进行了一些初始化的配置。
二、CentOS 7 安装 Git 与 dotnet core sdk
我们需要利用jenkins 调用 git 去下载代码,这时我们肯定需要事先安装git。执行 yum install -y git 命令进行安装。
我们还需要利用jenkins执行 asp.net core 3.1 的Build 与 发布操作,我们也需要事先安装好 dotnet core 3.1 sdk 具体安装过程可参考微软官方文档:
https://docs.microsoft.com/zh-cn/dotnet/core/install/linux-package-manager-centos7
三、Jenkins全局配置与构建任务的配置
我们在上面的配置过程中安装了jenkins 需要用到的 git 以及publish over ssh 插件,在用这两个之前,我们需要在jenkins中进行一些全局的配置。
首先我们来看git的配置,在Jenkins 系统管理--》全局工具配置 我们需要输入git 的安装位置,如下图:
我们再来看 publish over ssh 插件的配置,在 系统管理--》系统配置 中,如下图:
上面的 Remote Directory 需要输入远程服务器的文件夹,该文件夹表示上传文件的存放目录
到这里,我们就可以开始新建 jenkins的构建任务了,我们可以点击新建任务,输入一个名字,选择自由风格的软件项目,如下图:
在源码管理中,输入你项目的git 地址以及添加一个对应的git的用户名和密码凭据 信息, 如下图:
在构建环境中,我们勾选以下配置:
在勾选的 Send files or execute commands over SSH after the build runs 中,SSH Server 就是我们在上一步在全局配置中配置的 publish over ssh 的ssh 名字。
Source files 是我们需要上传的文件,这里我们利用 dotnet 命令发布 asp.net core 项目,然后压缩成 tar.gz 的压缩文件,所以这里配置 **/.tar.gz ,**/ 是你当前构建项目jenkins的
工作目录。
在构建 中,我们选择 执行 shell ,如下图:
cd /var/lib/jenkins/workspace/test/aspnetweb
dotnet publish -c Release -o published
tar -czvf published.tar.gz published
命令总共三行,首先进入jenkins的工作目录,然后在该目录下,执行dotnet 发布命令,发布到published 文件夹
最后将 published 文件夹 进行压缩成 published.tar.gz
我们再选择 构建后操作,选择 Send build artifacts over ssh,如下图:
上图中的 SSH server 也是我们再全局配置中配置的,Source files 是我们要上传的文件,Exec command 是要在远程服务器执行的 脚本命令:
cd /root/remote/aspnetweb
tar -xvzf published.tar.gz
cd /root/remote/aspnetweb/published
docker stop aspnetweb
docker rm aspnetweb
docker rmi aspnetweb
docker build -t aspnetweb .
docker run -d -p:5001:80 --name aspnetweb aspnetweb
这里 我们也是进入到 远程服务器的 目录,解压上传的文件,然后 进行基本的 docker 容器操作。
在这里 我们发布的 asp.net core 目录中有一个 Dockerfile 文件,docker 才能进行 新的镜像的 build,Dockerfile 的文件内容如下:
FROM mcr.microsoft.com/dotnet/core/aspnet:3.1 AS runtime
WORKDIR /app
COPY . ./
ENTRYPOINT ["dotnet", "aspnetweb.dll"]
这里需要我们的远程服务器,安装docker,以及事先 docker pull mcr.microsoft.com/dotnet/core/aspnet:3.1 的镜像。
--------