.Net Core自动化部署
. 文档背景
在开发测试和产品发布迭代过程中,需要频繁将代码部署到测试环境或者开发环境中,如果更改都需要手动重新部署,那将是一个比较繁重的任务,并且部署过程中也容易出现错误。本节将介绍如何通过Jenkins实现与Git的联动,即Jenkins监控代码托管仓库Git的状态,如果Git有变动,自动触发Jenkins执行构建操作。
.环境及前期准备
系统:CentOS 7.5 X64 、 dotnet SDK 2.1.7 、
软件:Jenkins、Git、docker ce 、k8s
本文档的前提是CentOS 7.5 X64系统下,且以上软件均已安装配置完成
Tips:关于k8s和docker的版本
如果kubernetes的版本为1.8-1.11,docker版本必须为1.11.2-1.13.1和docker-ce版本为17.03.x
如果kubernetes的版本从1.12开始,docker版本必须为17.06/17.09/18.06
并且,不同版本间的k8s的构建脚本之间也略有差异
.部署过程
- 首先,新建一个.Net Core项目
添加Docker支持
并选择Linux或者Windows平台,这取决你想要将程序发布在什么平台上
添加Docker支持会帮我们新建一个Dockerfile,内容如下:
FROM microsoft/dotnet:2.1-aspnetcore-runtime #基础镜像为dotnetcore
MAINTAINER gwDeveloper #作者
LABEL description="this is a test website" #描述
LABEL version="1.0" #描述
WORKDIR /app #工作目录
COPY . . #将当前目录下的文件,复制到WORKDIR目录
EXPOSE 5004 #容器暴露5004端口
ENTRYPOINT ["dotnet","JenkinsDemo.dll"] #运行donet命令,参数是JenkinsDemo.dll
Dockerfile编写完毕,将代码上传 (本文使用的是GitHub)
- Jenkins配置
我们本次新建的任务是自由风格的任务
选择新建自由风格的任务
因为我们要使用WebHook达到Push操作触发Jenkins自动构建的效果,所以,首先进行WebHook的配置
WebHook:当事件发生时,源网站可以发起一个HTTP请求到webhook配置的URL。配置之后,用户可以通过在一个站点触发事件,之后再调用另一个站点的行为。可以是任何操作
登录 Jenkins
在Github插件的配置中,点击“高级”按钮
覆盖 Hook URL输入 Jenkins地址+github-webhook/
配置Github项目仓库
点击 "Add webhook"
选择 "Let met select indibidual events" , 以Push为例
GitHub配置完毕,接下来继续Jenkins的配置,
配置Git地址并选择构建触发器,并且选择"Github Hook"触发
在本地代码库做一些修改,并Push至Github后,查看Jenkins构建效果
可以看到,已经已经通过push操作触发了构建动作,但是我们这里没有进行构建操作,但是说明webhook这条路是通的。
GitHub Hook Log 如下:
接下来进行构建
在Jenkins可以直接通过执行脚本命令进行构建操作
可以直接在Shell工具中将需要执行的脚本写下来,也可以把脚本文件放在服务器上,通过shell来调用,我们这里是直接写的脚本。但实际生产环境,我认为把脚本文件也使用git进行维护比较好,这样不用每次修改脚本都需要到服务器上,push操作的同时也可以更新脚本文件。
cd /var/lib/jenkins/workspace/JenkinsDemo/src/ #cd 到工作目录,也可以通过Jenkins全局变量($WorkSpace)代替路径
rm -rf /var/lib/jenkins/workspace/jenkins_publish #删除已存在的publish目录
mkdir /var/lib/jenkins/workspace/jenkins_publish #新建目录
dotnet publish -r centos.7-x64 -c:Release -o /var/lib/jenkins/workspace/jenkins_publish #dotnet 构建
cd /var/lib/jenkins/workspace/jenkins_publish #cd到构建好的项目目录
docker login -u dockerhubusername -p password #登录dockerhub(本步骤是因为k8s部署的时候需要从docker库拉取所需的docker镜像)
docker build -t dockerdemo . #docker build 构建镜像(docker build -t name . )**此处命令最后有一个 “.” 如果不加会导致构建失败**此处会默认使用本目录下的Dockerfile进行构建
docker push dockerhubusername/dockerdemo:lastest #docker push 镜像到远程仓库(docker tag image username/repository:tag)
kubectl apply -f deploy.yaml #使用yaml配置文件将最新的docker镜像部署到k8s集群
接下来是k8s的配置,我们在这里是直接调用已经放在服务器上的配置文件,k8s配置文件的格式如下:
apiVersion: extensions/v1beta1 #不同版本的k8s此处有所不同 针对 "kind:Deployment",1.6版本之前 apiVsersion:extensions/v1beta1; 1.6版本到1.9版本之间:apps/v1beta1; 1.9版本之后:apps/v1
kind: Deployment
metadata:
labels:
k8s-app: dockerdemo
name: dockerdemo
namespace: dockerdemo
spec:
replicas: 2 #RC管理的Pod,需要运行的副本数
selector:
matchLabels:
k8s-app: dockerdemo
template:
metadata:
labels:
k8s-app: dockerdemo
spec:
containers:
- name: dockerdemo #容器的名字
image: dockerhubusername/dockerdemo:lastest #容器使用的镜像地址
ports:
- containerPort: 80 #容器开放对外的端口
---
# ------------------- Service ------------------- #
kind: Service
apiVersion: v1
metadata:
labels:
k8s-app: dockerdemo
name: dockerdemo
namespace: dockerdemo
spec:
type: NodePort
ports:
- port: 5004 #供集群中其它container访问端口
targetPort: 80 #service对外暴露的端口,任何人访问80端口都会被service代理到后端pod的5004端口
nodePort: 30001 #节点暴露的端口
selector:
k8s-app: dockerdemo
以上内容都配置好了之后,我们可以再次push一次代码,查看部署情况
可以看到dockerfile脚本的执行情况,docker镜像已构建完成并 image已经构建完成并推送到远程服务器
(k8s脚本的执行待补充)