Docker容器中Shell脚本无法启动Java进程的问题求助

问题背景 #

使用Ubuntu 24.04 Docker镜像构建容器，通过Shell脚本启动Java代理进程，计划部署到Kubernetes。镜像构建正常，但Dockerfile中的CMD指令无法自动启动代理，必须手动进入容器执行脚本才能启动进程。

现有Dockerfile内容 #

FROM ubuntu:24.04

# Set environment variable
RUN apt-get update && \
    apt-get install -y unzip && \
    apt-get install -y tar && \
    rm -rf /var/lib/apt/lists/*

# Copy the Java tar file into the container
COPY jre-8u391-linux-aarch64.tar.gz /tmp/
COPY no-java.zip /tmp
ADD agent.config.properties /tmp/
RUN unzip /tmp/no-java.zip 

# Extract Java tar file
WORKDIR /no-java

RUN chmod +x install

RUN ./install -e -i /opt/agent -s http://localhost -p 8080 -l -q
RUN tar -xvf /tmp/jre-8u391-linux-aarch64.tar.gz -C /opt/java-agent/agent/bin/java
RUN mv /tmp/agent.config.properties /opt/java-agent/agent/bin/conf/
RUN rm -rf /tmp/no-java && rm -rf /no-java

CMD ["sh", "/opt/java-agent/agent/bin/run_agent.sh"]

已尝试过的CMD写法：

CMD ["/bin/sh","-c", "/opt/java-agent/agent/bin/run_agent.sh"]

排查与解决步骤 #

1. 确保脚本具备执行权限 #

在Dockerfile中添加命令，给启动脚本赋予可执行权限：

RUN chmod +x /opt/java-agent/agent/bin/run_agent.sh

2. 避免脚本后台运行导致容器退出 #

如果run_agent.sh中启动Java进程时使用了&让进程后台运行，容器会因为脚本执行完成而直接退出。解决方法：

• 修改run_agent.sh，去掉后台运行参数，让Java进程前台执行；
• 或者在CMD中使用exec让Java进程成为容器的PID 1：

  CMD ["/bin/sh", "-c", "exec /opt/java-agent/agent/bin/run_agent.sh"]
  

3. 查看容器启动日志定位错误 #

启动容器后查看日志，获取脚本执行失败的具体原因：

docker run --name temp-agent agent
docker logs temp-agent

日志可能会暴露路径错误、依赖缺失、配置文件读取失败等问题。

4. 检查安装路径是否匹配 #

Dockerfile中install命令指定的安装路径是/opt/agent，但后续解压JRE到/opt/java-agent/agent/bin/java，路径不匹配可能导致脚本找不到Java环境。需要确认install命令的实际输出路径，调整JRE解压路径到对应目录，比如：

RUN tar -xvf /tmp/jre-8u391-linux-aarch64.tar.gz -C /opt/agent/bin/java

5. 简化CMD写法（需脚本有shebang） #

如果run_agent.sh开头有#!/bin/sh或#!/bin/bash的shebang行，且已赋予执行权限，可直接用：

CMD ["/opt/java-agent/agent/bin/run_agent.sh"]

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