tyerraguntla/basic_spring_boot_app Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

基础Spring Boot应用Docker镜像文档

镜像概述

本镜像为基于Spring Boot框架开发的Java应用程序提供基础运行环境，基于官方Java运行时镜像构建，包含Spring Boot应用运行所需的基础依赖和默认配置。旨在简化Spring Boot应用的部署流程，提供标准化、可移植的运行环境，适用于开发、测试及小型生产环境。

核心功能与特性

• 标准化运行环境：基于官方OpenJDK镜像构建，确保Java运行时环境的稳定性和兼容性
• 简化部署流程：内置Spring Boot应用启动脚本，支持一键启动应用
• 灵活配置支持：支持通过环境变量、外部配置文件自定义应用参数
• 轻量级设计：采用精简基础镜像，减少镜像体积，提升部署效率
• 可扩展性：支持与其他服务（如数据库、缓存）通过网络连接集成

使用场景

• 开发/测试环境中Spring Boot应用的快速部署与验证
• 小型生产环境中基础Spring Boot应用的独立运行
• 学习和演示Spring Boot应用容器化部署流程
• 作为自定义Spring Boot应用镜像的基础模板

使用方法

基本运行（Docker Run）

通过以下命令快速启动容器，默认暴露应用端口8080：

bash
docker run -d -p 8080:8080 --name basic-spring-app [镜像名称]:[标签]

参数说明：

• -p 8080:8080：将容器内8080端口映射到主机8080端口（需与应用配置的server.port一致）
• --name basic-spring-app：指定容器名称
• [镜像名称]:[标签]：替换为实际的镜像名称和版本标签

自定义配置运行

1. 指定Spring配置文件

通过环境变量SPRING_PROFILES_ACTIVE指定激活的配置文件（如dev、test、prod）：

bash
docker run -d -p 8080:8080 \
  -e SPRING_PROFILES_ACTIVE=prod \
  --name basic-spring-app [镜像名称]:[标签]

2. 挂载外部配置文件

将本地配置文件（如application.yml）挂载到容器内Spring Boot配置目录：

bash
docker run -d -p 8080:8080 \
  -v /本地路径/application.yml:/app/config/application.yml \
  --name basic-spring-app [镜像名称]:[标签]

Docker Compose 部署

创建docker-compose.yml文件，配置如下：

yaml
version: '3'
services:
  spring-app:
    image: [镜像名称]:[标签]
    container_name: basic-spring-app
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=dev
      - SERVER_PORT=8080
    volumes:
      - ./config:/app/config  # 挂载本地配置目录
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

配置说明

环境变量

配置文件挂载

应用默认配置文件路径为容器内/app/config目录，支持挂载外部配置文件（如application.yml、application-dev.yml等）覆盖默认配置。

日志输出

应用日志默认输出至标准输出（STDOUT），可通过docker logs [容器名称]命令查看：

bash
docker logs -f basic-spring-app

注意事项

1. 确保宿主机端口（如8080）未被占用，或修改端口映射参数避免冲突
2. 生产环境中建议通过环境变量或挂载配置文件注入敏感信息（如数据库密码），避免硬编码
3. 镜像基于特定Java版本构建，需确保应用兼容对应Java版本（可通过镜像标签确认，如jdk17、jdk11）
4. 如需扩展功能（如添加监控、日志收集），可基于本镜像构建自定义镜像或通过容器网络集成外部服务