Linux下自动化部署ASP.NET CORE 3.1（Docker+Jenkins+Nginx）

一、先配置好Docker阿里云加速，可使用阿里云容器服务 （可本身在阿里云申请，要否则安装东西直接很慢）
注意：https://XXXX.mirror.aliyuncs.com为阿里云加速服务分配地址

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
"registry-mirrors": ["https://XXXX.mirror.aliyuncs.com"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

　　

二、安装Docker
使用脚本自动安装

$ curl -fsSL get.docker.com -o get-docker.sh
$ sudo sh get-docker.sh --mirror Aliyun

　　

三、安装JenKins
建立jenkins工做目录

mkdir /usr/local/jenkins

　　

拉取jenkins镜像

docker pull jenkins/jenkins:lts

　　

修改jenkins目录和docker目录权限,这里1000是容器中Jenkins 的用户 uid

chown -R 1000:1000 /usr/local/jenkins
sudo chown -R 1000:1000 /var/run/docker.sock

docker run -itd -p 8080:8080 -p 50000:50000 --name jenkins --privileged=true -v /usr/local/jenkins:/var/jenkins_home -v /usr/bin/docker:/bin/docker -v /var/run/docker.sock:/var/run/docker.sock jenkins/jenkins:lts 

　　

参数解释：
-p 8080:8080 -p 50000:50000 --映射jenkins端口
--name jenkins --容器名称本身命名
privileged=true --授予容器管理员权限
-v /usr/local/jenkins:/var/jenkins_home --映射jenkins目录
-v /usr/bin/docker:/bin/docker --映射docke目录 到时候须要在容器里执行docker命令
-v /var/run/docker.sock:/var/run/docker.sock --映射docker执行命令 到时候须要容器里执行docker命令。

配置JenKins
查看容器启动成功后，咱们能够经过地址+端口访问刚刚运行的Jenkins
例如http://IP地址:8080
安装成功访问后会以下图所示。

 

 

 

提示首次访问须要密码，咱们经过刚刚映射的Jenkins目录里查看这个默认密码。
默认密码路径：/usr/local/jenkins/secrets/ (注意前面usr/local/jenkins路径就是刚刚本身映射的目录)

 

 

 

 

 

 安装完成后建立一个用户名和密码，便可完成安装进入首页。

 

 

 

3. 建立项目

一、源代码编译发布工程

源代码发布工程即将源代码提交到git服务器，jenkins经过git拉取最新的源代码，并经过Dockerfile里的配置进行编译发布过程。而后经过Docker构建此镜像并运行到容器。

建立一个.Net Core Web项目。

 

建立项目的时候能够选择启用Docker支持。

 

 默认的Dockerfile是有帮咱们进行代码编译并发布动做的。因此默认的Dockerfile文件是适合和代码一块儿提交到服务器而后使用Docker进行构建镜像。

 项目建立完成后随代码一块儿提交到git服务器。(svn等也均可以)

git项目目录，注意将Dockerfile复制到根目录。因为到时候构建镜像的时候就是从根目录执行的。

二、已编译的Release工程

已编译的Release工程，此种方式适合git或svn在局域网的；又不但愿源代码不暴露到外网的须要。此种方式是将项目工程进行进行发布打包操做。例如java常见的打包成一个war包文件。.Net 就是生成对应的DLL 文件。

项目在发布以前咱们对项目的Dockerfile文件属性作个更改，以便在发布时将此文件复制到发布时的目录。

将发布文件发布到本身的git(或svn)目录，以下图所示的，必定要包含Dockerfile文件。发布后的文件，能够根据本身须要将没有更新DLL或者appsetting.json等文件剔除掉。只保留本次要更新的文件便可。

修改Dockerfile文件，由于默认的Dockerfile文件是包含编译发布的命令，因此这里要将这些相关命令操做删除掉；保留以下命令配置便可。

 

 保存而后提交到全部文件到git服务器。

提交后的git目录。

建议：不管是代码编译发布工程仍是已编译的Release工程，第一次使用Docker部署时最好先本身手动将这些文件拷贝到服务器，并手动构建对象并运行容器看是否成功；可否访问网站。也就是先不用Jenkins将这些流程本身手动走一遍，确保一些目录包括Dockerfile等都是配置正确的。

如只想将发布文件提交到git，能够下载git桌面版本，在本地新建项目，同步到git线上便可；

 

4.  建立JenKins任务

项目工程建立完成并提交到git服务器后，开始在Jenkins里面建立任务。

 

 

 输入项目描述，源代码管理选择本身对应的便可。

 

 

 我这里选择的git。第一次添加项目时须要添加一种受权方式点击右边添加按钮便可。

 

 

 选择添加受权方式 经常使用的就是用户名加密码或者SSH方式。

 

 

 下一步设置构建环境

 

 

 设置触发器，这里主要是设置自动触发条件，有定时构建、远程触发构建、轮询SCM。

这里只设置轮询SCM形式的，很简单的方式。意思是在指定间隔时间内会去轮询git或svn中版本是否有变化。若是有就当即构建该项目。其实就是作到只要代码提交了 则马上就能自动构建项目进行发布；不在须要其余任何操做了。

 

 

 选择构建—>执行shell;固然咱们这里是linux服务器全部多数选择执行shell。

 

 

 添加shell 命令

#!/bin/bash
# 获取短版本号
GITHASH=`git rev-parse --short HEAD`
docker stop webtest
docker rm webtest
echo ---------------Building Docker Image...------------------
docker build -t webtest:$GITHASH .
docker tag webtest:$GITHASH webtest:latest
echo ---------------Launching Container...------------------
docker run --name webtest -d -p 8005:80 webtest:latest 

应用--保存

在构建开始前，请确认已安装ASP.NET Core Runtime与.NET Core SDK

docker pull mcr.microsoft.com/dotnet/core/aspnet:3.1

docker pull mcr.microsoft.com/dotnet/core/sdk:3.1

请先提早安装，不然构建时可能会因没法安装而超时

自动开始构建了 注意jenkins这里时间是默认是utc时间。utc时间转换咱们北京时间是要+8小时的。

蓝色图标表明构建成功，若是失败会是红色

查看控制台输出信息，尤为构建失败时可以从里面获取到失败缘由等。

 

 

构建失败状况

一、ASPNETCORE项目发布中Dockfile文件中配置项没有修改

 

 

二、Docker命令不存在，目录权限没有设置

 

 三、构建时超时，aspnetcore运行时没有安装

 

 nginx安装

docker pull nginx:latest

docker run --name nginx-test -p 8080:80 -d nginx

　　

参数说明：

--name nginx-test：容器名称。

-p 8080:80： 端口进行映射，将本地 8080 端口映射到容器内部的 80 端口。

-d nginx： 设置容器在在后台一直运行。

 

nginx 代理设置

docker ps -a  获取nginx容器ID

docker exec -it 容器ID /bin/bash 进入容器

由于容器没有安装VIM，先安装VIM

apt-get update && apt-get install vim -y

进入/etc/nginx/conf.d

新建文件

vim xxxx.conf

server {
    listen        80;
    server_name   example.com *.example.com;
    location / {
        proxy_pass         http://localhost:5000;
        proxy_http_version 1.1;
        proxy_set_header   Upgrade $http_upgrade;
        proxy_set_header   Connection keep-alive;
        proxy_set_header   Host $host;
        proxy_cache_bypass $http_upgrade;
        proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Proto $scheme;
    }
}

可参考

https://docs.microsoft.com/zh-cn/aspnet/core/host-and-deploy/linux-nginx?view=aspnetcore-3.1

nginx -t  配置文件检测

nginx -s reload 更新配置文件

最后成果：