使用 GitLab CI 和 Docker 自动部署 Spring Boot 应用

迷南。 2021-09-01 08:28 340阅读 0赞

点击上方 [Java后端][Java]，选择 设为星标

优质文章，及时送达

--------------------

Docker和Spring Boot是非常流行的组合，我们将利用GitLab CI的优势，并在应用程序服务器上自动构建，推送和运行Docker镜像。

## **GitLab CI** ##

Gitlab CI/CD服务是GitLab的一部分，每当开发人员将代码推送到GitLab存储库时，它都会在所需的环境中构建，测试和存储最新的更改。

选择GitLab CI的一些主要原因：

1. 易于学习，使用和可扩展

2. 维护容易

3. 整合容易

4. CI完全属于GitLab存储库的一部分

5. 良好的Docker集成

6. 镜像托管(Container registry)-基本上是你自己的私有Docker Hub

7. 从成本上来说，GitLab CI是一个很好的解决方案。每个月你有2000分钟的免费构建时间，对于某些项目来说，这是绰绰有余的

我把 Docker 的教程和文章整理成了 PDF，关注微信关注号 Java后端，回复 666 就能下载了。

### **为什么GitLab CI超越Jenkins** ###

这无疑是一个广泛讨论的话题，但是在本文中，我们将不深入探讨该话题。GitLab CI和Jenkins都有优点和缺点，它们都是功能非常强大的工具。

**那为什么选择GitLab？**

**如前所述，CI完全是GitLab存储库的一部分，这意味着不需要安装它，并且维护最少。yml脚本完成后，你便或多或少地完成了所有工作。**

对于小型项目使用Jenkins，你就必须自己设置和配置所有内容。通常，你还需要一台专用的Jenkins服务器，这也需要额外的成本和维护。

**使用GitLab CI 前提条件**

如果需要与这些前提条件有关的任何帮助，我已提供相应指南的链接。

1. 你已经在GitLab上推送了Spring Boot项目

2. 你已在应用程序服务器上安装了Docker（指南）

3. 你具有Docker镜像的镜像托管（在本指南中将使用Docker Hub）

4. 你已经在服务器上生成了SSH RSA密钥（指南）

**你要创建什么**

你将创建**Dockerfile** 和**.gitlab-ci.yml，** 它们将自动用于：

1. 构建应用程序Jar文件

2. 构建Docker镜像

3. 将镜像推送到Docker存储库

4. 在应用程序服务器上运行镜像

**基本项目信息**

本文的Spring Boot应用程序是通过Spring Initializr生成的。这是一个基于Java 8或Java11构建的Maven项目。后面，我们将介绍Java 8和Java 11对Docker镜像有什么影响。

### **Docker文件** ###

让我们从Dockerfile开始。

FROM maven:3.6.3-jdk-11-slim AS MAVEN_BUILD
    #FROM maven:3.5.2-jdk-8-alpine AS MAVEN_BUILD FOR JAVA 8
    ARG SPRING_ACTIVE_PROFILE
    MAINTAINER Jasmin
    COPY pom.xml /build/
    COPY src /build/src/
    WORKDIR /build/
    
    RUN mvn clean install -Dspring.profiles.active=$SPRING_ACTIVE_PROFILE && mvn package -B -e -Dspring.profiles.active=$SPRING_ACTIVE_PROFILE
    FROM openjdk:11-slim
    #FROM openjdk:8-alpine FOR JAVA 8
    WORKDIR /app
    COPY --from=MAVEN_BUILD /build/target/appdemo-*.jar /app/appdemo.jar
    ENTRYPOINT ["java", "-jar", "appdemo.jar"]

与该Dockerfile相关的知识很少。

## Java版本 ##

让我们从Docker的角度看一下Java 8和11之间的区别。长话短说：这是Docker镜像的大小和部署时间。

**基于Java 8构建的Docker镜像将明显小于基于Java 11的镜像。**这也意味着Java 8项目的构建和部署时间将更快。

**Java 8-构建时间：约4分钟，镜像大小为 约180 MB**

**Java 11-构建时间： 约14分钟，镜像大小约为480 MB**

**注意：** 在实际应用中，这些数字可能会有所不同。

## **Docker镜像** ##

正如在前面示例中已经看到的那样，由于Java版本的缘故，我们在应用程序镜像大小和构建时间方面存在巨大差异。其背后的实际原因是在Dockerfile中使用了Docker镜像。

如果我们再看一下Dockerfile，那么**Java 11镜像很大的真正原因是因为它包含了没有经过验证/测试的open-jdk:11镜像的Alpine版本**。

如果你不熟悉OpenJDK镜像版本，建议你阅读OpenJDK Docker官方文档。在这里，你可以找到有关每个OpenJDK版本的镜像的说明。

### 备注：动态的变量 ###

在`ENTRYPOINT` 中，与环境相关的属性，我们只能写死，如下：

ENTRYPOINT [ “ java”，“ -Dspring.profiles.active = development”，“ -jar”，“ appdemo.jar” ]
    为了使它动态，你希望将其简单地转换为：
    
    
    
    ENTRYPOINT [ “ java”，“ -Dspring.profiles.active = $ SPRINT_ACTIVE_PROFILE”，“ -jar”，“ appdemo.jar” ]

以前，这是不可能的，但是幸运的是，这将在.gitlab-ci.yml中通过 ARG SPRING_ACTIVE_PROFILE修复。

### gitlab-ci.yml ###

在编写此文件之前，要准备的东西很少。基本上，我们想要实现的是，只要推送代码，就会在相应的环境上自动部署。

创建.env文件和分支

**我们首先需要创建包含与环境相关的分支和.env文件。**每个分支实际上代表我们的应用程序将运行的环境。

我们将在三个不同的环境中部署我们的应用程序：开发，测试和生产（ development, QA, and production ）。这意味着我们需要创建三个分支。

我们的dev，QA和prod应用程序将在不同的服务器上运行，并且将具有不同的Docker容器标签，端口和SSH密钥。这就要求我们的**gitlab-ci.yml文件将要是动态的**，通过为我们拥有的每个环境创建.env文件来解决该问题。

.develop.env .qa.env .master.env

**重要说明：** 命名这些文件时，有一个简单的规则：使用GitLab分支来命名，因此文件名应如下所示：**。$ BRANCH\_NAME.env**

例如，这是.develop.env文件。

export SPRING_ACTIVE_PROFILE='development'
    export DOCKER_REPO='username/demo_app:dev'
    export APP_NAME='demo_app_dev'
    export PORT='8080'
    export SERVER_IP='000.11.222.33'
    export SERVER_SSH_KEY="$DEV_SSH_PRIVATE_KEY"

**与.env文件有关的重要说明：**

**SPRING\_ACTIVE\_PROFILE**：不言自明，我们要使用哪些Spring应用程序属性。 **DOCKER\_REPO**：这是Docker镜像的存储库；在这里，我们唯一需要注意的是Docker image **TAG**，对于每种环境，我们将使用不同的标签，这意味着我们将使用**dev**，**qa** 和**prod** 标签。

我们的Docker中心看起来像这样。

![format_png][]

如你所见，存在一个带有三个不同标签的存储库，每当将代码推送到GitLab分支上时，每个标签（应用程序版本）都会被更新。

*  **APP\_NAME：** 此属性非常重要，它是对容器的命名。 如果你未设置此属性，则Docker将为你的容器随机命名。这可能是一个问题，因为你将无法以干净的方式停止运行容器。
 *  **端口：**这是我们希望运行Docker容器的端口。
 *  **SERVER\_IP：**应用程序使用的服务器IP。通常，每个环境都将位于不同的服务器上。
 *  **SERVER\_SSH\_KEY：**这是我们已经在每台服务器上生成的SSH密钥。 `$DEV_SSH_PRIVATE_KEY` 实际上是来自GitLab存储库的变量。

### 创建GitLab变量 ###

**最后需要做的是创建GitLab变量。**

打开你的GitLab存储库，然后转到：**Settings -> CI/CD**。在 **Variables**部分中， 添加新变量：

*  **DOCKER\_USER：**用于访问Docker Hub或其他镜像托管的用户名
 *  **DOCKER\_PASSWORD：** 用于访问镜像托管的密码
 *  **$ ENV\_SSH\_PRIVATE\_KEY：** 先前在服务器上生成的SSH私钥。

**SSH KEY的重要说明：**

你需要复制完整的密钥值，包括： ----- BEGIN RSA PRIVATE KEY -----和----- END RSA PRIVATE KEY -----

最后，你的GitLab变量应如下所示。

![format_png 1][]

### 创建gitlab-ci.yml文件 ###

最后，让我们创建将所有内容放在一起的文件。

services:
      - docker:19.03.7-dind
    stages:
      - build jar
      - build and push docker image
      - deploy
    build:
      image: maven:3.6.3-jdk-11-slim
      stage: build jar
      before_script:
       - source .${CI_COMMIT_REF_NAME}.env
      script:
       - mvn clean install -Dspring.profiles.active=$SPRING_ACTIVE_PROFILE && mvn package -B -e -Dspring.profiles.active=$SPRING_ACTIVE_PROFILE
      artifacts:
       paths:
         - target/*.jar
    docker build:
      image: docker:stable
      stage: build and push docker image
      before_script:
       - source .${CI_COMMIT_REF_NAME}.env
      script:
       - docker build --build-arg SPRING_ACTIVE_PROFILE=$SPRING_ACTIVE_PROFILE -t $DOCKER_REPO .
       - docker login -u $DOCKER_USER -p $DOCKER_PASSWORD docker.io
       - docker push $DOCKER_REPO
    deploy:
      image: ubuntu:latest
      stage: deploy
      before_script:
       - 'which ssh-agent || ( apt-get update -y && apt-get install openssh-client -y )'
       - eval $(ssh-agent -s)
       - echo "$SSH_PRIVATE_KEY" | tr -d '\r' | ssh-add -
       - mkdir -p ~/.ssh
       - chmod 700 ~/.ssh
       - echo -e "Host *\n\tStrictHostKeyChecking no\n\n" > ~/.ssh/config
       - source .${CI_COMMIT_REF_NAME}.env
      script:
       - ssh root@$SERVER "docker login -u $DOCKER_USER -p $DOCKER_PASSWORD docker.io; docker stop $APP_NAME; docker system prune -a -f; docker pull $DOCKER_REPO; docker container run -d --name $APP_NAME -p $PORT:8080 -e SPRING_PROFILES_ACTIVE=$SPRING_ACTIVE_PROFILE $DOCKER_REPO; docker logout"

让我们解释一下这里发生了什么：

services: 
      - docker:19.03.7-dind

这是一项服务，使我们可以在Docker中使用Docker。在Docker中运行Docker通常不是一个好主意，但是对于此用例来说，这是完全可以的，因为我们将构建镜像并将其推送到存储库中。

stages:
      - build jar
      - build and push docker image
      - deploy

对于每个gitlab-ci.yml文件，必须首先定义执行步骤。脚本将按照步骤定义的顺序执行。

在每个步骤，我们都必须添加以下部分： **before\_script: - source .$\{CI\_COMMIT\_REF\_NAME\}.env**

这只是预先加载之前创建的 env. files, 文件。根据正在运行的分支来自动注入变量。（这就是为什么我们必须使用分支名称来命名.env文件的原因）

这些是我们部署过程中的执行步骤。

![format_png 2][]

如你所见，，有三个带有绿色复选标记的圆圈，这表示所有步骤均已成功执行。

build:
      image: maven:3.6.3-jdk-11-slim
      stage: build jar
      before_script:
        - source .${CI_COMMIT_REF_NAME}.env
      script:
        - mvn clean install -Dspring.profiles.active=$SPRING_ACTIVE_PROFILE && mvn package -B -e -Dspring.profiles.active=$SPRING_ACTIVE_PROFILE
      artifacts:
        paths:
          - target/*.jar

这是执行第一步骤代码的一部分，构建了一个jar文件，该文件可以下载。这实际上是一个可选步骤，仅用于演示构建jar并从GitLab下载它是多么容易。

第二步骤是在Docker存储库中构建并推送Docker镜像。

docker build:
      image: docker:stable
      stage: build and push docker image
      before_script:
        - source .${CI_COMMIT_REF_NAME}.env
      script:
        - docker build --build-arg SPRING_ACTIVE_PROFILE=$SPRING_ACTIVE_PROFILE -t $DOCKER_REPO .
        - docker login -u $DOCKER_USER -p $DOCKER_PASSWORD docker.io
        - docker push $DOCKER_REPO

这一步骤，我们不得不使用docker:19.03.7-dind服务。如你所见，我们使用的是最新的稳定版本的Docker，我们只是在为适当的环境构建镜像，然后对Dockerhub进行身份验证并推送镜像。

我们脚本的最后一部分是：

deploy:
      image: ubuntu:latest
      stage: deploy
      before_script:
        - 'which ssh-agent || ( apt-get update -y && apt-get install openssh-client -y )'
        - eval $(ssh-agent -s)
        - echo "$SSH_PRIVATE_KEY" | tr -d '\r' | ssh-add -
        - mkdir -p ~/.ssh
        - chmod 700 ~/.ssh
        - echo -e "Host *\n\tStrictHostKeyChecking no\n\n" > ~/.ssh/config
        - source .${CI_COMMIT_REF_NAME}.env
      script:
        - ssh root@$SERVER "docker stop $APP_NAME; docker system prune -a -f; docker pull $DOCKER_REPO; docker container run -d --name $APP_NAME -p $PORT:8080 -e SPRING_PROFILES_ACTIVE=$SPRING_ACTIVE_PROFILE $DOCKER_REPO"

在此步骤中，我们使用Ubuntu Docker镜像，因此我们可以SSH到我们的应用程序服务器并运行一些Docker命令。其中的部分代码 `before_script`大部分来自官方文档，但是，当然，我们可以对其进行一些调整以满足我们的需求。为不对私钥进行验证，添加了以下代码行：

- echo -e "Host *\n\tStrictHostKeyChecking no\n\n" > ~/.ssh/config

你也可以参考指南验证私钥。 如你在最后阶段的脚本部分中所见，我们正在执行一些Docker命令。

1. 停止正在运行的Docker容器：`docker stop $APP_NAME`。（这就是我们要在.env文件中定义`APP_NAME`的原因 ）

2. 删除所有未运行的Docker镜像 `docker system prune -a -f`。这实际上不是强制性的，但我想删除服务器上所有未使用的镜像。

3. 拉取最新版本的Docker镜像（该镜像是在上一个阶段中构建并推送的）。

4. 最后，使用以下命令运行Docker镜像：

docker container run -d --name $APP_NAME -p $PORT:8080 -e SPRING_PROFILES_ACTIVE=$SPRING_ACTIVE_PROFILE $DOCKER_REPO

译文链接： https://dzone.com/articles/automate-spring-boot-app-deployment-with-gitlab-ci

翻译：https://blog.csdn.net/weixin\_45132238/article/details/108075871

**- END -**

最近整理一份面试资料**《Java技术栈学习手册》**，覆盖了Java技术、面试题精选、Spring全家桶、Nginx、SSM、微服务、数据库、数据结构、架构等等。

获取方式：点“ **在看**，关注公众号 **Java后端** 并回复 **777** 领取，更多内容陆续奉上。

**推****荐****阅****读 **

***1.*** [卧槽！GitHub 又诞生一个沙雕项目？！][GitHub]

***2. ***[那些还在外包公司干的程序员们，快醒醒吧！][Link 1]

***3.*** [Linux 用着太爽啦！！！][Linux]

***4.*** [好用到爆的 Java 读源码技巧][Java 1]

***5.*** [深度好文：Linux 系统内存知识][Linux 1]

![format_png 3][]

**喜****欢****文****章****，****点****个****在看 **![format_png 4][]

[Java]: http://mp.weixin.qq.com/s?__biz=Mzg2MjEwMjI1Mg%3D%3D&chksm=ce0da17bf97a286df119047a25b7de51621fe542816673bb4aa3ebd8ab97b09a86ed7db2e2ee&idx=3&mid=2247489272&scene=21&sn=ce74938072fc73a808d83ccb474db46d#wechat_redirect
[format_png]: /images/20210730/07ecdc2ce26b49f39911ffe7919fe68e.png
[format_png 1]: /images/20210730/931430a6ff754e81adb06a3e71a59640.png
[format_png 2]: /images/20210730/5c304a056c8e4dd8af0b61ca393d8ea8.png
[GitHub]: http://mp.weixin.qq.com/s?__biz=Mzg2MjEwMjI1Mg%3D%3D&chksm=ce0e4a68f979c37ea521ea31d6fea56f6fa34ff81950e032e8c3d1b744605790a4a7cc13f51f&idx=1&mid=2247499243&scene=21&sn=3294e9ec235c16fac227b11942abecf7#wechat_redirect
[Link 1]: http://mp.weixin.qq.com/s?__biz=Mzg2MjEwMjI1Mg%3D%3D&chksm=ce0e4a68f979c37e7aa8713f8822601e6e07f4c202174729af1da6c7a7ee05a82870ae009ca2&idx=4&mid=2247499243&scene=21&sn=f200f9ffbc00b6f7c67b06954be02537#wechat_redirect
[Linux]: http://mp.weixin.qq.com/s?__biz=Mzg2MjEwMjI1Mg%3D%3D&chksm=ce0e4ac1f979c3d7009a5a4a682e28959bd67c64ec87cffbecea8f6fc7322dd974a237da8128&idx=1&mid=2247499074&scene=21&sn=4454cf7653521fb834dabd16a064d269#wechat_redirect
[Java 1]: http://mp.weixin.qq.com/s?__biz=Mzg2MjEwMjI1Mg%3D%3D&chksm=ce0e4aeaf979c3fc9ce121e89222fe5c100b3f95c0f79b8e2e152df0d77ec21c5b73cf023a65&idx=2&mid=2247499113&scene=21&sn=0a02bab42a7e9bcb8aa81f5200620780#wechat_redirect
[Linux 1]: http://mp.weixin.qq.com/s?__biz=Mzg2MjEwMjI1Mg%3D%3D&chksm=ce0e4ac1f979c3d717f54da828ac76b4cd725e5e5a759cd6914cdc611e572fdb1496c48c72c3&idx=4&mid=2247499074&scene=21&sn=96f892f36c31b12896a6c89131ee5824#wechat_redirect
[format_png 3]: /images/20210730/7f2bfb0cc9c14ba584f3827631240e5d.png
[format_png 4]: /images/20210730/55cc5ff3730d4eea8f4265974d2321d3.png