在如今快速发展的环境中，将应用程序容器化已成为一种标准做法。容器确保了不同环境间的一致性，使应用程序的开发、测试和部署变得更加容易。以简单性和快速开发著称的Spring Boot可以从Docker的便携性和可扩展性中获得很大好处。在这篇文章中，我们将逐步介绍如何将一个Spring Boot REST API进行容器化，并在本地机器上测试。

在我们开始之前，请确保您的机器上已经安装了以下工具。

• Docker ：用于容器化，
• Java JDK ：版本需要 8 或更高
• Maven ：用于构建 Spring Boot 应用

另外，本指南假设你已经了解以下几点：

• Spring Boot的基础概念
• 编写和理解Dockerfile文件
• 使用Docker命令行

首先，让我们搭建一个简单的 Spring Boot REST API。如下是我们示例应用程序的简要介绍：

    包名 com.example.demo;  

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

    @SpringBootApplication  
    公共 类 DemoApplication {  
        公共 静态 void main(String[] args) {  
            SpringApplication.run(DemoApplication.class, args);  
        }  
    }  

    @RestController  
    类 HelloWorldController {  
        @GetMapping("/hello")  
        公共 String hello() {  
            return "Hello, Docker!";  
        }  
    }  

这个应用程序有一个单个端点 /hello，返回一条简单的问候信息。

接下来，我们需创建一个Dockerfile来将我们的应用打包成容器。这里是一个Dockerfile的详细示例：

    # 使用官方的 OpenJDK 运行时作为基础镜像，比如 openjdk:11-jre-slim  
    FROM openjdk:11-jre-slim  

    # 设置工作目录为 /app  
    WORKDIR /app  

    # 复制 JAR 文件到工作目录  
    COPY target/demo-0.0.1-SNAPSHOT.jar app.jar  

    # 暴露端口 8080  
    EXPOSE 8080  

    # 运行 app.jar  
    ENTRYPOINT ["java", "-jar", "app.jar"]

我们来拆分一下每个指令。

• FROM : 指定了一个轻量级的OpenJDK运行时环境作为基础镜像。
• WORKDIR : 设置工作目录。
• COPY : 把主机上的JAR文件复制到容器里。
• EXPOSE : 暴露8080端口。
• ENTRYPOINT : 定义运行应用的命令。

有了 Dockerfile，我们就可以构建 Docker 镜像了。切换到您的 Spring Boot 项目的根目录，并执行以下命令：输入以下命令。

运行以下命令:

mvn clean package  （执行Maven的清理和打包命令）
docker build -t spring-boot-docker-demo . (使用Docker构建镜像并指定标签为spring-boot-docker-demo)

mvn clean package 命令将应用打包成 JAR 文件，docker build 命令创建并标记为 spring-boot-docker-demo 的 Docker 镜像。

要运行 Docker 容器，请使用如下命令：

    docker run -p 8080:8080 spring-boot-docker-demo
运行Spring Boot Docker示例并映射端口8080

此命令将您主机的 8080 端口映射到容器中的 8080 端口。您的 Spring Boot 应用程序现在应该已经在 Docker 容器中运行，并且可以通过 http://localhost:8080/hello 访问。

你可以使用比如 Postman 或 cURL 这样的工具来测试 REST API。这里以 cURL 为例。

在本地服务器上运行curl命令来获取问候信息: curl http://localhost:8080/hello

你应该看到回复是：Hello,Docker!。

另外，你可以查看容器的日志以确保一切运行顺畅：

docker logs <container_id>

使用 docker ps 命令找到你正在运行的容器的实际 ID，并将其替换为 <container_id>。

在这篇博客中，我们介绍了如何用 Docker 封装一个 Spring Boot REST API 并在本地测试。使用 Docker 将 Spring Boot 应用程序容器化提供了许多好处，包括环境一致性、容易扩展和简化部署。按照上述步骤，您可以通过利用 Docker 的强大功能来增强 Spring Boot 应用程序。

可以看看这些：

• Spring Boot 文档
• 使用 Docker 部署 Spring Boot 应用程序的实用技巧

开心地打包成容器吧！