使用Docker启动Spring Boot项目并读取外部配置文件

在现代开发中，Docker已经成为了容器化应用程序的标准创建和部署方式。伴随Spring Boot的流行，开发者们常常希望能够将Spring Boot应用容器化，并在容器中读取外部配置文件。本文将探讨如何使用Docker启动一个Spring Boot项目，同时读取外部配置文件，并提供相关代码示例。

环境准备

在开始之前，确保你的开发环境中已安装以下工具：

  1. Docker：用于创建和管理容器化应用程序。
  2. Spring Boot：构建Java应用程序的平台。
  3. Maven：项目管理和构建自动化工具（可选，Spring Boot项目通常使用Maven构建）。

创建Spring Boot项目

首先，使用Spring Initializr生成一个基础的Spring Boot项目。在浏览器中访问 [Spring Initializr](

  • Project: Maven Project
  • Language: Java
  • Spring Boot: 选择最新版本
  • Dependencies: 选择 Spring Web

生成并下载项目后，解压并在你的IDE中打开项目。

编写一个简单的控制器

在你的Spring Boot项目中，创建一个简单的REST控制器以验证配置是否正确。打开src/main/java/com/example/demo/DemoApplication.java文件，并添加以下代码：

package com.example.demo;

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

@RestController
@SpringBootApplication
public class DemoApplication {

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

    @GetMapping("/hello")
    public String hello() {
        return "Hello from Spring Boot!";
    }
}

外部配置文件

在你的项目中创建一个外部配置文件application.properties，添加你想要配置的内容，例如：

app.greeting=Hello from external configuration!

Dockerfile

在项目根目录下创建一个名为 Dockerfile 的文件，并添加以下内容：

# 使用JDK基础镜像
FROM openjdk:11-jre-slim

# 将JAR文件添加到容器中
COPY target/demo-0.0.1-SNAPSHOT.jar app.jar

# 将外部配置文件添加到容器中
COPY application.properties /config/application.properties

# 运行应用程序
ENTRYPOINT ["java", "-jar", "/app.jar", "--spring.config.location=/config/application.properties"]

构建项目

确保你的项目已被正确构建并生成了可执行的JAR文件。在项目根目录下运行以下命令：

mvn clean package

构建成功后，你会在 target 目录中看到生成的 demo-0.0.1-SNAPSHOT.jar 文件。

构建Docker镜像

在项目根目录下运行以下命令构建Docker镜像：

docker build -t springboot-demo .

运行Docker容器

接下来，使用以下命令启动Docker容器并读取外部配置文件：

docker run -d --name demo-app -v $(pwd)/application.properties:/config/application.properties -p 8080:8080 springboot-demo

这里的 -v $(pwd)/application.properties:/config/application.properties 参数用于将主机的配置文件挂载到容器的 /config/application.properties 路径中。

验证应用

在浏览器中访问 http://localhost:8080/hello，你应该能看到如下响应：

Hello from external configuration!

总结

通过以上步骤，你成功地将一个简单的Spring Boot应用容器化，并实现了从外部读取配置文件。使用Docker来管理和部署应用程序，使得开发、测试和生产环境之间的迁移变得更加简单和一致。

此外，借助Docker，团队可以将应用程序及其所有依赖项打包到一个可移植的容器中，这极大地提高了应用的可移植性和可维护性。

> “Docker和Spring Boot的结合，使得现代应用开发和部署变得更加高效。”

以下是关于Docker部署Spring Boot项目的饼状图：

pie
    title Docker Spring Boot 项目部署方式
    "容器化": 40
    "本地部署": 30
    "云部署": 30

希望这篇文章能帮助你更好地理解在Docker中启动Spring Boot应用及其读取外部配置文件的过程。如果你对Docker或Spring Boot有更多的兴趣，别忘了继续学习和实践！