AspNetCore容器化(Docker)部署(四) —

一.前言

（Jenkins、Docker、Git/Svn组建一套简单的自动化发布流程）

文章中用到的相关服务器角色

角色	环境	功能
开发机	Win10、Docker(Linux OS)	编码、调试
发布机(与开发机共享)	Win10、Docker(Linux OS)、Jenkins	自动化部署
测试服务器	Ubuntu、Docker	测试环境

二.安装jenkins

1.Windows下安装jenkins

各环境下安装教程 https://jenkins.io/zh/doc/book/installing/

Windows下载地址：https://jenkins.io/zh/download/thank-you-downloading-windows-installer-stable

建议jinkens还是安装在docker的宿主机上，不论是windows还是linux，容器形式安装虽然很方便！但是后续很多坑，比如jenkins容器内共享宿主机docker和容器内运行docker-compose

下面是docker下安装的一些笔记(没走通)，最终选择了宿主机下安装jinkens

PS C:\Users\Administrator> docker run -u root -d -p 8080:8080 -p 50000:50000 -v /e/DockerData:/var/jenkins_home -v /var/run/docker.sock:/var/run/docker.sock jenkinsci/blueocean

c8222a3716a327ce82770aa729fe80169cbcc28c4d2ada8891cf49ed0b38f3e3

PS C:\Users\Administrator> docker ps -a

CONTAINER ID        IMAGE                 COMMAND                  CREATED              STATUS                      PORTS                                              NAMES

c8222a3716a3        jenkinsci/blueocean   "/sbin/tini -- /usr/…"   About a minute ago   Up About a minute           0.0.0.0:8080->8080/tcp, 0.0.0.0:50000->50000/tcp   serene_feistel

66ff08eda2ae        c42e9f575fc4          "dotnet HelloWorld.d…"   2 days ago           Up 2 days                   0.0.0.0:81->80/tcp                                 netcore_helloworld

5357b641a7b1        9c18561d7ab3          "nginx -g 'daemon of…"   2 days ago           Up 2 days                   0.0.0.0:80->80/tcp, 0.0.0.0:801->801/tcp           mynginx

-v /e/DockerData:/var/jenkins_home，把jenkins_home目录(包含插件、配置、工作数据)挂载到宿主机。

这里宿主机是windows，/e/DockerData相当于"e:\DockerData"，前提是e盘必须被设置为Shared Drives，如果未设置会弹出提示。

/var/run/docker.sock:/var/run/docker.sock，映射宿主机的docker到jenkins容器。

进入jenkins容器内，查看宿主机docker信息

PS C:\Users\Administrator> docker exec -it c8222a3716a3 bash

bash-4.4# docker version

Client:

 Version:           18.09.1-ce

 API version:       1.39

 Go version:        go1.11.4

 Git commit:        4c52b901c6cb019f7552cd93055f9688c6538be4

 Built:             Fri Jan 11 15:41:33 2019

 OS/Arch:           linux/amd64

 Experimental:      false

Server: Docker Engine - Community

 Engine:

  Version:          18.09.2

  API version:      1.39 (minimum version 1.12)

  Go version:       go1.10.6

  Git commit:       6247962

  Built:            Sun Feb 10 04:13:06 2019

  OS/Arch:          linux/amd64

  Experimental:     false

还需要安装docker-compose，否则shell脚本通过compose来构建镜像时会报docker-compose not found。

docker-compose安装教程 https://docs.docker.com/compose/install/

这里跟宿主机不同的是，要选择在容器内的安装方式“INSTALL AS A CONTAINER”

PS C:\Users\Administrator> docker-compose -v  #查看宿主机docker-compose版本

docker-compose version 1.23.2, build 1110ad01

PS C:\Users\Administrator> docker exec -it c8222a3716a3 bash  #进入jenkins容器

bash-4.4# curl -L --fail https://github.com/docker/compose/releases/download/1.23.2/run.sh -o /usr/local/bin/docker-compose   #bash脚本安装compose

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current

                                 Dload  Upload   Total   Spent    Left  Speed

100   596    0   596    0     0    587      0 --:--:--  0:00:01 --:--:--   587

100  1666  100  1666    0     0    831      0  0:00:02  0:00:02 --:--:--  2127

bash-4.4# chmod +x /usr/local/bin/docker-compose

bash-4.4#

Unable to find image 'docker/compose:1.23.2' locally

1.23.2: Pulling from docker/compose

4fe2ade4980c: Pull complete                                                                                                                                                                                                                                                    658ccff8d4f1: Pull complete                                                                                                                                                                                                                                                    71166c3c8d42: Pull complete                                                                                                                                                                                                                                                    c246ed86dd59: Pull complete                                                                                                                                                                                                                                                    Digest: sha256:f6e4963cd17f709fb57f7cf0842e269ed6ba173c3490055b50c701a257feb860

Status: Downloaded newer image for docker/compose:1.23.2

bash-4.4# docker-compose -v   #查看jenkins容器内compose版本

docker-compose version 1.23.2, build 1110ad01

2.登入jenkins

浏览器打开localhost:8080

根据提示找到initialAdminPassword文件中的初始密码

接下来根据导航依次执行“安装默认插件” ，“创建jenkins账号”，“登入jenkins”

三.创建jenkins发布项目

1.新建Item

2.源码设置

如果是私有仓库需要加凭据Credentials

Failed to connect to repository:Error performing command:git.exe，如果有安装git，那就是“Global Tool Configuration”配置的git路径不对。

Manage Jenkins - Global Tool Configuration

设置正确的git.exe路径

设置好保存后再进入helloworld项目的配置页面。

3.构建触发器和构建环境

构建触发器，就是设置如何进行自动构建。如其他项目构建完后触发该项目的构建、定时构建(不论有没有代码变更)、轮询代码构建(jenkins轮询远程仓库有代码变更则进行构建)。

这里都不选，则需要在工作台使用手动(点击按钮)构建。

4.添加PowerShell脚本

linux选择shell，windows下建议用powershell，batch command对docker命令的支持不是很友好。

安装powershell插件

切换到“可选插件”选项卡，搜索powershell安装

添加构建命令

#定义变量

$IMAGE_VERSION='latest'

$REGISTRY_USER='镜像仓库账号'

$REGISTRY_PWD='镜像仓库密码'

$REGISTRY_HOST='ccr.ccs.tencentyun.com'

$REGISTRY_NAMESPACE='镜像仓库namespace'

$SERVICE_HELLOWORLD='helloworld'

$SERVICE_MYNGINX='mynginx'

#jenkins拉取的项目默认路径 “安装路径根目录/workspace/jenkins里面建的项目名”

$COMPOSE_PATH='D:\Program Files (x86)\Jenkins\workspace\helloworld\docker-compose.yml'

echo "------------------------------ 构建镜像 ------------------------------"

docker-compose -f "${COMPOSE_PATH}" build

echo "------------------------------ 登录远程仓库 ------------------------------"

docker login --username=${REGISTRY_USER} --password=${REGISTRY_PWD} ${REGISTRY_HOST}

echo "------------------------------ 标记镜像 ------------------------------"

docker tag ${SERVICE_HELLOWORLD}:${IMAGE_VERSION} ${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${SERVICE_HELLOWORLD}:${IMAGE_VERSION}

docker tag ${SERVICE_MYNGINX}:${IMAGE_VERSION} ${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${SERVICE_MYNGINX}:${IMAGE_VERSION}

echo "------------------------------ 推送到远程仓库 ------------------------------"

docker push ${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${SERVICE_HELLOWORLD}:${IMAGE_VERSION}

docker push ${REGISTRY_HOST}/${REGISTRY_NAMESPACE}/${SERVICE_MYNGINX}:${IMAGE_VERSION}

echo "------------------------------ 清理None ------------------------------"

docker rmi $(docker images -f "dangling=true" -q)

5.远程SSH

安装”Publish Over SSH“插件，安装完之后，进入到”Manage Jenkins“ - "Configure System"中配置远程服务器

Passphrase：SSH密码

Path to key：SSH私钥的文件路径

Key：私钥串，如果“Key”和“Path to key”都设置，则“Key”的优先级较高

Disable exec：禁止在目标机上执行命令

SSH Server 配置（指定远程服务器的ip，可以配置多个ssh server ）

Name：SSH节点配置的名称，在Job中使用Publish over SSH插件时，此名称将出现在“SSH Server”中“Name”的下拉列表中，如下图：

Hostname：通过SSH连接到的远程主机名或IP

Username：SSH服务使用的用户名，使用key进行连接时为key指定的用户名

详见插件官方介绍页 https://wiki.jenkins.io/display/JENKINS/Publish+Over+SSH+Plugin

添加一个docker-compose.staging.yml提交到git仓库，用于测试环境。

version: '3.4'

services:

  helloworld:

    image: ccr.ccs.tencentyun.com/wuuu/helloworld:latest

    environment: #环境变量

      - ASPNETCORE_ENVIRONMENT=Development

    ports: #端口映射

      - "81:80"

    container_name: netcore_helloworld

    deploy:

      restart_policy: #重启策略

        condition: on-failure

        delay: 5s

        max_attempts: 3

    networks: #指定network

      - newbridge

  mynginx:

    image: ccr.ccs.tencentyun.com/wuuu/mynginx:latest

    ports:

      - "80:80"

      - "801:801"

    container_name: mynginx

    deploy:

      restart_policy:

        condition: on-failure

        delay: 5s

        max_attempts: 3

    networks:

      - newbridge

networks:

  newbridge: #新的network

    #name: newbridge  #compose版本3.5开始才支持自定义名称

继续之前的构建，“增加构建步骤“ - ”Send files or execute commands over SSH“

Name：选择刚刚配置的远程服务器”Staging_Server“

Source files：要上传的文件的相对路径，多个文件以逗号分隔。相对workspace的路径(其实是相对workspace下项目的路径)，也支持表达式，如上图中的“**/*.war”。

如：我的项目通过jenkins git插件拉取下来，所在的目录是D:\Program Files (x86)\Jenkins\workspace\helloworld，docker-compose.staging.yml刚好在hellworld目录下，所以此处直接填文件名

如果yml文件在hellowrold/mycompose/目录下，则需要填写mycompose/docker-compose.staging.yml

Remove prefix：文件复制时要过滤的文件夹。

Remote directory：远程服务器上的文件夹，此文件夹路径是相对于“SSH Server”中的“Remote directory”。如果该文件夹不存在将会自动创建。

由于配置Staging_Server时Remote directory没有设置，并且时直接使用root账户登录Staging_Server的，所以Remote directory路径默认为root/

此处填/mydokcercompose，则文件会被复制到服务器的/root/mydokcercompose/docker-compose.staging.yml

Exec command：shell命令

#!/bin/bash

#定义变量

REGISTRY_USER='镜像仓库账号'

REGISTRY_PWD='镜像仓库密码'

REGISTRY_HOST='ccr.ccs.tencentyun.com'

COMPOSE_PATH='mydockercompose/docker-compose.staging.yml'

echo ------------------------------ 登录远程仓库 ------------------------------

docker login --username=$REGISTRY_USER --password=$REGISTRY_PWD $REGISTRY_HOST

echo ------------------------------ 卸载服务 ------------------------------

docker-compose -f $COMPOSE_PATH down

echo ------------------------------ 拉取镜像 ------------------------------

docker-compose -f $COMPOSE_PATH pull

echo ------------------------------ 启动服务 ------------------------------

docker-compose -f  mydockercompose/docker-compose.staging.yml up -d

echo ------------------------------ 清除None ------------------------------

docker rmi $(docker images -f "dangling=true" -q)

6.手动构建

7.完成

构建完成之后，查看构建日志是否有异常

查看jenkins服务器上构建的image

PS C:\Users\Administrator> docker images

REPOSITORY                               TAG                 IMAGE ID            CREATED             SIZE

ccr.ccs.tencentyun.com/wuuu/helloworld   latest              4024cdbb87dc        About an hour ago   265MB

helloworld                               latest              4024cdbb87dc        About an hour ago   265MB

ccr.ccs.tencentyun.com/wuuu/mynginx      latest              daca457eb2a9        7 hours ago         109MB

mynginx                                  latest              daca457eb2a9        7 hours ago         109MB

mcr.microsoft.com/dotnet/core/sdk        2.2-stretch         e4747ec2aaff        4 weeks ago         1.74GB

mcr.microsoft.com/dotnet/core/aspnet     2.2-stretch-slim    f6d51449c477        4 weeks ago         260MB

查看演示服务器的image和container

root@VM-16-9-ubuntu:~# docker images

REPOSITORY                               TAG                 IMAGE ID            CREATED             SIZE

ccr.ccs.tencentyun.com/wuuu/helloworld   latest              4024cdbb87dc        About an hour ago   265MB

ccr.ccs.tencentyun.com/wuuu/mynginx      latest              daca457eb2a9        7 hours ago         109MB

root@VM-16-9-ubuntu:~# docker ps -a

CONTAINER ID        IMAGE                                           COMMAND                  CREATED             STATUS              PORTS                                      NAMES

e1dc94a1886b        ccr.ccs.tencentyun.com/wuuu/mynginx:latest      "nginx -g 'daemon of…"   8 minutes ago       Up 7 minutes        0.0.0.0:80->80/tcp, 0.0.0.0:801->801/tcp   mynginx

3ad3db4fbd94        ccr.ccs.tencentyun.com/wuuu/helloworld:latest   "dotnet HelloWorld.d…"   8 minutes ago       Up 8 minutes        0.0.0.0:81->80/tcp                         netcore_helloworld

浏览器打开演示服务器IP:801

示例代码Github地址：https://github.com/wwwu/AspNetCore_Docker

AspNetCore容器化(Docker)部署(一) —— 入门
AspNetCore容器化(Docker)部署(二) —— 多容器通信
AspNetCore容器化(Docker)部署(三) —— Docker Compose容器编排
AspNetCore容器化(Docker)部署(四) —— Jenkins自动化部署