Java 应用 Docker 容器化
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/pluginagentmarketplace-custom-plugin-java-java-docker。
技能介绍
要解决什么问题
把 Spring Boot 或传统 Java 服务打进镜像时,常见问题不是「能跑起来」而已:镜像动辄几百 MB、分层缓存失效导致 CI 每次都从头拉依赖、容器里 JVM 仍按宿主机内存算堆大小最后被 OOMKilled,以及生产镜像仍以 root 运行。这些多半来自 Dockerfile 写法与 JVM 默认行为不匹配容器 cgroup 限制。
技能如何帮你动手
本技能按 Docker 与 JVM 两条线组织参考内容。
Dockerfile 与镜像
- 多阶段构建:编译阶段与运行阶段分离,运行镜像只保留 JRE 与产物
- 分层缓存:依赖层与源码层拆开,减少无关改动触发的全量重建
- Spring Boot layered JAR:按依赖、快照依赖、自有代码分层,配合
COPY --from优化缓存
JVM 容器参数
- 启用
UseContainerSupport,用MaxRAMPercentage等让堆上限跟 cgroup memory limit 对齐,避免堆大于 limit - 结合场景选择 GC,并配置 Exit on OOM,便于编排器重启而不是僵死进程
安全与运维
- 非 root 用户、只读根文件系统、密钥不落镜像层等实践
- 基础镜像对照(如
temurin:21-jre、temurin:21-jre-alpine、distroless/java21)与体积/安全取舍 - 健康检查与常见故障对照(OOMKilled、启动慢、权限错误、旧 JVM 无容器内存感知)
适用边界
内容面向 容器化打包与运行调优,不写 Maven/Gradle 构建细节(可与 java-maven-gradle 衔接),也不覆盖 K8s 部署拓扑(可与 java-microservices 衔接)。Alpine/musl 与部分 JNI 原生库的兼容性需自行验证;distroless 调试手段更少,排障前要选好基础镜像策略。
使用场景
- CI 里 Java 服务每次构建都重新下载依赖,需要把 Dockerfile 分层改成依赖与源码分离
- 生产 Pod 频繁 OOMKilled,要在镜像里用 MaxRAMPercentage 对齐 K8s memory limit
- Spring Boot 可执行 JAR 镜像超过 300MB,要用多阶段构建和 layered JAR 压到 JRE-only 运行层
- 上线前安全扫描要求非 root 运行,要改 Dockerfile 用户与只读文件系统配置
适合人员
- 负责 Java 微服务镜像的 DevOps,要把 temurin 与 distroless 选型及分层缓存写进团队模板
- 后端开发自学打镜像,应用能跑但容器内堆超限被杀,要对照 OOM 排障表改 JVM 参数
- 平台工程师制定公司 Java 基础镜像规范,需要非 root、漏洞扫描与密钥处理的清单化实践
- 从虚拟机迁到容器的遗留 Java 应用维护者,要解决 Permission denied 与启动慢等多阶段构建问题