如何在Docker中用GraalVM Native Image覆盖Micronaut配置？

问题 #

我尝试在Docker容器中以GraalVM Native Image方式运行Micronaut应用。此前使用fat jar方式时，我可以通过环境变量JAVA_TOOL_OPTIONS覆盖application.yml中的配置字段（如下方Docker Compose配置所示）：

version: "3.9"
services:
  temposec:
    image: ghcr.io/onstructive/tempo-security/tempo-security:0.2.25-native
    environment:
      JAVA_TOOL_OPTIONS: "\
        -Dmicronaut.http.services.temposec.url=http://host.docker.internal:8090 \
        -Dlog.level.ch.onstructive=DEBUG \
        -Dmicronaut.caches.tempo-cache.maximumSize=0 \
        -Dmicronaut.caches.decision-cache.maximumSize=0 \
        -Dmicronaut.caches.attribute-cache.maximumSize=0 \
        -Dmicronaut.http.services.temposec.read-timeout=1s
        "
    ports:
      - "127.0.0.1:6000:8080"
      - "127.0.0.1:6001:8090"

我推测Native Image不会识别JAVA_TOOL_OPTIONS环境变量，因此想了解如何在GraalVM Native Image中实现相同的配置覆盖效果：是需要为每个配置字段单独声明应用环境变量，还是有更优雅的方式？

解决方案 #

GraalVM Native Image是编译后的原生二进制程序，确实不支持JAVA_TOOL_OPTIONS这类JVM专属的环境变量。不过Micronaut提供了两种原生友好的配置覆盖方式：

1. 单独声明环境变量 #

Micronaut支持将配置键转换为大写字母+下划线分隔的环境变量格式，直接映射配置项：

• 原配置键micronaut.http.services.temposec.url对应环境变量MICRONAUT_HTTP_SERVICES_TEMPOSEC_URL
• 原配置键log.level.ch.onstructive对应环境变量LOG_LEVEL_CH_ONSTRUCTIVE

修改后的Docker Compose示例：

version: "3.9"
services:
  temposec:
    image: ghcr.io/onstructive/tempo-security/tempo-security:0.2.25-native
    environment:
      MICRONAUT_HTTP_SERVICES_TEMPOSEC_URL: "http://host.docker.internal:8090"
      LOG_LEVEL_CH_ONSTRUCTIVE: "DEBUG"
      MICRONAUT_CACHES_TEMPO-CACHE_MAXIMUMSIZE: "0"
      MICRONAUT_CACHES_DECISION-CACHE_MAXIMUMSIZE: "0"
      MICRONAUT_CACHES_ATTRIBUTE-CACHE_MAXIMUMSIZE: "0"
      MICRONAUT_HTTP_SERVICES_TEMPOSEC_READ-TIMEOUT: "1s"
    ports:
      - "127.0.0.1:6000:8080"
      - "127.0.0.1:6001:8090"

2. 批量传递配置（更优雅的方式） #

使用Micronaut的MICRONAUT_CONFIG_PROPERTIES环境变量，一次性传递多个配置项，格式为键=值，多个项用逗号或换行分隔：

修改后的Docker Compose示例：

version: "3.9"
services:
  temposec:
    image: ghcr.io/onstructive/tempo-security/tempo-security:0.2.25-native
    environment:
      MICRONAUT_CONFIG_PROPERTIES: "\
        micronaut.http.services.temposec.url=http://host.docker.internal:8090,\
        log.level.ch.onstructive=DEBUG,\
        micronaut.caches.tempo-cache.maximumSize=0,\
        micronaut.caches.decision-cache.maximumSize=0,\
        micronaut.caches.attribute-cache.maximumSize=0,\
        micronaut.http.services.temposec.read-timeout=1s\
      "
    ports:
      - "127.0.0.1:6000:8080"
      - "127.0.0.1:6001:8090"

这种方式和你之前用JAVA_TOOL_OPTIONS的写法逻辑一致，更简洁且原生镜像完全支持，因为它是Micronaut自身的配置解析机制，不依赖JVM参数。

内容的提问来源于stack exchange，提问作者saw303