如何将 Spring-Boot Web 服务转换为 Docker 映像？

Posted 2023-02-27

【中文标题】如何将 Spring-Boot Web 服务转换为 Docker 映像？

【英文标题】：How to convert a Spring-Boot web service into a Docker image?

【发布时间】：2019-06-13 15:54:30

【问题描述】：

我想从 Docker 容器访问我的网站，但我不能。我试图实施的步骤如下。完成所有步骤后我无法访问http://localhost:8080/index 页面，我在哪里出错了？

Spring-Boot 项目名称为demo。我的部分代码：

package com.qwerty.demo.rest;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class FunRestService 

    @GetMapping("/index")
    public String setIndex() 
        return "HELLO WORLD!";
    

我的dockerfile 代码：

FROM openjdk:8
COPY . /usr/var/www/MYPROJECT
WORKDIR /usr/var/www/MYPROJECT
EXPOSE 8080
CMD ./mvnw spring-boot:run

我使用此命令将 Spring-Boot 项目构建到 myimage1。

docker build -t myimage1 .

然后，我使用此命令从myimage1 创建一个新容器。

docker run --name mycontainer1 myimage1

Maven 会下载必要的文件并为我启动我的应用程序。最后输出：

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::        (v2.1.2.RELEASE)

2019-01-19 17:40:32.604  INFO 6 --- [           main] com.qwerty.demo.DemoApplication     : Starting DemoApplication on 8086b6e010fb with PID 6 (/usr/var/www/MYPROJECT/target/classes started by root in /usr/var/www/MYPROJECT)
2019-01-19 17:40:32.613  INFO 6 --- [           main] com.qwerty.demo.DemoApplication     : No active profile set, falling back to default profiles: default
2019-01-19 17:40:34.119  INFO 6 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat initialized with port(s): 8080 (http)
2019-01-19 17:40:34.170  INFO 6 --- [           main] o.apache.catalina.core.StandardService   : Starting service [Tomcat]
2019-01-19 17:40:34.171  INFO 6 --- [           main] org.apache.catalina.core.StandardEngine  : Starting Servlet engine: [Apache Tomcat/9.0.14]
2019-01-19 17:40:34.186  INFO 6 --- [           main] o.a.catalina.core.AprLifecycleListener   : The APR based Apache Tomcat Native library which allows optimal performance in production environments was not found on the java.library.path: [/usr/java/packages/lib/amd64:/usr/lib/x86_64-linux-gnu/jni:/lib/x86_64-linux-gnu:/usr/lib/x86_64-linux-gnu:/usr/lib/jni:/lib:/usr/lib]
2019-01-19 17:40:34.288  INFO 6 --- [           main] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring embedded WebApplicationContext
2019-01-19 17:40:34.289  INFO 6 --- [           main] o.s.web.context.ContextLoader            : Root WebApplicationContext: initialization completed in 1559 ms
2019-01-19 17:40:34.602  INFO 6 --- [           main] o.s.s.concurrent.ThreadPoolTaskExecutor  : Initializing ExecutorService 'applicationTaskExecutor'
2019-01-19 17:40:34.882  INFO 6 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8080 (http) with context path ''2019-01-19 17:40:34.888  INFO 6 --- [           main] com.qwerty.demo.DemoApplication     : Started DemoApplication in 3.176 seconds (JVM running for 69.839)

我们应该怎么做才能将这样的 Spring-Boot 项目（使用Dockerfile）转换为图像？如何访问我的网页？

【参考方案1】：

当您运行 Docker 容器时，默认情况下不会发布任何应用程序碰巧在其中侦听的所有端口。

为了发布一个端口，你需要在使用你的镜像运行容器时指定它。有关如何执行此操作的所有详细信息，您可以查看 docker run 命令文档中的“EXPOSE”部分：https://docs.docker.com/engine/reference/run/

简而言之，您想在运行容器时添加另一个选项：

docker run --name mycontainer1 -p 8080:8080 myimage1

我不确定你是否想通过添加来实现这一点

EXPOSE 8080

在您的 Dockerfile 中。实际上，这并不意味着在使用镜像运行容器时会暴露端口。您可能会在Dockerfile reference 中找到：

EXPOSE 指令实际上并不发布端口。它充当构建映像的人和运行容器的人之间的一种文档类型，关于打算发布哪些端口。要在运行容器时实际发布端口，请使用 docker run 上的 -p 标志来发布和映射一个或多个端口，或使用 -P 标志来发布所有暴露的端口并将它们映射到高阶端口。

【参考方案2】：

要完全解决您的问题（例如，在开发阶段将 Spring Boot 项目 docker 化并在本地浏览器中浏览相应的 webapp），必须完成三个独立的任务：

通过使用受益于 Docker 缓存机制的Dockerfile 来利用 Docker 映像的构建（避免每次从头开始重新下载 Maven 依赖项，从而加快构建速度）

确保 Spring Boot 应用侦听指定端口0.0.0.0 特殊 IP，而不是 localhost；

最后发布给定的端口，以便您可以运行例如：

 $ xdg-open http://localhost:8080/index

@Poger 的回答中很好地解释了第 3 步，所以我将仅详细说明第 1 步和第 2 步：

我在这个 SO 线程中提出了一个 Dockerfile：How to cache maven dependencies in Docker，灵感来自 this blog article，它适用于一般的 Java/Maven 项目（不仅是 Spring Boot 项目）：

 # our base build image
 FROM maven:3-jdk-8 as maven

 WORKDIR /app

 # copy the Project Object Model file
 COPY pom.xml pom.xml

 # fetch all dependencies
 RUN mvn dependency:go-offline -B

 # copy your other files
 COPY src src/

 # build for release
 # NOTE: my-project-* should be replaced with the proper prefix
 RUN mvn package && cp target/my-project-*.jar app.jar


 # smaller, final base image
 FROM openjdk:8-jre-alpine
 # OPTIONAL: copy dependencies so the thin jar won't need to re-download them
 # COPY --from=maven /root/.m2 /root/.m2

 # set deployment directory
 WORKDIR /app

 # copy over the built artifact from the maven image
 COPY --from=maven /app/app.jar app.jar

 # set the startup command to run your binary
 CMD ["java", "-jar", "/app/app.jar"]

但要进一步完善，请注意建议pass an extra system property java.security.egd：

 CMD ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app/app.jar"]

或者如果您更喜欢ENTRYPOINT 而不是CMD：

 ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app/app.jar"]

如 SO 线程 How do I access a spring app running in a docker container? 中所述，在容器化应用程序的上下文中，应避免使用 localhost，并在大多数情况下将其替换为 0.0.0.0（即，如果应用程序应充当 Web 服务回复来自容器外部的传入请求）。

总而言之，您应该尝试在 application.properties 文件中添加以下行：

 server.address=0.0.0.0