1. 程式人生 > >Docker容器化spring boot應用

Docker容器化spring boot應用

前置條件

容器化spring boot應用所需環境:
- jdk 1.8 +
- maven 3.0 +

我們的需求是:使用maven打包,將spring boot應用製作成docker映象並上傳到docker hub。在其他機器上,可以直接docker pull並執行容器。

建立spring boot應用

spring boot 包結構為:

└── src
    └── main
        └── java
            └── me
                └── ithakar

建立spring boot Application主類,src/main/java/me/ithakar/Application.java

package me.ithakar;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
@RestController
public class Application { @RequestMapping("/") public String home() { return "docker app running"; } public static void main(String[] args) { SpringApplication.run(Application.class, args); } }

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> <groupId>me.ithakar</groupId> <artifactId>docker-app</artifactId> <version>0.1.0</version> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>1.5.3.RELEASE</version> </parent> <properties> <java.version>1.8</java.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> </dependencies> <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> </project>

打包並啟動應用

mvn package && java -jar target/docker-app-0.1.0.jar

docker app running

則spring boot應用啟動成功

建立Dockerfile檔案

Dockerfile是一個文字檔案,類似shell指令碼,其內包含了一條條的指令。每一條指令的內容,就是描述對應的映象層應當如何構建。
Dockerfile位置:src/main/docker/Dockerfile

FROM frolvlad/alpine-oraclejdk8:slim 
VOLUME /tmp 
ADD docker-app-0.1.0.jar app.jar 
RUN sh -c 'touch /app.jar' 
ENV JAVA_OPTS="" 
ENTRYPOINT [ "sh", "-c", "java $JAVA_OPTS -Djava.security.egd=file:/dev/./urandom -jar /app.jar" ]
  • FROM 命令指定基礎映象,以一個映象為基礎,在其上進行定製。在這裡我們的基礎映象是frolvlad/alpine-oraclejdk8:slim。
  • VOLUME 定義匿名卷。對於可能需要操作資料庫類需要儲存動態資料的應用,其資料檔案應該儲存在主句的卷,而不是容器的儲存層。在這裡我們是將其掛載在了/tmp這個位置,從而保證了容器的無狀態化。
  • ADD 命令是較高階的複製命令,將jar包複製到/app.jar
  • ENTRYPOINT 容器執行後預設執行的命令

新增maven docker外掛

docker maven外掛是為了方便java開發者,由spotify公司開發的一款maven外掛。新增以下程式碼至pom.xml檔案中。

<properties>
   <docker.image.prefix>ithaka</docker.image.prefix>
</properties>
<build>
    <plugins>
        <plugin>
            <groupId>com.spotify</groupId>
            <artifactId>docker-maven-plugin</artifactId>
            <version>0.4.11</version>
            <configuration>
                <imageName>${docker.image.prefix}/${project.artifactId}:${project.version}</imageName>
                <dockerDirectory>src/main/docker</dockerDirectory>
                <pushImage>true</pushImage>
                <resources>
                    <resource>
                        <targetPath>/</targetPath>
                        <directory>${project.build.directory}</directory>
                        <include>${project.build.finalName}.jar</include>
                    </resource>
                </resources>
            </configuration>
        </plugin>
    </plugins>
</build>

注意,docker.image.prefix中的ithaka為我的docker hub 賬戶,使用時將其換成自己的

使用maven命令打包應用、構建docker映象並上傳映象到docker hub:

mvn package docker:build -DpushImage

此時我們將得到一個報錯:

[ERROR] Failed to execute goal com.spotify:docker-maven-plugin:0.4.11:build (default-cli) on project docker-app: Exception caught: denied: requested access to the resource is denied

這是因為我們在maven中push時,並沒有包含docker的使用者資訊,所以許可權校驗失敗。
解決方法為,在maven全域性setting.xml配置中,新增docker hub server資訊

<server>
        <id>docker-hub</id>
        <username>ithaka</username>
        <password>密碼</password>
        <configuration>
            <email>郵箱</email>
        </configuration>
</server>

在pom.xml中的docker-maven-plugi外掛中,指定server

<plugin>
    <groupId>com.spotify</groupId>
    <artifactId>docker-maven-plugin</artifactId>
    <configuration>
        <serverId>docker-hub</serverId>
    </configuration>
</plugin>

再繼續執行

mvn package docker:build -DpushImage

出現

The push refers to a repository [docker.io/ithaka/docker-app]
8c02854cd300: Pushed
a03c3b5dbe04: Pushed
8018d52798bb: Pushed
1e6468b956ae: Pushed
3fb66f713c9f: Pushed

0.0.1: digest: sha256:63456345745755577c19103dcf4838894e34d45a68a1ec23b2f69d6f059 size: 1375

即為上傳docker hub成功。

啟動docker容器

在另外一臺機器上,執行命令

docker run -p 8080:8080 -t ithaka/docker-app

docker app running

docker應用啟動成功。

參考文件: