Docker容器化部署SpringBoot应用实践

一、Background

springboot-micro-service

Spring Boot makes it easy to create stand-alone, production-grade Spring based Applications that you can "just run".

用SpringBoot开发构建基于Spring的SpringBoot Apps应用服务是超级简单，但是多个实例同时部署到虚机，需要先上传包然后使用类似java -Dserver.port=8080 -jar app.jar命令启动。现在docker容器化技术已经发展很成熟，采用docker容器化部署SpringBoot Apps也是so easy.

二、构建基于SpringBoot的Java应用容器化Docker部署

1. 项目结构

docker-project-arch

2. 基于SpringBoot的Java应用构建准备

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">
    <parent>
        <artifactId>springcloud-app-docker</artifactId>
        <groupId>com.licq</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>springcloud-app-docker-java-helloworld</artifactId>
    <name>springcloud-app-docker-java-helloworld</name>
    <packaging>jar</packaging>
    <description>docker-java应用helloworld</description>
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>

        <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>
        <finalName>${project.artifactId}</finalName>
        <pluginManagement>
            <plugins>
                <plugin>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-maven-plugin</artifactId>
                    <configuration>
                    <skip>true</skip>
                    </configuration>
                </plugin>
            </plugins>
        </pluginManagement>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>8</source>
                    <target>8</target>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

创建一个Api测试HelloController

package com.vincent.springcloud.app.docker.controller;

import com.alibaba.fastjson.JSONObject;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.bind.annotation.RestController;

/**
 * @author vincent.li
 * @Description docker-app-hello-world
 * @since 2019/6/29
 */
@RestController
public class HelloController {

    @Value("${server.port}")
    private String serverPort;
    @Value("${spring.application.name}")
    private String applicationName;


    @ResponseBody
    @GetMapping("/hello/{name}")
    public JSONObject hello(@PathVariable("name") String name){
        return new JSONObject()
                .fluentPut("hello", name)
                .fluentPut("application", applicationName)
                .fluentPut("port", serverPort);
    }

}

SpringBoot应用启动类

package com.vincent.springcloud.app.docker;

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

import java.util.TimeZone;

/**
 * @author vincent.li
 * @Description api提供服务
 * @since 2019/6/29
 */
@SpringBootApplication(scanBasePackages = {"com.vincent.springcloud.app.docker"})
public class SpringCloudAppDockerApplication {
    public static void main(String[] args) {
        TimeZone.setDefault(TimeZone.getTimeZone("Asia/Shanghai"));
        SpringApplication.run(SpringCloudAppDockerApplication.class, args);
        System.out.println("(#^.^#)   【SpringCloud-docker-app-hello-world】启动成功      (#^.^#)");
    }
}

3. SpringBoot应用打包成jar

mvn clean install -DskipTests

4. 编写Dockerfile

#从公共仓库下载java:8到本地容器
FROM java:8
#申明作者可以不写
MAINTAINER vincent.li vincentlee99@126.com
#WORKDIR：工作目录，类似于cd命令
#把maven打包好的jar拷贝到容器中并命名为app.jar
COPY target/springcloud-app-docker-java-helloworld.jar app.jar

#ENV：设置环境变量
ENV LANG C.UTF-8
#配置容器，使其可执行化。配合CMD可省去"application"，只使用参数。
ENTRYPOINT ["java", "-jar", "/app.jar"]
#EXPOSE：指定于外界交互的端口
EXPOSE 8080
#VOLUME：用于指定持久化目录

5. 构建Docker镜像

在Dockerfile文件所在的目录执行以下docker命令构建镜像

docker build -t demo-helloworld .

镜像构建完成后可以采用以下docker命令查看我们自己构建的镜像

docker image ls

docker-image-ls

6. 使用镜像启动容器

执行如下docker命令可以启动镜像

docker run -d -p 8099:8080 demo-helloworld

启动命令中-d是以后台守护进程的方式执行，-p映射宿主机和容器内部执行应用服务的端口，上面的命令是把宿主机的8099端口映射到容器的8080端口，通过这些配置，我们就把docker容器的8080端口对应的服务提供给外面访问了。

三、验证容器化部署应用

我可以通过docker命令查看容器进程,可以查看到我们demo-helloworld镜像的容器在运行,以及相关端口映射信息。

docker ps

命令执行结果如下图：

也可以通过执行下面的docker命令进入容器内部查看应用的jar包位置。
docker exec -it 3156c04e6d6c /bin/bash
其中3156c04e6d6c为对应的容器id.命令执行结果如下图：

通过http请求调用验证我们的应用是否能正常提供服务，在宿主上的浏览器上打开链接 http://localhost:8099/hello/docker，可以看到如下返回就说明服务正常了。

{
    "application":"springcloud-docker-app-hello-world",
    "port":"8080",
    "hello":"docker"
}

也可以使用curl http://localhost:8099/hello/docker命令验证。

One More Thing

我们如果想在同一台虚机上采用容器化部署多个应用怎么做了呢？很简单，只需要执行以下类似命令多条就可以实现，很方便。

docker run -d -p 8081:8080 demo-helloworld
docker run -d -p 8082:8080 demo-helloworld
docker run -d -p 8083:8080 demo-helloworld

当然实际情况我们不可能是只有一台虚机，是多台虚机资源来部署，重复一条一条去执行命令肯定是不行的，这个可以结合jenkins,gitlab等工具，这个后面就涉及到CI/CD以及使用k8s来管理虚机资源和docker容器化服务治理和编排，后面有时间的时候再写一篇关于k8s可落地实践的文章。