AspNetCore容器化(Docker)部署(四) —— Jenkins自动化部署

一.前言

 

                                                 （jenkins、docker、git/svn组建一套简单的自动化发布流程）

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

角色	环境	功能
开发机	win10、docker(linux os)	编码、调试
发布机(与开发机共享)	win10、docker(linux os)、jenkins	自动化部署
测试服务器	ubuntu、docker	测试环境

 

 

 

 

 

 

二.安装jenkins

1.windows下安装jenkins

各环境下安装教程 

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安装教程 

这里跟宿主机不同的是，要选择在容器内的安装方式“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自动化部署