欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

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

程序员文章站 2022-09-27 22:34:20
一.前言 (Jenkins、Docker、Git/Svn组建一套简单的自动化发布流程) 文章中用到的相关服务器角色 二.安装jenkins 1.Windows下安装jenkins 各环境下安装教程 https://jenkins.io/zh/doc/book/installing/ Windows下 ......

一.前言

 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

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

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

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

 

三.创建jenkins发布项目

1.新建item

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

 

2.源码设置

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

failed to connect to repository:error performing command:git.exe,如果有安装git,那就是“global tool configuration”配置的git路径不对。

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

 

manage jenkins - global tool configuration

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

 

设置正确的git.exe路径

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

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

 

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

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

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

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

 

4.添加powershell脚本

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

安装powershell插件

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

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

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

 

添加构建命令

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

#定义变量
$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"中配置远程服务器

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

 

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“

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

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.手动构建

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

 

7.完成

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

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

 

查看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

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

 

示例代码github地址https://github.com/wwwu/aspnetcore_docker