记录一次成功CICD完整亲身实践从此踏进入Devops大门

Posted itxiaoshen博客

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了记录一次成功CICD完整亲身实践从此踏进入Devops大门相关的知识，希望对你有一定的参考价值。

Devops概念

DevOps 强调通过一系列手段来实现既快又稳的工作流程，使每个想法（比如一个新的软件功能，一个功能增强请求或者一个 bug 修复）在从开发到生产环境部署的整个流程中，都能不断地为用户带来价值。这种方式需要开发团队和运维团队密切交流、高效协作并且彼此体谅。此外，DevOps 还要能够方便扩展，灵活部署。有了 DevOps，需求最迫切的工作就能通过自助服务和自动化得到解决；通常在标准开发环境编写代码的开发人员也可与 IT 运维人员紧密合作，加速软件的构建、测试和发布，同时保障开发成果的稳定可靠。

下面我们先从几张图大概了解Devops及常用工具集

主体流程

常用CICD工具集

核心生态圈

CICD示例

需求

构建一个基于容器化的CICD,提交源码则后自动触发构建、打包、测试、部署到单个应用服务器docker宿主机容器中运行，目前是单个docker运行环境，后续可改为docker swarm或者K8S集群容器环境

运维架构

部署规划

三台主机或虚拟机 CentOS 7.8以上版本

  • 192.168.50.94（用途：仓库服务器；）
    • GitLab：Git Server 内网私有部署，和GitHub、Gitee都属于Git Server，作为代码仓库
    • Nexus：本地仓库服务器，maven私有仓库，可做内网私服和仓库代理服务器
    • Harbor： docker私有仓库，存放和管理docker镜像
    • docker: 应用安装基于docker环境组件，如GitLab
  • 192.168.50.95 （用途：Jenkins中心服务器）
    • Jenkins：CICD核心组件
    • docker：用于本地编译Dockerfile生成docker镜像文件
    • maven: 用于在本地构建、编译和打包
  • 192.168.3.117 （应用服务器：运行docker镜像）
    • docker: 用于本地运行docker容器

部署步骤

安装docker环境

[docker安装官网地址]（https://docs.docker.com/engine/install/centos/）

详细请参考官网，官网有非常详细安装说明，此外还需要安装docker-compose,docker-compose安装非常简单，直接拷贝到系统的/usr/local/bin并sudo chmod +x /usr/local/bin/docker-compose赋予执行文件权限即可，docker-compose可执行文件存在GitHub中；后续我们再组织专门学习讨论docker和k8s，这里只是需要使用到docker

两台主机都安装完毕后检查下版本，如有如下显示就可以使用docker了

安装Harbor

Harbor官方下载地址 https://github.com/goharbor/harbor/releases

选择下载离线包最新版本安装

直接解压进入根目录，官网已经提供docker-compose方式，直接docker-compose up -d运行即可

查看docker容器状态，Harbor暴露提供端口是80，所以直接访问http://192.168.50.94即可

默认账号：admin 密码：Harbor12345

我们新建一个jenkins项目

进入后可以新建账号，我这里新建一个harbor账号,密码为Harbor123，用于后续CICD示例测试

安装Nexus

Nexus官网 https://www.sonatype.com

需要注册账号下载,Nexus主要存储maven 仓库，可以将我们企业内部开发jar公用模块在Nexus中管理，也可以将其作为代理方式统一管理

下载nexus-3.32.0-03-unix.tar.gz，直接解压到/usr/local目录下，然后进入到bin目录下直接用 ./nexus start启动即可

默认端口为8081，访问http://192.168.50.94:8081 默认系统用户名：admin，密码：admin123，不过后面的CICD示例暂且还没有使用到Nexus

安装Jenkins

Jenkins官网下载地址 https://www.jenkins.io/download/

我们这里选择generic java package .war包下载，最新版本2.306的jenkins.war，以war形式安装

下载Tomcat8的安装包，将jenkins.war包放在Tomcat的webapps目录，我这里主要为了访问是不加目录，所以解压完后我先关闭Tomcat，删除jenkins.war 和重命名ROOT目录为ROOTBAK，最后将解压后的jenkins目录重命名为ROOT，重新./startup.sh 启动Tomcat ,使用默认端口8080

jenkins访问地址：http://192.168.50.95:8080

查看tomcat logs目录下的catalina.out 运行日志，jenkins初始化一个管理员密码用于初始化系统验证，验证完毕后可以进入安装插件页面

如果无法使用或者需要重置密码先找到工作目录，一般都在/root/.jenkins，如果指定过jenkins的目录的话,使用命令行查找JENKINS_HOME环境变量
进入jenkins工作目录,找到config.xml配置文件

true 修改为: false，重启jenkins,可以不用登陆便可修改jenkins配置，然后再在管理页面修改用户密码

jenkins初始配置

进入首页后通过左侧的系统管理-插件管理，切换到高级设置tab框

将URL升级站点修改为国内地址：https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

检查并安装必要插件，包括git、maven、jdk等，这次示例还用到pipe line流水线插件，jenkins强大的地方就是有很多第三方插件简单安装就可直接使用。so easy ；jenkins比较重要使用是参数化构建和pipeline流水线功能，但本篇文章不对jenkins使用做过多的描述，仅是示例入门

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-DCYprSJx-1628783084242)(http://www.itxiaoshen.com:3001/assets/1628765111753GkteHEtc.png)]

jenkins依赖其他配置

安装jenkins的服务器，我们也在其本地安装好Jdk和Maven，由于我们需要与Harbor服务器进行交互，还需增加如下的配置,配置insecure-registries为192.168.50.94为Harbor服务器地址，我们这里由于简单演示则采用http协议和IP地址，在所有安装docker且需要和Harbor服务器做通讯都加上下面的配置,包括192.168.3.117和192.168.50.95都要配置

[root@k8s-master-2 bin]# vi /etc/docker/daemon.json

 "insecure-registries":["192.168.50.94"]

安装GitLab

GitLaba安装官方地址 https://about.gitlab.com/install/

官方提供很多部署方式，这里我们选择docker部署，进入docker安装说明页面

https://docs.gitlab.com/ee/install/docker.html

我们直接采用docker-compose部署方式，建立一个docker-compose.yml文件,内容如下，这里我们先设置好GITLAB_HOME环境变量路径，

export GITLAB_HOME=/home/docker_resource/gitlabdata

web:
  image: \'gitlab/gitlab-ce:latest\'
  restart: always
  hostname: \'k8s-master-2\'
  environment:
    GITLAB_OMNIBUS_CONFIG: |
      external_url \'http://192.168.50.94\'
      # Add any other gitlab.rb configuration here, each on its own line
  ports:
    - \'3380:80\'
    - \'33443:443\'
    - \'3322:22\'
  volumes:
    - \'$GITLAB_HOME/config:/etc/gitlab\'
    - \'$GITLAB_HOME/logs:/var/log/gitlab\'
    - \'$GITLAB_HOME/data:/var/opt/gitlab\'

配置完后直接在docker-compose.yml所在目录下使用docker-compose up -d后台启动，查看docker 运行容器

访问端口为3380，访问地址为http://192.168.50.94:3380，初次访问后直接输入初始化root用户密码并登录

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-RI5Ee3ud-1628783084249)(http://www.itxiaoshen.com:3001/assets/1628753333325S2tRkTKc.png)]

创建一个空的项git-test

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-YWtKWT1Q-1628783084251)(http://www.itxiaoshen.com:3001/assets/16287571527517EtnSZb6.png)]

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-wMywcGpT-1628783084253)(http://www.itxiaoshen.com:3001/assets/1628763846454TcBha64n.png)]

我们这里选择Intellij IDEA作为开发工具，在windows安装git客户端(Git-2.32.0.2-64-bit.exe,如果直接使用git客户端还需要熟悉几个简单常用的git命令)，IDEA Setting中安装GitLab集成插件，在Idea配置git项目地址就可以操作git了

在IDEA的File-Settings-Version Control Git中配置上面已安装windows git客户端可执行文件地址

示例构建

上面我们已经基本环境准备完毕，接下来我们开始构建一个hello world 的SpringBoot Web工程测试

流程简单说明

  1. Jenkins 建立流水线任务，配置web hook触发器、编写流水线脚本
  2. GitLab建立项目和提供访问、操作权限，配置项目的jenkins web hook回调地址
  3. Harbor建立用户、项目和提供访问、操作权限
  4. 在Windows个人电脑开发环境建立Java语言的Maven项目，配置GitLab项目地址，完成代码编写和Dockerfile，通过IDEA提交本地git后push远程GitLab
  5. Gitlab收到提交操作完成后触发jenkin web hook触发jenkins 流水线任务构建；
  6. jenkins所在服务器通过先从GitLab 获取项目源码，拿到源码进行maven编译、测试、构建和打包；
  7. jenkins所在服务器打包完成后再执行docker编译制作成docker镜像并登录和推送镜像到Harbor远程仓库；
  8. jenkins所在服务器登录应用服务器，登录Harbor远程仓库并拉取指定镜像到本地docker并运行容器提供暴露端口服务

准备源码

IDEA 新建git-test的maven工程项目，设置gitlab项目地址，这个git项目地址我们在上一章节已创建好

pom文件

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.5.2</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>cn.aotain</groupId>
    <artifactId>git-test</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>git-test</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>1.8</java.version>
        <slf4j-springboot.version>1.4.6</slf4j-springboot.version>
        <lombok.version>1.18.20</lombok.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>wiki.xsx</groupId>
            <artifactId>slf4j-spring-boot-starter</artifactId>
            <version>$slf4j-springboot.version</version>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

启动类

package cn.aotain;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;


@SpringBootApplication
public class GitTestApplication 

    public static void main(String[] args) 
        SpringApplication.run(GitTestApplication.class, args);

controller测试类

package cn.aotain.controller;


import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import wiki.xsx.core.log.Log;
import wiki.xsx.core.log.ResultLog;
import java.util.HashMap;
import java.util.Map;

@RestController
public class HelloController 

    @RequestMapping("/hello")
    @Log(value = "gettaskbydev", paramFilter = "request")
    @ResultLog(value = "ResultLog-test2")
    public Map<String, Object> Hello()
        Map<String, Object> result = new HashMap<>(3);
        result.put("code", 200);
        result.put("msg", "success");
        return result;

编写DockerFile文件

FROM java:8
MAINTAINER itxiaoshen
COPY target/*.jar /app.jar
ENTRYPOINT ["java","-jar","/app.jar"]

GitLab更新测试

修改result对象中msg值，先执行commit提交到本地git操作 然后再执行push操作提交到远程GitLab项目仓库

查看GitLab项目上内容确认已提交

Jenkins 流水线任务配置

新建一个流水线的任务，输入名称、选择流水线、点击确定按钮，我们这里暂时只演示流水线，暂时不使用参数化构建功能

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-C9s2DucC-1628783084262)(http://www.itxiaoshen.com:3001/assets/1628767700284apa76HRS.png)]

点击进入刚刚创建的git-test任务的管理页面，左边菜单栏有流水线语法帮助，比如git check out操作可以输入自动生成，逐渐熟悉一些常用语法，点击配置功能

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-f47QDuCu-1628783084263)(http://www.itxiaoshen.com:3001/assets/16287657297564CsTWzck.png)]

配置触发器为web hook（构建时机可以有很多种比如像定时触发），这里有一个说明提示http://JENKINS_URL/generic-webhook-trigger/invoke ，将JENKINS_URL替换为我们jenkins服务器web地址，我们这里也即是 http://192.168.50.95:8080/generic-webhook-trigger/invoke

在GitLab的git-test项目管理页面Settings-Webhooks中将上面url地址加上配置Token参数 http://192.168.50.95:8080/generic-webhook-trigger/invoke?token=gittest123456 添加进去，至此GitLab的git-test如果发生提交操作就会调用jenkins webhook钩子接口实现自动触发构建机制

接下来到了最关键的环节，CICD核心也即是编写流水线脚本，编写完脚本放置到高级项目选项的流水线中

下面是一段简单pipeline流水线脚本，核心部署是git源码拉取-编译-打包推送docker镜像到docker仓库-登录应用服务器并从docker仓库获取镜像部署到本地docker环境并运行容器，容器应用暴露外部访问端口18080

pipeline 
  agent any

  stages 
  
   // 拉取代码 git从git仓库中拉取代码，采用的是免交互方式 checkout如何产生？参考 Docker:pipeline编写基本技巧- jenkins配置通过密钥拉取git源码管理仓库的代码
   stage(\'Git Checkout\')  
		steps 
			checkout([$class: \'GitSCM\', branches: [[name: \'master\']], extensions: [], userRemoteConfigs: [[url: \'http://192.168.50.94:3380/root/git-test.git\']]])		
		
   
   
   // 代码编译
   stage(\'Maven Build\') 
		steps 
        sh \'\'\'
        export JAVA_HOME=/home/commons/jdk8
        cd git-test
        /home/commons/apache-maven-3.6.3/bin/mvn clean package -Dmaven.test.skip=true
        \'\'\'		
		
   
   
   // 项目打包到镜像并推送到镜像仓库
   stage(\'Build and Push Image\') 
		steps 
		sh \'\'\'
		cd git-test
		REPOSITORY=192.168.50.94/jenkins/git-test-demo
		docker build -t $REPOSITORY .
		docker login 192.168.50.94 -u harbor -p Harbor123
		docker push $REPOSITORY
		\'\'\'		
		
    
    // 部署到Docker主机
  stage (\'Docker run\') 
     agent none
     steps 
       script 
              def remote = [:]
              remote.name = \'application-server\'
              remote.host =\'192.168.3.117\'
              remote.user = \'******\'
              remote.password =\'*********\'
              remote.allowAnyHosts= true
              sshCommand remote: remote, command:
              \'\'\'
				REPOSITORY=192.168.50.94/jenkins/git-test-demo
				docker rm -f git-test-demo |true
				docker pull $REPOSITORY 
				docker container run -d --name git-test-demo -p 18080:8080 $REPOSITORY
              \'\'\'

先手工点击立即构建进行手工构建测试，构建分阶段执行运行完毕后如下

访问Spring Boot的HelloWorld应用服务器部署地址：http://192.168.3.117:18080/hello，成功显示页面

接下来我们直接修改源码将result对象中msg值修改为后缀222222，push提交GitLab执行自动触发构建测试

从jenkins构建历史数据看已出现一个新的成功构建记录#4

重新访问测试页面显示为修改的数据

查看应用服务器上docker容器也有我们git-test-demo

**本人博客网站 **IT小神 www.itxiaoshen.com

以上是关于记录一次成功CICD完整亲身实践从此踏进入Devops大门的主要内容，如果未能解决你的问题，请参考以下文章

要搞刷机!从它的尸体上踏过去!钢板云路由!WPR003N复活！成功启动OPENWRT

程序员常用 10 种算法之马踏棋盘算法

Azure 集成 CICD 的最佳实践 [关闭]

DevOps落地实践 BAT系列 CICD iPipe vs CCI

Docker最全教程之使用TeamCity来完成内部CICD流程（十六）

我的docker随笔37：使用gitlab和jenkins实现CICD