关于Jenkins + Docker + ASP.NET Core自动化部署的问题(避免踩坑)
本来没想着要写这篇博客,但是在实操过程中,一个是被网络问题搞炸了心态(真心感觉网络能把人搞疯,别人下个包、下个镜像几秒钟搞定,我看着我的几kb小水管真是有苦说不出),另一个就是这里面坑还是有一些的,写出来也是为了让大家避免重复踩坑
几个注意点:
- 下方shell命令绝大部分都需要管理员权限,所以如果你使用的用户不是root,则都要加上sudo
- 对于较复杂的命令我都提供了注释版和无注释版,无注释版是为了让你复制起来方便
准备工作
- centos 7.x
- docker
- jenkins
- 一份支持 docker 的 asp.net core 应用程序代码,可以直接用我的:https://github.com/xiaoxiaotank/myaspnetcoreapp
安装docker
官方文档:
1.如果你选择的是一个新系统,则建议首先更新 yum 和系统内核
yum update
2.确保卸载旧版docker
- /var/lib/docker/ 下的镜像、容器、卷和网络都会保留
- 旧版本中docker被命名为
docker
或docker-engine
,现在被命名为docker-ce
yum remove docker \ docker-client \ docker-client-latest \ docker-common \ docker-latest \ docker-latest-logrotate \ docker-logrotate \ docker-engine
3.安装 yum-utils(其提供了yum-config-manager,下方要用到)
yum install -y yum-utils
4.配置 yum 阿里云 docker 仓库docker官方仓库:
yum-config-manager --add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo
5.安装 docker
yum install -y docker-ce docker-ce-cli containerd.io
6.配置 docker 镜像加速器获取加速器
地址:
sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json <<-'eof' { "registry-mirrors": ["这里填入你的加速器url"] } eof sudo systemctl daemon-reload sudo systemctl restart docker
7.查看 docker 信息
docker info
8.hello-world 测试
docker run hello-world
安装并初始化jenkins
官方文档:
先说一下:官方文档中使用了镜像docker:dind
来执行docker命令和运行程序容器,我感觉完全没啥必要,而且引入这玩意会带来很多额外的问题,所以我没用它。
如果你想了解dind,请访问和这篇
安装jenkins
1.创建dockerfile文件
vim dockerfile
2.在dockerfile文件中填入以下内容
- tag参考:
- 注意:不要使用过时的镜像
jenkins,而应该使用镜像 jenkins/jenkins
from jenkins/jenkins:lts-jdk11 user root run apt-get update && apt-get install -y apt-transport-https \ ca-certificates curl gnupg2 \ software-properties-common run curl -fssl https://download.docker.com/linux/debian/gpg | apt-key add - run apt-key fingerprint 0ebfcd88 run add-apt-repository \ "deb [arch=amd64] https://download.docker.com/linux/debian \ $(lsb_release -cs) stable" # 安装 docker-ce-cli 才能在 jenkins 中发送 docker 命令到 docker daemon run apt-get update && apt-get install -y docker-ce-cli
3.构建镜像
docker build . -t myjenkins
如果出现警告:[warning] ipv4 forwarding is disabled. networking will not work.
其实就是说你的linux没有开启 ipv4 数据包转发功能
可以先尝试重启docker解决
systemctl restart docker
如果无效,则
# 1. 打开 sysctl.conf vim /etc/sysctl.conf # 2.添加下面一行 net.ipv4.ip_forward=1 # 3.重启 network 和 docker systemctl restart network && systemctl restart docker
4.运行jenkins注释版
docker run \ --name jenkins \ # 给容器起个名字,叫做 jenkins --detach \ # 以后台分离模式运行 --publish 8080:8080 \ # host 8080端口映射容器8080端口 --publish 50000:50000 \ # host 50000端口映射容器50000端口 --volume jenkins-data:/var/jenkins_home \ # 卷 jenkins-data 映射容器路径/var/jenkins_home,这样就可以在host上直接修改jenkins配置了 --volume /var/run/docker.sock:/var/run/docker.sock \ # host 上的docker sock映射容器的docker sock,这样容器内的docker命令都会发送到host上的docker中来执行 myjenkins # 使用刚刚构建的镜像 myjenkins 来运行容器
无注释版
docker run \ --name jenkins \ --detach \ --publish 8080:8080 \ --publish 50000:50000 \ --volume jenkins-data:/var/jenkins_home \ --volume /var/run/docker.sock:/var/run/docker.sock \ myjenkins
5.更换jenkins插件源
前面我们将容器内的路径 /var/jenkins_home
映射到了volume jenkins-data
,而所有的docker volume 都存放在目录 /var/lib/docker/volumes/下
打开hudson.model.updatecenter.xml
vim /var/lib/docker/volumes/jenkins-data/_data/hudson.model.updatecenter.xml
将文件中的url改为清华大学官方镜像:
即:
<?xml version='1.1' encoding='utf-8'?> <sites> <site> <id>default</id> <!--原 url: https://updates.jenkins.io/update-center.json --> <url>https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json</url> </site> </sites>
重启 jenkins:
docker restart jenkins
初始化jenkins
访问:输入管理员初始密码查看管理员初始密码:
cat /var/lib/docker/volumes/jenkins-data/_data/secrets/initialadminpassword
选择“安装推荐的插件”
经过漫长的等待之后,由于网络环境、依赖项的问题,很可能出现某些插件安装失败,不过咱们先点击“继续”,进去再修复
接下来创建一个自己的管理员帐号,确认jenkins url
进来后,jenkins的主页面就长这个样子
我们先来修复一下安装失败的插件
点击左侧菜单栏“manage jenkins”,将jenkins升级为最新版
在 update center 页面时记得勾选最下方的“安装完成后重启jenkins(空闲时)”
自动化配置和部署
点击jenkins页面左侧菜单第一个“新建任务”,填入任务名,选择*风格
填入如下配置信息,并保存
shell命令如下:
image_tag=`date +%y%m%d%h%m%s`; echo $image_tag; # build镜像并且打上tag docker build -t myapp:$image_tag .; docker images; # 停止并删除旧版 myapp container cid=$(docker ps | grep "myapp" | awk '{print $1}') echo $cid if [ "$cid" != "" ];then docker stop $cid docker rm $cid fi # 把刚刚build出来的镜像跑起来 docker run -p 5000:80 --name myapp -d myapp:$image_tag; docker ps -a; docker logs myapp;
点击左侧菜单“立即构建”,来部署我们的aspnetcoreapp,并查看“控制台输出”,当最终出现“finished: success”时表示部署成功
访问:http://<host-ip>:5000/hello (注意加上hello)
2021-05-12t15:28:43.9032704+00:00: hello !
此时查看docker中正在运行的容器:
container id image command created status ports names e167a135f7a0 myapp:20210512152453 "dotnet myaspnetcore…" 2 minutes ago up 2 minutes 0.0.0.0:5000->80/tcp, :::5000->80/tcp myapp e83a2570c334 myjenkins "/sbin/tini -- /usr/…" about an hour ago up about an hour 0.0.0.0:8080->8080/tcp, :::8080->8080/tcp, 0.0.0.0:50000->50000/tcp, :::50000->50000/tcp jenkins
注意事项
1. 关于 jenkins blueocean 等插件下载安装
如果jenkins想要安装插件 bluocean 等, 不要学官网将安装命令放放在dockerfile中,即使加了参数--jenkins-update-center
来指定加速源,也不建议这样做。因为我刚开始也想着尽量自动化,可是因为网络问题,导致插件一直下载安装失败,从而导致镜像一直构建失败,白白浪费了我两三个小时(真的很痛苦)
另外,你也可以在安装jenkins时,直接使用镜像 jenkinsci/blueocean ,该镜像包含了 blueocean 的相关插件。
2. 关于 myapp 容器 端口映射 5000 : 80
因为我的 dockerfile 文件中向外暴露的端口是80,所以我用host的端口5000映射了容器端口80,这个地方要按照你的实际情况来做出更改。
3. 如果你对 dind (docker in docker) 感兴趣
如果你想了解dind,请访问和这篇
以上就是关于jenkins + docker + asp.net core自动化部署的问题的详细内容,更多关于jenkins + docker + asp.net core自动化部署的资料请关注其它相关文章!