码迷,mamicode.com
首页 > 编程语言 > 详细

springboot集成docker实现自动化构建镜像说明

时间:2020-05-24 13:58:11      阅读:49      评论:0      收藏:0      [点我收藏+]

标签:style   cti   ber   items   文件   rmi   行修改   includes   ISE   

springboot集成docker实现自动化构建镜像说明

  • 文档说明

    该文档仅包括通过配置springboot、docker、jenkins、git、appollo等实现持续构建,持续发布的功能,不包括各个组件使用细节的讲解。

  • 环境说明

    nameversiondesc
    spring boot 2.0.2.RELEASE spring boot
    docker 1.13.1 docker
    harbor 1.7.0 镜像仓库
    jenkinsci/blueocean 1.9.0 jenkins的blueocean工具
    maven 3-alpine maven
    gitlab 10.2.3 gitlab
  • 自动化构建的构想图

 

技术图片

 

  • springboot配置文件

    • 包括测试服和正式服两套服务,所以需要添加两套配置文本
    • resources下面添加application-test.properties文本,内容同测试服的配置。
    • resources下面添加application-prod.properties文本,内容同slave10的配置。
    • 对于testprod的指定通过jvm参数 -Dspring.profiles.active=test
  • 日志配置

    • 日志文件保存地址统一为/var/log/jenkinsci/zsm-eprofile/eprofile.2019-01-02.log
    • 将镜像的/var/log/jenkinsci/zsm-eprofile挂载到宿主机上对应的目录/var/log/jenkinsci/zsm-eprofile。这样方便随时对日志监控。
    • logback配置示例 <property name="LOG_HOME" value="/var/log/jenkinsci/zsm-eprofile/logs" />
  • pom打包方式修改

    • pombuild下面将打包方式修改为如下

      <properties>
              <docker.image.prefix>bigdata-test.server.com</docker.image.prefix>
      </properties>
      <plugins>
          <!--这个插件是将所有的包打在一起-->
          <plugin>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-maven-plugin</artifactId>
          </plugin>
          <plugin>
              <!-- 这个插件主要是对打的包解压到dependency目录下 -->
               <groupId>org.apache.maven.plugins</groupId>
               <artifactId>maven-dependency-plugin</artifactId>
               <executions>
                   <execution>
                       <id>unpack</id>
                       <phase>package</phase>
                       <goals>
                           <goal>unpack</goal>
                       </goals>
                       <configuration>
                           <artifactItems>
                               <artifactItem>
                                   <groupId>${project.groupId}</groupId>
                                   <artifactId>${project.artifactId}</artifactId>
                                   <version>${project.version}</version>
                               </artifactItem>
                           </artifactItems>
                       </configuration>
                   </execution>
               </executions>
          </plugin>
          <!-- 根据 dockerfile 构建镜像的mvn插件 -->
          <plugin>
              <groupId>com.spotify</groupId>
              <artifactId>dockerfile-maven-plugin</artifactId>
              <version>1.4.9</version>
              <configuration>
                  <!-- 镜像名 -->
                  <repository>${docker.image.prefix}/${project.artifactId}</repository>
                  <!-- tag:默认使用当前版本 -->
                  <tag>${project.version}</tag>
              </configuration>
          </plugin>
      </plugins>

       

    • 注意:如果在build标签下面有下面的配置,需要删除或者其他处理,要保证配置文件都能够打包到jar里面

      <resources>
          <resource>
              <directory>src/main/java</directory>
              <includes>
                  <include>**/**</include>
              </includes>
          </resource>
      </resources>

       

  • 在打包的pom文件同级目录下创建Dockerfile文件

    • Dockerfile内容

      ##FROM指定依赖jdk8这个镜像,VOLUME指定其挂载目录
      FROM openjdk:8-jdk-alpine
      VOLUME /tmp
      ##将dependency下面的内容拷贝到容器中
      ARG DEPENDENCY=target/dependency
      COPY ${DEPENDENCY}/BOOT-INF/lib /app/lib
      COPY ${DEPENDENCY}/META-INF /app/META-INF
      COPY ${DEPENDENCY}/BOOT-INF/classes /app
      ##容器启动时通过PARAMS指定jvm参数
      ENV PARAMS=""
      ## 容器启动时执行的命令
      ENTRYPOINT ["sh","-c","java -cp app:app/lib/* $PARAMS com.zsm.test.TestImageApplication"]
    • 说明

      上面是一种的构建镜像的方式:这种方式是将jar解压之后分别拷贝lib和class到容器中,这种方式能够灵活的对历史版本镜像进行配置修改等操作,方便镜像在不同服务器之间的迁移。还有另外一种,直接将整个jar拷贝到容器中:这种方式构建简单,但是将配置打包到jar里面,不方便对配置的修改。com.zsm.test.TestImageApplication每个项目对应的主类不一样,需要进行修改。

    • dockerfile命令详解

  • 在打包的pom文件同级目录下创建Jenkinsfile

    • Jenkinsfile内容

      pipeline {
          parameters {
              booleanParam(name:‘UPDATE_FORMUL‘, defaultValue:false,description:‘默认false:不更新正式服; true:更新正式服‘)
              booleanParam(name:‘NOT_SKIP_BUILD‘, defaultValue:true, description:‘默认true:构建新的镜像;false:跳过镜像构建‘)
          }
          environment {
              BITBUCKET_COMMON_CREDS = credentials(‘docker-registry-up‘)
              RegistryName = ‘bigdata-test.server.com‘
              ImageName = ‘test.zsm.com/enterprise-image‘
              ImageTag = ‘1.0.1‘
          }
          agent any
          stages {
              stage(‘Build‘) {
                  when {
                      expression { return params.NOT_SKIP_BUILD }
                  }
                  agent {
                      docker {
                          image ‘maven:3-alpine‘
                          args ‘-v /root/.m2:/root/.m2‘
                      }
                  }
                  steps {
                      echo ‘开始mvn构建镜像...‘
                      sh ‘cd .‘
                      sh ‘mvn -B -DskipTests clean package dockerfile:build‘
                      echo ‘镜像构建完成!‘
                  }
              }
              stage(‘Push‘) {
                  when {
                      expression { return params.NOT_SKIP_BUILD }
                  }
                  steps {
                      echo ‘push镜像到私有仓库...‘
                      sh ‘docker login -u $BITBUCKET_COMMON_CREDS_USR -p $BITBUCKET_COMMON_CREDS_PSW $RegistryName‘
                      sh ‘docker tag $RegistryName/$ImageName:$ImageTag $RegistryName/$ImageName:latest‘
                      sh ‘docker push $RegistryName/$ImageName:$ImageTag‘
                      sh ‘docker push $RegistryName/$ImageName:latest‘
                      sh ‘docker rmi $RegistryName/$ImageName:$ImageTag‘
                      sh ‘docker rmi $RegistryName/$ImageName:latest‘
                      echo ‘push镜像到私有仓库完成!‘
                  }
              }
              stage(‘Pull_Test‘) {
                  steps {
                      echo ‘开始更新测试服...‘
                      sh ‘ssh root@bigdata02 "/opt/server/zsm-microservice/jenkins-remote-shell/zsm-eprofile.sh"‘
                      echo ‘测试服更新完成!‘
                  }
              }
              stage(‘Pull_Formal‘) {
                  when {
                      expression { return params.UPDATE_FORMUL }
                  }
                  steps {
                      echo ‘开始更新正式服...‘
                      sh ‘ssh bigdata@10.0.100.154 "/opt/server/zsm-microservice/jenkins-remote-shell/zsm-eprofile.sh"‘
                      echo ‘正式服更新完成!‘
                  }
              }
          }
      }
    • 说明

      1. 这个文件对每次版本的变动都需要修改ImageTag为对应的版本。
      2. 注意:这个文件里面不能写注释。
      3. 对于在项目的module下打包的情况,需要把 stage(‘Build‘) 下面的steps里面的 sh ‘mvn -B -DskipTests clean package dockerfile:build -f pom.xml‘改为对应的module下面。
      4. Jenkinspipline语法有Scripted PipelineDeclarative Pipeline两种,这里使用的是声明式piplinepipline语法详情
  • gitlab项目设置

    • 添加为可访问gitlab仓库的账号信息。
    • 通过setting -> members -> add member的方式添加。
  • Jenkins配置

    • jenkins访问地址:http://192.168.1.100:8080,账号密码:admin/123456
    • jenkins pipline创建流程: new任务 -> enter an item name -> 流水线 -> okpipline -> definition -> pipline script from SCM -> SCM -> git -> Repository url -> credentials -> jenkins-gitlab-private -> 输入分支,默认master分支 -> save
    • 如果Jenkinsfilemodule下面,请在Script Path指定对应的path
  • 远端服务器脚本

    • 因为镜像的pullrun都是通过Jenkins调用远程的shell脚本来执行的,所以需要编写对应的脚本。所以对于正式服和测试服的每一台服务器都需要对应的脚本。

    • 脚本内容

      #!/bin/bash
      ?
      docker login -u admin -p 123456 bigdata-test
      ?
      docker stop zsm-eprofile
      ?
      docker rm -f zsm-eprofile
      ?
      docker rmi bigdata-test.server.com/test.zsm.com/enterprise-image:latest
      ?
      docker pull bigdata-test.server.com/test.zsm.com/enterprise-image:latest
      ?
      docker run -d -p 9210:9210 -v /etc/hosts:/etc/hosts -v /var/log/jenkinsci/zsm-eprofile:/var/log/jenkinsci/zsm-eprofile --name zsm-eprofile -e PARAMS=‘-Dspring.profiles.active=test -Djava.security.egd=file:/dev/./urandom‘ --net=host bigdata-test.server.com/test.zsm.com/enterprise-image:latest
      ?

       

    • 说明:

      • 停止容器和删除容器需要把名字和容器启动的名字保持一致。
      • 删除镜像和pull镜像需要改为自己项目构建的镜像,tag使用latest不变。
      • 运行新的镜像里面需要把-v /var/log/jenkinsci/zsm-eprofile:/var/log/jenkinsci/zsm-eprofile日志输出改为自己项目对应的地址,--name zsm-eprofile也需要改成自己项目的名字(和停止删除容器的名字保持一致),-e PARAMS=‘-Dspring.profiles.active=test -Djava.security.egd=file:/dev/./urandom‘用来指定jvm运行参数。
  • 手动构建Jenkins pipline

    • 进入项目对应的任务,立即构建 -> build history -> 查看构建日志
  • 不足

    • 目前使用的是手动构建方式进行任务的启动,后期优化成每一个项目都在git上有对应的生产分支,jenkins只需要webhook对应的生产分支就行。
    • 对于程序的版本和镜像打包的tag,必须保持一致才能有效,版本的迭代每次需要改动两个地方,有点麻烦。
zsm_test_jenkins.sh 脚本
#!/bin/bash
ssh root@bigdata01 "/opt/server/zsm-microservice/jenkins-remote-shell/zsm_test_jenkins.sh"
sudo docker login -u admin -p 123456 bigdata-test
sudo docker stop zsm_test_jenkins
sudo docker rm -f zsm_test_jenkins
sudo docker rmi bigdata-test.server.com/test.zsm.com/zsm_test_jenkins:latest
sudo docker pull bigdata-test.server.com/test.zsm.com/zsm_test_jenkins:latest
sudo docker run -d -p 9060:9060 -v /etc/hosts:/etc/hosts -v /var/log/jenkinsci/zsm_test_jenkins:/var/log/jenkinsci/zsm_test_jenkins --namezsm_test_jenkins -e PARAMS=-Dspring.profiles.active=test -Dapollo.configService=http://bigdata-test:8090 -Djava.security.egd=file:/dev/./urandom --net=host bigdata-test.server.com/test.zsm.com/zsm_test_jenkins:latest

 

springboot集成docker实现自动化构建镜像说明

标签:style   cti   ber   items   文件   rmi   行修改   includes   ISE   

原文地址:https://www.cnblogs.com/zengming/p/12653703.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!