如何配置Docker ENTRYPOINT在Java进程结束后touch文件通知sidecar容器

你提出的「将Java启动逻辑和退出标记文件创建逻辑整合为独立启动脚本作为ENTRYPOINT、通过同Pod共享文件通知sidecar退出」的方案，是当前场景下最稳定的实现路径。
对比之前尝试的方案：

• preStop生命周期钩子仅在Pod被集群主动删除、调度驱逐时触发，主容器自身执行完定时任务主动退出的场景下根本不会触发该钩子，自然达不到预期效果
• 常见的sidecar联动工具是为了等待所有附属容器退出后，主容器再正常终止，和当前「主容器先完成定时任务退出、反向通知sidecar收尾」的流程不匹配
  方案能稳定运行的核心前提：两个容器必须挂载同一块emptyDir存储卷到统一的路径，确保主容器写入的标记文件sidecar可以实时检测到。

直接在原有Dockerfile的ENTRYPOINT后追加命令是无法实现「Java进程退出后自动touch done文件」的，核心原因是原有ENTRYPOINT用了exec java启动进程，会直接替换当前shell进程，后续命令根本不会执行。正确的改造需要通过独立启动脚本承接启动逻辑+信号捕获：

1. 编写容器启动脚本entrypoint.sh #

脚本需要放在应用运行目录下，逻辑如下：

#!/bin/sh
# 定义done文件的固定路径，和sidecar的检测路径保持一致
DONE_FILE="/opt/example/apps/sync/container/done"

# 提前创建目录，避免touch时报错（目录实际来自共享emptyDir卷）
mkdir -p "$(dirname "$DONE_FILE")"

# 注册全局退出trap：无论脚本因为正常退出、异常报错、被信号终止的任何原因退出，都会触发touch操作
trap 'echo "Java process finished, marking task completion" && touch "$DONE_FILE"' EXIT

# 启动Java进程，*不要加exec*，让Java作为shell的子进程运行，shell会持续等待Java进程执行完成
# 等Java进程完全结束后，才会走到trap触发的逻辑
java $JAVA_OPTS -Djava.security.egd=file:/dev/./urandom -jar /opt/example/apps/sync/app.jar

2. 修改原有Dockerfile #

调整后的Dockerfile逻辑：

FROM mcr.microsoft.com/java/jre:11-zulu-alpine
ARG projectVersion
WORKDIR /opt/example/apps/sync
# 拷贝应用jar包
COPY /target/sync-app-${projectVersion}.jar app.jar
# 拷贝启动脚本
COPY entrypoint.sh /opt/example/apps/sync/entrypoint.sh
# 给脚本加可执行权限
RUN chmod +x /opt/example/apps/sync/entrypoint.sh
# 替换ENTRYPOINT为启动脚本
ENTRYPOINT ["/opt/example/apps/sync/entrypoint.sh"]

关键注意点 #

• 绝对不要在脚本里用exec java启动进程：exec会直接把当前shell进程替换为Java进程，shell不存在了，注册的EXIT trap就完全失效，Java进程退出时不会触发touch done文件的操作
• trap要写在脚本最开头，不要等启动Java之前才注册，避免Java启动阶段直接崩溃时trap未生效，导致done文件永远无法生成

原有sidecar配置存在明显逻辑问题：既没有正确启动Logstash采集进程，还错误引入了和Logstash无关的无关启动逻辑。正确的sidecar容器命令逻辑为：

1. 把Logstash采集进程放到后台启动，确保日志正常采集发送
2. 循环检测共享卷里的done文件
3. 检测到done文件后，先等Logstash把内存中缓存的未发送日志全部刷出，再主动退出
   调整后的容器配置：

- args:
  - |
    # 后台启动Logstash进程（替换为你实际的Logstash启动命令）
    /usr/local/bin/logstash -f /etc/logstash/logstash.conf &
    LOGSTASH_PID=$!

    # 循环检测done文件
    while ! test -f /opt/example/apps/sync/container/done; do
      echo "Waiting for sync-app to finish..."
      sleep 5
    done

    echo "sync-app finished, waiting for Logstash to flush remaining logs..."
    # 给Logstash发优雅终止信号，等它把缓存日志发完
    kill -TERM $LOGSTASH_PID
    wait $LOGSTASH_PID
    echo "Logstash exited gracefully, sidecar closing"
    exit 0
  command:
  - /bin/sh
  - -c

配套Pod卷配置 #

两个容器必须挂载同一个emptyDir卷，确保文件跨容器可见：

volumes:
- name: shared-signal
  emptyDir: {}
containers:
# 主Java容器的卷挂载配置
- volumeMounts:
  - name: shared-signal
    mountPath: /opt/example/apps/sync/container
# Logstash sidecar的卷挂载配置
- volumeMounts:
  - name: shared-signal
    mountPath: /opt/example/apps/sync/container

• 不要把done文件存在容器本地磁盘，必须放在共享卷路径下，否则sidecar永远检测不到主容器生成的标记文件
• 循环检测的sleep间隔设为5s即可，不要设置过短导致CPU资源浪费
• sidecar检测到done文件后不要直接退出，必须等待Logstash把未发送的日志全部推送完成，避免日志丢失
• 主容器启动脚本里要保留对Java启动参数的传递，不要硬编码配置

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