adamcin/jvshim

jvshim

镜像概述

jvshim是Java 8/9版本$JAVA_HOME/bin/java命令的包装工具，专为Docker容器环境设计，旨在解决JVM设置与cgroup内存限制不兼容的问题。它通过重写JVM内存参数，确保应用在容器内存限制下稳定运行。

核心功能

1. 内存参数重写：自动调整-Xmx、-Xms等堆内存参数，确保MaxHeapSize + MaxMetaspaceSize不超过cgroup内存限制。
2. Metaspace优化：保证MaxMetaspaceSize不低于64MB，且MetaspaceSize不超过MaxMetaspaceSize。
3. PATH拦截：可加入系统PATH以拦截java命令调用，无缝替换原生java执行逻辑。

使用场景

适用于Docker容器中运行Java应用的场景，尤其是需要严格遵循容器内存限制（如Kubernetes资源配置）时，解决原生JVM参数在cgroup环境下的不足。

配置说明

将jvshim添加到容器的PATH环境变量中，使其优先于原生java命令。例如：

bash
# 在Dockerfile中设置
ENV PATH="/path/to/jvshim:$PATH"

部署示例

Docker Run示例

bash
docker run --memory=1g docker.xuanyuan.run/adamcin/jvshim java -jar your-app.jar

Docker Compose示例

yaml
version: '3'
services:
  app:
    image: your-java-app
    volumes:
      - ./jvshim:/usr/local/bin/jvshim
    environment:
      - PATH="/usr/local/bin:$PATH"
    deploy:
      resources:
        limits:
          memory: 1g
    command: ["jvshim", "-jar", "app.jar"]