一起学docker系列之十四Dockerfile微服务实践

1 前言

微服务架构已经成为现代软件开发中的一种重要方式。而 Docker 提供了一种轻量级、便携式的容器化解决方案，能够简化微服务的部署和管理。本文将介绍如何将一个基本的微服务部署到 Docker 容器中。

2 创建微服务模块

2.1 创建项目模块

• 使用 IntelliJ IDEA 或类似 IDE 创建一个新的项目模块。
  启动 ID，在主界面或菜单中选择创建新项目或模块的选项。选择适合的项目类型，比如 Spring Boot等，根据你的需求来选择合适的项目模板。配置项目信息，输入项目名称、项目路径等基本信息。确保选择了适当的构建工具和语言（通常是 Maven 和 Java）。
• 配置 Maven 的 POM 文件以管理项目依赖和构建设置。
  打开项目结构，打开创建的项目，找到 Maven 的 pom.xml 文件。添加依赖，在 pom.xml 中添加所需的依赖项，如数据库驱动、Web 框架、日志等。确保依赖项的版本与项目需求匹配，并遵循最佳实践。配置构建设置，配置 Maven 插件、打包方式、资源文件路径等。设置项目属性，如编译版本、编码等。
• 编写 YAML 文件，定义微服务的配置信息，比如端口号、数据库连接等。
  创建 YAML 文件，命名为 application.yml 或类似的文件。定义配置信息，编写 YAML 格式的配置文件，包括但不限于端口号、数据库连接、日志设置等。使用合适的属性和格式来定义微服务的配置，确保易读性和易维护性。

2.2 编写业务代码

• 编写主启动类和业务类，确保微服务功能正确。
  编写主启动类。创建一个类作为微服务的入口点（通常是包含 @SpringBootApplication 或类似注解的类）。配置相关注解和组件扫描，确保应用能够正确启动。编写业务类。创建业务逻辑类，实现所需的业务功能。遵循面向对象设计原则，保持代码清晰、模块化，并进行必要的单元测试。
• 使用 Maven 构建项目并生成 JAR 文件。执行构建命令。
  在命令行中，进入项目根目录。运行 Maven 构建命令，例如 mvn clean package。确保构建成功，检查控制台输出和生成的 JAR 文件是否符合预期。查找生成的 JAR 文件。在 Maven 构建成功后，通常会在 target 目录下生成 JAR 文件。确认生成的 JAR 文件包含了所有必需的依赖项和资源。

3 编写 Dockerfile

一个 Dockerfile 包含一系列指令，用于构建 Docker 镜像。

• Dockerfile 是用于构建 Docker 镜像的脚本。你已经列出了一个基本的 Dockerfile 示例。
• 使用基础镜像（如 java:8），并指定维护者信息、容器内部路径等。
• 使用 ADD 命令将本地的 JAR 文件添加到 Docker 容器中，并指定名称。
• 使用 RUN 命令执行一些初始化操作，如创建文件、设置权限等。
• 使用 ENTRYPOINT 或 CMD 指令指定容器启动时执行的命令。

# 使用基础镜像 Java 8
FROM java:8

# 设置维护者信息
MAINTAINER YourName

# 在容器中创建临时目录并指定为工作目录
WORKDIR /app

# 将本地的 JAR 文件添加到容器中
COPY target/your_microservice.jar /app/your_microservice.jar

# 指定容器启动时执行的命令
ENTRYPOINT ["java","-jar","your_microservice.jar"]

# 暴露微服务的端口
EXPOSE 8080

4 构建 Docker 镜像

使用 docker build 命令根据 Dockerfile 构建 Docker 镜像。

docker build -t your_microservice_image:1.0 .

5 运行 Docker 容器

使用以下命令在 Docker 中运行刚刚构建的镜像。

docker run -p 8080:8080 --name your_microservice_container your_microservice_image:1.0

6 测试微服务

最后，通过 curl 命令或任何 HTTP 请求工具测试你的微服务：

curl http://localhost:8080/api/endpoint

7 总结

构建 Docker 镜像和运行容器时需要注意端口映射和文件路径的正确性。另外，确保 Docker 容器内部的文件路径和命令与你的项目设置一致。通过以上步骤，你已经成功地将一个基本的微服务部署到了 Docker 容器中。这个微服务现在可以在容器环境中运行，并且可以通过主机的端口进行访问和测试。

8 参考地址

https://docs.docker.com/engine/reference/builder