lustefaniak/docker-gcp-java

docker-gcp-java

镜像概述

基于Alpine Linux构建的Docker镜像，使用GraalVM作为JVM，并嵌入了Stackdriver Debugger和Profiler的二进制文件及脚本。

下载地址：https://hub.docker.com/r/lustefaniak/docker-gcp-java

基础JVM镜像来源：https://github.com/lustefaniak/docker-graalvm%EF%BC%8C%E5%8F%91%E5%B8%83%E4%BA%8Ehttps://hub.docker.com/r/lustefaniak/docker-graalvm

本镜像基于https://github.com/GoogleCloudPlatform/openjdk-runtime/%E7%9A%84%E6%BA%90%E4%BB%A3%E7%A0%81%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%B9%B6%E8%BF%9B%E8%A1%8C%E4%BA%86%E9%A2%9D%E5%A4%96%E4%BF%AE%E6%94%B9%E3%80%82%E4%B8%BB%E8%A6%81%E5%8C%BA%E5%88%AB%E5%9C%A8%E4%BA%8E%E4%BD%BF%E7%94%A8GraalVM%E8%80%8C%E9%9D%9EOpenJDK%EF%BC%8C%E8%A7%A3%E5%86%B3%E4%BA%86GoogleCloudPlatform/openjdk-runtime%E5%9B%A0%E4%BD%BF%E7%94%A8Debian%E4%BD%9C%E4%B8%BAJVM%E6%BA%90%E5%AF%BC%E8%87%B4%E7%9A%84SSL%E5%AE%9E%E7%8E%B0%E5%92%8CALPN%E9%85%8D%E7%BD%AE%E9%97%AE%E9%A2%98%E3%80%82

核心功能与特性

• 基于Alpine Linux，提供轻量级基础环境
• 使用GraalVM作为JVM，替代Debian OpenJDK
• 集成Stackdriver Debugger和Profiler工具
• 解决Debian OpenJDK的SSL实现和ALPN配置问题
• 支持OOM（内存溢出）时的堆转储生成及自动上传至GCS

使用场景

适用于在Google Cloud Platform (GCP)环境中运行Java应用，需要进行应用调试、性能分析以及处理SSL/ALPN相关需求的场景。

使用方法与配置说明

基本配置

为使应用在UI中被正确识别，需设置以下环境变量：

dockerfile
ENV GCP_APP_NAME "app-name"
ENV GCP_APP_VERSION "1.0.0"

调试器与分析器启用

默认情况下，调试器（Debugger）和分析器（Profiler）均处于禁用状态。如需激活，可在继承的Dockerfile中设置环境变量：

dockerfile
ENV PROFILER_ENABLE true
ENV DBG_ENABLE true

或在运行容器时通过-e参数指定：

bash
docker run -e PROFILER_ENABLE=true -e DBG_ENABLE=true [其他参数] lustefaniak/docker-gcp-java

OOM时的堆转储配置

默认情况下，JVM在发生OOM时会退出。可通过以下环境变量控制此行为：

• JAVA_EXIT_ON_OOM=false：设置为false时，JVM在OOM时不会退出
• JAVA_HEAP_DUMP_ON_OOM=true：设置为true时，将在OOM时生成堆转储文件，默认存储路径为/var/log/app_engine/heapdump/（可通过JAVA_HEAP_DUMP_PATH自定义路径）

堆转储自动上传至GCS

如需将生成的堆转储自动上传至Google Cloud Storage (GCS)，需配置以下环境变量：

dockerfile
ENV UPLOAD_HEAP_DUMP true
ENV GCS_HEAP_DUMP_PROJECT_ID "project_id"  # GCP项目ID
ENV GCS_HEAP_DUMP_BUCKET "gcs_bucket_name"  # GCS存储桶名称
ENV GCS_HEAP_DUMP_PATH ""  # 存储桶内路径（可选，留空则直接存储在桶根目录）

注意：上传器需要进行身份验证，详情请参见https://developers.google.com/accounts/docs/application-default-credentials%E3%80%82