1. 程式人生 > >使用 Docker 部署 Spring Boot 專案

使用 Docker 部署 Spring Boot 專案

Docker 介紹

Docker 屬於 Linux 容器的一種封裝,提供簡單易用的容器使用介面。它是目前最流行的 Linux 容器解決方案。

Docker 將應用程式與該程式的依賴,打包在一個檔案裡面。執行這個檔案,就會生成一個虛擬容器。程式在這個虛擬容器裡執行,就好像在真實的物理機上執行一樣。有了 Docker,就不用擔心環境問題。

總體來說,Docker 的介面相當簡單,使用者可以方便地建立和使用容器,把自己的應用放入容器。容器還可以進行版本管理、複製、分享、修改,就像管理普通的程式碼一樣。

Docker 的主要用途

  • (1)提供一次性的環境。比如,本地測試他人的軟體、持續整合的時候提供單元測試和構建的環境。

  • (2)提供彈性的雲服務。因為 Docker 容器可以隨開隨關,很適合動態擴容和縮容。

  • (3)組建微服務架構。通過多個容器,一臺機器可以跑多個服務,因此在本機就可以模擬出微服務架構。

Docker 的安裝(CentOS環境)

  • 安裝命令
yum install docker
  • 安裝完成後,使用下面的命令來啟動 docker 服務,並將其設定為開機啟動
service docker start
chkconfig docker on

#LCTT 譯註:此處採用了舊式的 sysv 語法,如採用CentOS 7中支援的新式 systemd 語法,如下:
systemctl  start docker.service
systemctl  enable docker.service
  • 使用Docker 中國加速器
vi  /etc/docker/daemon.json

#新增後:
{
    "registry-mirrors": ["https://registry.docker-cn.com"],
    "live-restore": true
}
  • 重新啟動docker
systemctl restart docker

輸入 docker version 返回版本資訊則安裝正常。

安裝JDK

yum -y install java-1.8.0-openjdk*

配置環境變數 開啟 vim /etc/profile 新增一下內容

export JAVA_HOME=/usr/lib/jvm/jre-1.8.0-openjdk-1.8.0.242.b08-0.el7_7.x86_64
export CLASSPATH=.:$JAVA_HOME/jre/lib/rt.jar:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
export PATH=$PATH:$JAVA_HOME/bin

修改完成之後,使其生效

source /etc/profile

輸入java -version 返回版本資訊則安裝正常。

安裝 MAVEN

下載:https://mirror.bit.edu.cn/apache/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz

## 解壓
tar vxf apache-maven-3.6.3-bin.tar.gz
## 移動
mv apache-maven-3.6.3 /usr/local/maven3

修改環境變數, 在/etc/

MAVEN_HOME=/usr/local/maven3
export MAVEN_HOME
export PATH=${PATH}:${MAVEN_HOME}/bin

執行source /etc/profile使環境變數生效。

輸入mvn -version 返回版本資訊則安裝正常。

到止,通過docker,jdk,maven的安裝,整個構建環境算配置完成了。

建立 spring boot 專案

pom.xml

<?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 http://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.2.4.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <groupId>com.easy</groupId>
    <artifactId>spring-boot-docker</artifactId>
    <version>1.0</version>
    <packaging>jar</packaging>

    <name>spring-boot-docker</name>
    <description>Demo project for Spring Boot</description>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <java.version>1.8</java.version>
        <docker.image.prefix>springboot</docker.image.prefix>
    </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>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
            <!-- Docker maven plugin -->
            <plugin>
                <groupId>com.spotify</groupId>
                <artifactId>docker-maven-plugin</artifactId>
                <version>1.0.0</version>
                <configuration>
                    <imageName>${docker.image.prefix}/${project.artifactId}</imageName>
                    <dockerDirectory>src/main/docker</dockerDirectory>
                    <resources>
                        <resource>
                            <targetPath>/</targetPath>
                            <directory>${project.build.directory}</directory>
                            <include>${project.build.finalName}.jar</include>
                        </resource>
                    </resources>
                </configuration>
            </plugin>
            <!-- Docker maven plugin -->
        </plugins>
    </build>

</project>

Dockerfile 配置

FROM openjdk:8-jdk-alpine
VOLUME /tmp
EXPOSE 8282
ADD spring-boot-docker-1.0.jar app.jar
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]

Dockerfile 檔案介紹,構建 Jdk 基礎環境,新增 Spring Boot Jar 到映象中:

  • FROM,表示使用 Jdk8 環境 為基礎映象,如果映象不是本地的會從 DockerHub 進行下載
  • VOLUME,VOLUME 指向了一個/tmp的目錄,由於 Spring Boot 使用內建的Tomcat容器,Tomcat 預設使用/tmp作為工作目錄。這個命令的效果是:在宿主機的/var/lib/docker目錄下建立一個臨時檔案並把它連結到容器中的/tmp目錄
  • EXPOSE,EXPOSE 指令是宣告執行時容器提供服務埠,這只是一個宣告,在執行時並不會因為這個宣告應用就會開啟這個埠的服務。在 Dockerfile 中寫入這樣的宣告有兩個好處,一個是幫助映象使用者理解這個映象服務的守護埠,以方便配置對映;另一個用處則是在執行時使用隨機埠對映時,也就是 docker run -P 時,會自動隨機對映 EXPOSE 的埠。
  • ADD,拷貝檔案並且重新命名
  • ENTRYPOINT,為了縮短 Tomcat 的啟動時間,新增java.security.egd的系統屬性指向/dev/urandom作為 ENTRYPOINT

其它示例程式碼

DockerController.java

@RestController
public class DockerController {

    @RequestMapping("/")
    public String index() {
        return "Hello Docker!";
    }
}

DockerApplication.java

@SpringBootApplication
public class DockerApplication {

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

application.properties

server.port=8282

使用 Docker 部署 Spring Boot 專案

將專案 docker 拷貝至伺服器中,進入專案路徑下進行打包測試。

#打包
mvn package
#啟動
java -jar target/spring-boot-docker-1.0.jar

看到 Spring Boot 的啟動日誌後表明環境配置沒有問題,接下來我們使用 DockerFile 構建映象。

mvn package docker:build

第一次構建可能有點慢,當看到以下內容的時候表明構建成功:

Step 1/5 : FROM openjdk:8-jdk-alpine
 ---> a3562aa0b991
Step 2/5 : VOLUME /tmp
 ---> Using cache
 ---> d070c927d0a7
Step 3/5 : EXPOSE 8282
 ---> Using cache
 ---> b16d14267527
Step 4/5 : ADD spring-boot-docker-1.0.jar app.jar
 ---> c4ddc409b458
Removing intermediate container c58c986e6b9a
Step 5/5 : ENTRYPOINT java -Djava.security.egd=file:/dev/./urandom -jar /app.jar
 ---> Running in d2b61fddd616
 ---> 13c600d3f625
Removing intermediate container d2b61fddd616
Successfully built 13c600d3f625
[INFO] Built springboot/spring-boot-docker
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 7.273 s
[INFO] Finished at: 2020-03-25T10:05:04+08:00
[INFO] ------------------------------------------------------------------------

使用docker images命令檢視構建好的映象:

# docker images
REPOSITORY                      TAG                 IMAGE ID            CREATED             SIZE
springboot/spring-boot-docker   latest              13c600d3f625        18 minutes ago      122 MB
docker.io/openjdk               8-jdk-alpine        a3562aa0b991        10 months ago       105 MB

springboot/spring-boot-docker 就是我們構建好的映象,下一步就是執行該映象

docker run -p 8282:8282 -t springboot/spring-boot-docker

啟動完成之後我們使用docker ps檢視正在執行的映象:

# docker ps
CONTAINER ID        IMAGE                           COMMAND                  CREATED             STATUS              PORTS                    NAMES
a626c3dbdb1b        springboot/spring-boot-docker   "java -Djava.secur..."   34 seconds ago      Up 34 seconds       0.0.0.0:8282->8282/tcp   suspicious_murdock

可以看到我們構建的容器正在在執行,訪問瀏覽器:http://192.168.0.x:8282/,返回

Hello Docker!
說明使用 Docker 部署 Spring Boot 專案成功!

資料

  • 示例程式碼-github
  • Docker 入門教程
  • Spring Boot 2 (四):使用 Docker 部署 Spring Boot