docker+jenkins自动部署前端项目(一)

3,372 阅读5分钟

最近工作不是很繁忙,抽空研究了如何用docker自动部署前端项目,特地记录一下,方便以后查阅。在下系统为centos8,jenkins是安装到了要部署的服务器上,所以当前没有远程部署的步骤,整个过程分为3部分:①安装docker ②docker安装配置jenkins ③项目添加部署脚本

centos8安装docker

切换到root用户,执行一下代码安装

  yum install -y yum-utils \
  device-mapper-persistent-data \
  lvm2

设置docker后续拉取镜像时的仓库地址:

  yum-config-manager \
  --add-repo \
  https://download.docker.com/linux/centos/docker-ce.repo

然后安装docker社区版和命令行等:

yum install docker-ce docker-ce-cli containerd.io

如果安装的时候失败,报错信息显示containerd.io的版本过低不符合要求,那么可以本地重新安装containerd.io,首先下载安装包:

wget https://download.docker.com/linux/centos/7/x86_64/edge/Packages/containerd.io-1.2.6-3.3.el7.x86_64.rpm
yum -y install containerd.io-1.2.6-3.3.el7.x86_64.rpm

安装成功之后再次执行docker的安装命令,docker安装成功之后设置开机自启动:

# 开机自启
systemctl enable docker
# 启动coker服务
systemctl start docker

此时docker已经安装完毕,查询docker版本确认docker安装正确,如显示版本号,则安装正确。

docker -v

更改镜像加速地址,安装完毕后默认没有deamon.json文件,需要手动创建,在下购买的是阿里云的服务器,所以加速地址也配置为阿里云了。

mkdir -p /etc/docker
tee /etc/docker/deamon.json <<-'EOF'
{ "registry-mirrors":["https://sdh86fuc.mirror.aliyuncd.com"]}
EOF

使deamon.json生效,重启docker

systemctl deamon-reload
systemctl restart docker

docker常用命令

docker ps -a 查看所有容器

docker ps 查看运行中的容器

docker start 容器id/名称 启动容器

docker stop 容器id/名称 关闭容器

docker exec -it container-id/name /bin/bash 命令行进入容器内部,使用exit退出,容器不会停止

docker rm -f id/name 删除容器

docker images 查看所有镜像

docker rmi name 删除镜像

docker run -itd --name node-test node 后台运行以node为镜像的容器,名称为node-test

docker run –-name mynginx –d –p 80:80 –v /software/nginx/mynginx.conf:/etc/nginx/nginx.conf nginx 使用nginx镜像创建一个nginx容器,-p 映射80端口,-v 挂载本地文件到etc也就是容器的文件夹下

docker安装jenkins

拉取jenkins镜像

docker pull jenkins/jenkins

创建jenkins工作文件夹,更改文件夹权限

mkdir -p /var/jenkins_test
chmod 777 /var/jenkins_test

以拉取的jenkins镜像运行容器实例,-d 后台运行, -p jenkins默认端口为8080,将其映射到宿主机的9090端口,-v 将容器Jenkins中的 /var/jenkins_home工作目录挂载到宿主机的 /var/jenkins_test目录下,时区也更改,-v $(which docker):/usr/bin/docker -v /var/run/docker.sock:/var/run/docker.sock 映射docker命令,使Jenkins内部可以使用docker命令,容器实例的名称为jenkins_test

docker run -u root -d -p 9090:8080 -v /var/jenkins_test:/var/jenkins_home -e TZ="Asia/Shanghai" -v /etc/localtime:/etc/localtime -v $(which docker):/usr/bin/docker -v /var/run/docker.sock:/var/run/docker.sock --name jenkins_test jenkins/jenkins

此时,在浏览器上输入ip:9090,将会出现Jenkins的页面。 若访问不到,可能存在的问题如下:

  • centos的防火墙问题。打开防火墙,开放9090端口
service firewalld start
firewall-cmd --zone=public --add-port=9090/tcp --permanent
firewall-cmd --reload

查看所有开放的端口,看是否存在9090

firewall-cmd --zone=public --list-ports
  • 如果用的云服务器,需要在安全组里面开放9090端口。安全组->配置规则->入方向->手动添加9090端口。

Jenkins配置

初始化Jenkins

打开ip:9090,界面如下,初始化需要输入密码,根据给出的路径获取密码填入。

image.png

点击继续,选择推荐的插件进行安装,此过程较慢,完成后创建管理员用户。

另外,部署脚本需要其他插件的支持,在系统管理->插件管理中安装:Docker Pipeline、SSH Pipeline Steps、CloudBees Docker Build and Publish

创建任务

  1. 点击新建任务,创建一个多分支流水线任务,名称自己取,因为我用的github测试,所以我命名为test_with_github,点击确定。

  2. 进入新页面之后,随意设定显示名称,我设定为test,在分支源处点击增加源,选择github,输入你的github仓库地址,在凭据处添加自己的用户名密码,点击验证,验证通过即可。(关于github上源代码怎么搞,请耐心往下看,测试时可以用我的demo,地址:github.com/marco110/do… ,可以fork到自己仓库下测试)。

  3. 此处保持默认配置,构建的时候Jenkins会根据Jenkinsfile去执行命令,Jenkinsfile我们会手动加到项目里,后面会讲到。 image.png

  4. 此时jenkins会自动扫描仓库。

image.png

  1. 点击左上角 test,进入页面发现github上的分支已被扫描到。

image.png

项目添加部署脚本

Jenkins已经部署完毕,接下来要对我们的项目动手了,当前项目指的是刚才github的源码。

添加Jenkinsfile

刚才配置Jenkins任务的时候我们提到了Jenkinsfile,此时我们需要在项目根目录添加Jenkinsfile。Jenkinsfile告诉Jenkins任务需要如何执行,代码如下。具体每行是干嘛用的,我写在了代码注释里面。

构建过程分为三个部分(stage):

  1. get souce code 从我们Jenkins配置页面填写的github地址拉取源码。
  2. npm run build 打包源码。
  3. deploy with nginx 用nginx发布我们的项目,关于nginx我不做过多讲解,不懂请自行百度。

image.png

#!groovy

import java.text.SimpleDateFormat

node(){
    // 我们会发布无数个版本,无数个镜像,为了保持不重名,我们用时间来区分,镜像的名字格式将会是 dockerName:tag, 例如 marco-test:202105011023
    def dateFormat = new SimpleDateFormat("yyyyMMddHHmm")
    def dockerTag = dateFormat.format(new Date())
    def dockerName='marco-test'

    stage('get souce code') {
        try {
            echo "get source code"
            checkout scm
        }
        catch(err) {
            echo "get source code failed"
            throw err
        }
    }

    stage('npm run build') {
        try{
        // 运行容器实例的时候,我们已经把宿主机的docker命令映射到了容器里,所以能够直接调用docker
        // 利用镜像构建node环境并打包,运行完则退出
            docker.image('node:12-alpine').inside {
                sh 'node --version'
                sh 'npm --version'
                sh "npm --registry https://registry.npm.taobao.org install"
                sh 'npm install'
                sh 'npm run build'
            }
            }
        catch(err){
                echo "npm run build failed"
                throw err
            }
    }

    stage('deploy with nginx') {
        try {
            sh 'pwd'
            sh 'ls'
            // 项目打包到了dist文件夹,需要复制到devops_build文件夹下,devops_build需要手动创建,作用在后面
            sh 'cp -r dist ./devops_build'

            // 删除旧版本,代码会发布无数次,所以需要删除旧版本
            sh "docker rm -f ${dockerName}"
            // 创建nginx镜像,工作目录为devops_build,配置文件为Dockerfile
            sh "docker build --no-cache=true -t ${dockerName}:${dockerTag} ./devops_build"

            // 运行nginx实例并映射80端口到宿主机
            sh "docker run -u root --name ${dockerName} -p 80:80 -it -d ${dockerName}:${dockerTag}"

            // 只保留最新的三个镜像
            sh """docker rmi -f \$(docker images | grep ${dockerName} | sed -n  '4,\$p' | awk '{print \$3}') || true"""
        }
        catch(err){
                echo "deploy with Nginx failed"
                throw err
            }
    }
}

创建devops_build

此文件夹是为了运行一个nginx容器实例,并需要一直运行在后台,所以不能像node容器一样写在Jenkinsfile中。 通过Jenkinsfile,项目打包的文件夹已经被复制到devops_build文件夹下。所以此时文件夹下将会有dist文件夹、Dockerfile和nginx.conf.

  • Dockerfile Jenkinsfile中脚本sh "docker build --no-cache=true -t ${dockerName}:${dockerTag} ./devops_build" 是以devops_build文件夹下的Dockfile为默认配置,创建镜像,内容如下(需要对nginx的认识): 以 nginx:1.17.3-alpine 为基础镜像,

把 devops_build 文件夹下的 nginx.conf 复制到容器对应文件夹中,

把打包的 dist 文件夹复制到容器对应文件夹。

FROM nginx:1.17.3-alpine

LABEL MAINTAINER="marco"

ADD ./nginx.conf /etc/nginx/nginx.conf

RUN rm -rf /usr/share/nginx/html

ADD /dist/ /usr/share/nginx/html

构建镜像后,JenkinsFile中的sh "docker run -u root --name ${dockerName} -p 80:80 -it -d ${dockerName}:${dockerTag}" 运行了容器实例,从而完成了部署。

此时访问ip:80 就能看到你发布的网站了。

接下来将会记录怎么样通过docker+jenkins部署项目到远程服务器。

第一次配置Jenkins,如有错误,欢迎指出。