边缘化搭建 DotNet Core 2.1 自动化构建和部署环境(下)

写在前面

 　　本篇文章是上一篇边缘化搭建 DotNet Core 2.1 自动化发布和部署(上)的后续操做，本文主要讲解如何开启Docker Remote API，开启Remote API后的权限安全问题。配置Jenkins构建项目，并在云服务器上构建成功。废话很少说，咱们一块儿来动手操做吧。

先决条件

1.一台Debain 9系统 x86 服务器 硬件环境：1核2G 40G硬盘。

2. x86服务器成功安装并运行Docker环境（本文不阐述安装过程，读者可查阅参考文献）

2.根据上一篇边缘化搭建 DotNet Core 2.1 自动化发布和部署(上)搭建好的边缘计算环境 

开启Docker Remote API

　　Remote API主要用于远程访问Docker守护进程从而下达指令的。 所以，咱们在启动Docker守护进程时，须要添加-H参数并指定开启的访问端口。 一般，咱们能够经过编辑守护进程的配置文件来实现。不过对于不一样操做系统而言，守护进程启动的配置文件也不尽相同。可是如今咱们不须要去改动系统原有的配置文件，经过drop-in file方式进行覆盖配置，因此在不改动系统配置文件的方式下，咱们的覆盖配置文件的路径基本保持一致。

建立 override.conf

　　咱们须要在x86服务器上建立 override.conf 配置文件。

$ mkdir -p /etc/systemd/system/docker.service.d/
$ nano override.conf

编辑 override.conf 

　　1.将如下内容加入到override.conf文件

[Service]
ExecStart=
ExecStart=/usr/bin/dockerd -H fd:// -H tcp://0.0.0.0:2376

　　2.重启Docker服务

$ sudo systemctl daemon-reload
$ sudo systemctl restart docker.service

测试Remote API

$ curl http://your ip:2375/info 

　　测试成功将返回以下信息：

 

开启 Remote API 安全认证

　　到目前位置，咱们已经在x86服务器开启Docker Remote API来控制Docker服务。可是，细心的读者应该已经发现，在这个链接访问的过程当中并无安全认证机制，也就是说任何人只要知道Remote API地址和端口均可以控制Docker 服务，然而这样将会大大增长了服务的风险。接下来笔者将告诉你们如何为Remote API添加认证机制。

生成证书

　　1.新建一个命名为 createSSL.sh 的 Shell 脚本文件。

$ sudo nano createSSL.sh

　　2.在 createSSL.sh 文件中加入如下代码：

#!/bin/bash
set -e
if [ -z $1 ];then
        echo "input file location"
        exit 0
fi

VAR=$1   
mkdir -p $1
cd $1

openssl genrsa -aes256 -out ca-key.pem 4096
openssl req -new -x509 -days 365 -key ca-key.pem -sha256 -out ca.pem
openssl genrsa -out server-key.pem 4096
openssl req -subj "/CN=$VAR" -sha256 -new -key server-key.pem -out server.csr
echo subjectAltName = DNS:$VAR,IP:127.0.0.1 > extfile.cnf
openssl x509 -req -days 365 -sha256 -in server.csr -CA ca.pem -CAkey ca-key.pem -CAcreateserial -out server-cert.pem -extfile extfile.cnf
openssl genrsa -out key.pem 4096
openssl req -subj '/CN=client' -new -key key.pem -out client.csr
echo extendedKeyUsage = clientAuth > extfile.cnf
openssl x509 -req -days 365 -sha256 -in client.csr -CA ca.pem -CAkey ca-key.pem -CAcreateserial -out cert.pem -extfile extfile.cnf
rm -v client.csr server.csr
chmod -v 0400 ca-key.pem key.pem server-key.pem
chmod -v 0444 ca.pem server-cert.pem cert.pem

　　3.执行生成证书操做。

$ sh createSSL.sh master

　　第一个ca-key.perm 生成时可能须要你输入一个密码，随便就能够了，只要记得住。此处略有坑，不能一路回车，$VAR 输入的参数必须是域名，这波操做是在配置jenkins docker插件时发现的。笔者使用的域名是：master ，为了各位读者能顺利进行教程操做，请跟笔者一块儿使用相同的域名。

配置 override.conf 

　　1.将生成的ca.pem, server-cert.pem, server-key.pem 文件复制到 /root/.docker 目录下。固然此目录并不是固定的，读者能够根据本身的心情来存放其余的目录路径。目录存放的路径绝对不能错，否者docker.service 将会启动不了。

$ mkdir -p /root/.docker
$ cp {ca,server-cert,server-key}.pem /root/.docker/

　　2.最终 /etc/systemd/system/docker.service.d/override.conf 文件内容以下：

[Service]
ExecStart=
ExecStart=/usr/bin/dockerd -H unix:///var/run/docker.sock -D -H tcp://0.0.0.0:2376 --tlsverify --tlscacert=/root/.docker/ca.pem --tlscert=/root/.docker/server-cert.pem --tlskey=/root/.docker/server-key.pem

　　3.重启Docker服务

$ sudo systemctl daemon-reload
$ sudo systemctl restart docker.service

测试 Remote API 安全认证

　　测试的使用记得必定要使用域名进行访问，若是没有设置域名解析，能够经过修改本地的host的方式进行实现。

curl https://master:2376/info --cert /root/master/cert.pem --key /root/master/key.pem --cacert /root/master/ca.pem

建立Jenkins项目

　　接下来，咱们进入使用树莓派搭建好的Jenkins系统新建项目，并经过 docker-compose 方式启动项目。Let's do it

下载证书

　　经过SSH链接树莓派后，将x86服务器上生成的 ca.pem，server-cert.pem，server-key.pem 证书下载到树莓派 /var/jenkins_home/cert/master 目录。

$ sudo mkdir -p /var/jenkins_home/cert/master
$ sudo scp rtdsoft@192.168.6.200:/home/loongle/master/{cert,key,ca}.pem /var/jenkins_home/cert/master

新建任务

　　1.构建一个自由风格的软件项目

　　2.设置源码地址，为了方便各位读者，笔者已经新建一个项目代码仓，读者能够直接使用这个仓，快速跑一遍流程。git 地址：https://gitee.com/wenalu/Rpi-MvcTest.git

 

　　3.设置构建触发器，让项目能够定时轮询仓库，执行自动构建，本次配置的参数为2分钟获取一次。

　　4.新增构建，选择执行Shell，并填写如下脚本内容

#!/bin/bash
# 获取短版本号
docker ps
pwd
ls

echo ----------------------------------------
whoami
echo ----------------------------------------

GITHASH=`git rev-parse --short HEAD`
echo ---------------Docker Three------------------
docker-compose --tlsverify \
  --tlscacert=/usr/local/jenkins/cert/master/ca.pem \
  --tlscert=/usr/local/jenkins/cert/master/cert.pem \
  --tlskey=/usr/local/jenkins/cert/master/key.pem \
  -H=master:2376 \
  -f ./docker-compose.yml -f ./docker-compose.override.yml  -p dockercompose4255153253317384266 down --rmi local --remove-orphans
  
  
docker-compose --tlsverify \
  --tlscacert=/usr/local/jenkins/cert/master/ca.pem \
  --tlscert=/usr/local/jenkins/cert/master/cert.pem \
  --tlskey=/usr/local/jenkins/cert/master/key.pem \
  -H=master:2376 \
  -f ./docker-compose.ci.build.yml -p dockercompose4255153253317384266 config
  
  
docker-compose --tlsverify \
  --tlscacert=/usr/local/jenkins/cert/master/ca.pem \
  --tlscert=/usr/local/jenkins/cert/master/cert.pem \
  --tlskey=/usr/local/jenkins/cert/master/key.pem \
  -H=master:2376 \
  -f ./docker-compose.ci.build.yml -p dockercompose4255153253317384266 up --build



echo ---------------Publishing...------------------
docker-compose --tlsverify \
  --tlscacert=/usr/local/jenkins/cert/master/ca.pem \
  --tlscert=/usr/local/jenkins/cert/master/cert.pem \
  --tlskey=/usr/local/jenkins/cert/master/key.pem \
  -H=master:2376 \
  -f "./docker-compose.yml" -f "./docker-compose.override.yml"  -p dockercompose4255153253317384266 up -d --build

注意事项 

　　请各位读者在填写执行Shell内容时注意 -H=master:2376 ，master的含义是生成证书使用的域名，亦是在上篇博文中，启动 Jenkins 添加 --add-host 解析参数，笔者填写的解析IP：192.168.6.200，因此最后笔者访问master将会指向6.200的机器。固然，读者若使用的是云服务器，而且配置了域名解析，那么只须要将 master 改为解析的域名便可，不须要在启动 Jenkins 添加 --add-host 参数。请各位读者谨记，避免踩坑。为了方便各位读者，重贴启动 Jenkins 代码，请按需修改启动参数。

$ sudo docker run --name=jenkins --restart=always --add-host master:192.168.6.200 -p 8080:8080 -p 50000:50000 -v /var/run/docker.sock:/var/run/docker.sock -v $(which docker):/bin/docker -v /var/jenkins_home:/usr/local/jenkins/ -d auto-jenkins

 测试

　　当各位读者的构建结果最后输出的信息最终和笔者保持一致的时候，那么整个流程就跑完了。

 

写在后面

　　至此，本篇内容已经所有完毕了，博文中可能有不少表述不太专业的地方，还请各位读者指点交流。其实本文章标题有另一个《「穷」式搭建 DotNet Core 2.1 自动化发布和部署》，后来考虑好久不用这个标题是由于自己本身属于这个行业的专业人士，不能用比较庸俗的词来表述这篇文章，因此才有如今的这个标题。很开心我终于写完了，写这一大章的内容真的挺不容易，也挺佩服那些坚持下来，写了那么多博文的做者是怎么走过来的。为他们对社区做出的贡献喝彩吧。大吉大利，今晚吃鸡

参考文献

https://docs.docker.com/install/linux/docker-ce/debian/

https://success.docker.com/article/how-do-i-enable-the-remote-api-for-dockerd

https://blog.csdn.net/laodengbaiwe0838/article/details/79340805