Spring Boot應(yīng)用發(fā)布到Docker的實(shí)現(xiàn)

2024-07-14 08:41:10

字體：大中小

供稿：網(wǎng)友

Spring官網(wǎng)上有一篇Getting Start，介紹了如何使用Docker發(fā)布Spring Boot應(yīng)用，算是比較詳細(xì)了，不過有些細(xì)節(jié)沒有提及到，而且官網(wǎng)的入門手冊是英文版。這里重新整理記錄一下，算是給英文不好的小伙伴一個(gè)參考，也給自己留個(gè)備忘。

準(zhǔn)備

需要的工具以及運(yùn)行環(huán)境：

JDK 1.8 or later
Maven 3.0 +
你喜歡的IDE或其他文本編輯器

創(chuàng)建工程

首先，你需要?jiǎng)?chuàng)建一個(gè)Spring Boot工程，Spring Tool Suite和IntelliJ IDEA都自帶插件可以創(chuàng)建，還有一種方式是從http://start.spring.io/上創(chuàng)建，推薦使用這種方式。填好表單中的Group Id和Artifact Id之后，點(diǎn)擊Generate Project按鈕就可以生成了，將下載后的工程導(dǎo)入到你喜歡的IDE中。

修改pom.xml文件，添加docker-maven-plugin：

<?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>org.matrixstudio.springboot</groupId>  <artifactId>docker</artifactId>  <version>0.0.1-SNAPSHOT</version>  <packaging>jar</packaging>  <name>docker</name>  <description>Demo project for Spring Boot</description>  <parent>    <groupId>org.springframework.boot</groupId>    <artifactId>spring-boot-starter-parent</artifactId>    <version>1.5.2.RELEASE</version>    <relativePath/> <!-- lookup parent from repository -->  </parent>  <properties>    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>    <java.version>1.8</java.version>    <docker.image.prefix>springio</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>0.4.3</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>    </plugins>  </build></project>

docker-maven-plugin插件用于將Spring Boot工程構(gòu)建為Docker鏡像：

imageName表示Docker鏡像名稱，我們使用Docker的命名規(guī)范，命名為：springio/docker
dockerDirectory表示Dockerfile的路徑
resource表示在構(gòu)建時(shí)需要的資源文件，這些文件和Dockerfile放在一起，這里只需要Spring Boot生成的jar文件即可。

打開DockerApplication.java文件，修改成如下內(nèi)容：

package org.matrixstudio.springboot;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@RestControllerpublic class DockerApplication {  @RequestMapping("/")  public String home() {    return "Hello Docker World";  }  public static void main(String[] args) {    SpringApplication.run(DockerApplication.class, args);  }}

編譯并運(yùn)行

執(zhí)行如下命令運(yùn)行Spring Boot工程：

mvn package && java -jar target/docker-0.0.1-SNAPSHOT.jar

打開瀏覽器，輸入http://localhost:8080，如果出現(xiàn)“Hello Docker World”說明運(yùn)行成功。

注：運(yùn)行上面的命令時(shí)，需要從Maven官方倉庫中下載很多依賴包，國內(nèi)網(wǎng)絡(luò)不太穩(wěn)定，下載速度較慢，可考慮使用第三方提供的鏡像站，比如阿里的Maven鏡像倉庫。在pom.xml中加入下面配置：

<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>org.matrixstudio.springboot</groupId>  <artifactId>docker</artifactId>  <version>0.0.1-SNAPSHOT</version>  <packaging>jar</packaging>  <!-- Dependencies -->  ......  <!-- Build -->  ......  <!-- Aliyun repository -->  <repositories>    <repository>    <id>central</id>      <name>aliyun</name>      <url>http://maven.aliyun.com/nexus/content/groups/public/</url>      <releases>        <enabled>true</enabled>      </releases>    </repository>  </repositories></project>

容器化項(xiàng)目

首先要確保你的機(jī)器上安裝了Docker，如果你的Docker安裝在一臺Linux服務(wù)器上，你需要將上面的Spring Boot工程上傳到該服務(wù)器上，下面的步驟假設(shè)你是在Linux環(huán)境上操作。

創(chuàng)建Dockerfile

Docker使用一個(gè)名為Dockerfile的文件來指定image層，所以我們首先需要?jiǎng)?chuàng)建一個(gè)Dockerfile文件，執(zhí)行下面的命令創(chuàng)建Dockerfile文件：

sudo tee src/main/docker/Dockerfile <<-'EOF'FROM frolvlad/alpine-oraclejdk8:slimVOLUME /tmpADD docker-0.0.1-SNAPSHOT.jar app.jarRUN sh -c 'touch /app.jar'ENV JAVA_OPTS=""ENTRYPOINT [ "sh", "-c", "java $JAVA_OPTS -Djava.security.egd=file:/dev/./urandom -jar /app.jar" ]EOF

大概解釋一下上面的命令：

VOLUME指向了一個(gè)/tmp的目錄，由于Spring Boot使用內(nèi)置的Tomcat容器，Tomcat默認(rèn)使用/tmp作為工作目錄。效果就是在主機(jī)的/var/lib/docker目錄下創(chuàng)建了一個(gè)臨時(shí)文件，并連接到容器的/tmp。
將項(xiàng)目的jar文件作為app.jar添加到容器
RUN表示在新創(chuàng)建的鏡像中執(zhí)行一些命令，然后把執(zhí)行的結(jié)果提交到當(dāng)前鏡像。這里使用touch命令來改變文件的修改時(shí)間，Docker創(chuàng)建的所有容器文件默認(rèn)狀態(tài)都是“未修改”。這對于簡單應(yīng)用來說不需要，不過對于一些靜態(tài)內(nèi)容（比如：index.html）的文件就需要一個(gè)“修改時(shí)間”。
為了縮短Tomcat的啟動(dòng)時(shí)間，我們添加一個(gè)java.security.egd的系統(tǒng)屬性指向/dev/urandom作為ENTRYPOINT。

構(gòu)建Docker鏡像

運(yùn)行下面的命令構(gòu)建Docker鏡像：

mvn package docker:build

構(gòu)建完成后，運(yùn)行下面的命令查看：

sudo docker images

結(jié)果為：

REPOSITORY                   TAG                 IMAGE ID            CREATED             SIZE
springio/docker              latest              7e2ba2f7e81e        2 minutes ago       195 MB
frolvlad/alpine-oraclejdk8   slim                00d8610f052e        4 days ago          167 MB

可以看到我們構(gòu)建的鏡像已經(jīng)出現(xiàn)了，下一步就是運(yùn)行該鏡像。

運(yùn)行Docker鏡像

執(zhí)行下面的命令來運(yùn)行上一步構(gòu)建的Docker鏡像：

sudo docker run -p 8080:8080 -t springio/docker

如果不出意外，你將看到下面的輸出內(nèi)容：

 .  ____     _      __ _ _ /// / ___'_ __ _ _(_)_ __ __ _ / / / /( ( )/___ | '_ | '_| | '_ // _` | / / / / /// ___)| |_)| | | | | || (_| | ) ) ) ) ' |____| .__|_| |_|_| |_/__, | / / / / =========|_|==============|___/=/_/_/_/ :: Spring Boot ::    (v1.5.2.RELEASE)2017-03-08 03:34:59.434 INFO 6 --- [      main] o.m.springboot.DockerApplication     : Starting DockerApplication v0.0.1-SNAPSHOT on 00eed53e6928 with PID 6 (/app.jar started by root in /)2017-03-08 03:34:59.445 INFO 6 --- [      main] o.m.springboot.DockerApplication     : No active profile set, falling back to default profiles: default2017-03-08 03:34:59.752 INFO 6 --- [      main] ationConfigEmbeddedWebApplicationContext : Refreshing org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext@4b9af9a9: startup date [Wed Mar 08 03:34:59 GMT 2017]; root of context hierarchy2017-03-08 03:35:03.755 INFO 6 --- [      main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat initialized with port(s): 8080 (http)2017-03-08 03:35:03.807 INFO 6 --- [      main] o.apache.catalina.core.StandardService  : Starting service Tomcat2017-03-08 03:35:03.821 INFO 6 --- [      main] org.apache.catalina.core.StandardEngine : Starting Servlet Engine: Apache Tomcat/8.5.112017-03-08 03:35:04.042 INFO 6 --- [ost-startStop-1] o.a.c.c.C.[Tomcat].[localhost].[/]    : Initializing Spring embedded WebApplicationContext2017-03-08 03:35:04.043 INFO 6 --- [ost-startStop-1] o.s.web.context.ContextLoader      : Root WebApplicationContext: initialization completed in 4303 ms2017-03-08 03:35:04.441 INFO 6 --- [ost-startStop-1] o.s.b.w.servlet.ServletRegistrationBean : Mapping servlet: 'dispatcherServlet' to [/]2017-03-08 03:35:04.455 INFO 6 --- [ost-startStop-1] o.s.b.w.servlet.FilterRegistrationBean  : Mapping filter: 'characterEncodingFilter' to: [/*]2017-03-08 03:35:04.457 INFO 6 --- [ost-startStop-1] o.s.b.w.servlet.FilterRegistrationBean  : Mapping filter: 'hiddenHttpMethodFilter' to: [/*]2017-03-08 03:35:04.468 INFO 6 --- [ost-startStop-1] o.s.b.w.servlet.FilterRegistrationBean  : Mapping filter: 'httpPutFormContentFilter' to: [/*]2017-03-08 03:35:04.468 INFO 6 --- [ost-startStop-1] o.s.b.w.servlet.FilterRegistrationBean  : Mapping filter: 'requestContextFilter' to: [/*]2017-03-08 03:35:05.110 INFO 6 --- [      main] s.w.s.m.m.a.RequestMappingHandlerAdapter : Looking for @ControllerAdvice: org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext@4b9af9a9: startup date [Wed Mar 08 03:34:59 GMT 2017]; root of context hierarchy2017-03-08 03:35:05.390 INFO 6 --- [      main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/]}" onto public java.lang.String org.matrixstudio.springboot.DockerApplication.home()2017-03-08 03:35:05.402 INFO 6 --- [      main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/error],produces=[text/html]}" onto public org.springframework.web.servlet.ModelAndView org.springframework.boot.autoconfigure.web.BasicErrorController.errorHtml(javax.servlet.http.HttpServletRequest,javax.servlet.http.HttpServletResponse)2017-03-08 03:35:05.404 INFO 6 --- [      main] s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped "{[/error]}" onto public org.springframework.http.ResponseEntity<java.util.Map<java.lang.String, java.lang.Object>> org.springframework.boot.autoconfigure.web.BasicErrorController.error(javax.servlet.http.HttpServletRequest)2017-03-08 03:35:05.512 INFO 6 --- [      main] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/webjars/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]2017-03-08 03:35:05.512 INFO 6 --- [      main] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]2017-03-08 03:35:05.639 INFO 6 --- [      main] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/**/favicon.ico] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler]2017-03-08 03:35:06.019 INFO 6 --- [      main] o.s.j.e.a.AnnotationMBeanExporter    : Registering beans for JMX exposure on startup2017-03-08 03:35:06.168 INFO 6 --- [      main] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on port(s): 8080 (http)2017-03-08 03:35:06.183 INFO 6 --- [      main] o.m.springboot.DockerApplication     : Started DockerApplication in 7.893 seconds (JVM running for 8.743)2017-03-08 03:35:56.728 INFO 6 --- [nio-8080-exec-1] o.a.c.c.C.[Tomcat].[localhost].[/]    : Initializing Spring FrameworkServlet 'dispatcherServlet'2017-03-08 03:35:56.728 INFO 6 --- [nio-8080-exec-1] o.s.web.servlet.DispatcherServlet    : FrameworkServlet 'dispatcherServlet': initialization started2017-03-08 03:35:56.774 INFO 6 --- [nio-8080-exec-1] o.s.web.servlet.DispatcherServlet    : FrameworkServlet 'dispatcherServlet': initialization completed in 43 ms

執(zhí)行以下命令，查看正在運(yùn)行的Docker容器：

sudo docker ps

可以看到已經(jīng)有一個(gè)Docker容器在運(yùn)行了：

 CONTAINER ID    IMAGE        COMMAND         CREATED       STATUS       PORTS          NAMES00eed53e6928    springio/docker   "sh -c 'java $JAVA..."  About a minute ago  Up About a minute  0.0.0.0:8080->8080/tcp  fervent_leavitt

現(xiàn)在輸入http://localhost:8080可以查看到“Hello Docker World”結(jié)果。

如果要停止容器，可以執(zhí)行下面的命令：