使用 Dockerfile 构建 Tomcat 镜像

以下是关于如何使用 Dockerfile 构建 Tomcat 镜像并解决容器启动时自动启动 Tomcat 服务的详细教程和总结：

---

1. 问题描述

通过 Dockerfile 构建了一个 Tomcat 镜像，但运行容器时发现 Tomcat 服务并未自动启动，必须手动进入容器启动服务。这显然不够方便，尤其是在生产环境中。接下来将展示如何优化 Dockerfile，使得容器启动时，Tomcat 自动运行。

---

2. 创建 Tomcat 镜像的基础步骤

1. 准备工作

确保你有下面的文件：

• Apache Tomcat 压缩包（例如：apache-tomcat-8.0.26.tar.gz）。
• JDK 安装包（例如：jdk-8u45-linux-x64.rpm）。

将这些文件与 Dockerfile 放置在同一目录中，方便后续使用。

---

2. 编写基础 Dockerfile

以下是一个基础版本的 Dockerfile，它通过解压 Tomcat 和安装 JDK 创建镜像：

# 使用 CentOS 作为基础镜像
FROM centos:7
 
# 维护者信息
LABEL maintainer="cntf@example.com"
 
# 安装 wget
RUN yum install -y wget
 
# 添加 JDK 的 rpm 包到镜像中并安装
ADD jdk-8u45-linux-x64.rpm /usr/local/
RUN rpm -ivh /usr/local/jdk-8u45-linux-x64.rpm
 
# 解压 Apache Tomcat 包到指定目录
ADD apache-tomcat-8.0.26.tar.gz /usr/local/
RUN mv /usr/local/apache-tomcat-8.0.26 /usr/local/tomcat8
 
# 声明容器对外开放的端口
EXPOSE 8080
 
# 默认命令（需要优化以启动 Tomcat）
CMD ["/bin/bash"]

说明：

1. FROM： 指定基础镜像为 CentOS 7。
2. LABEL： 添加镜像的元数据，记录维护者信息。
3. ADD： 将 JDK 和 Tomcat 压缩包添加到镜像，并解压。
4. RUN： 安装 JDK 和重命名 Tomcat 解压后的目录。
5. EXPOSE： 声明容器的 8080 端口。

---

3. 构建镜像

使用以下命令构建镜像：

docker build -t tomcat8:v1 .

---

4. 运行容器并手动启动 Tomcat

1. 启动容器：

   docker run -d -p 8080:8080 --name tomcat8 tomcat8:v1

2. 进入容器：

   docker exec -it tomcat8 /bin/bash

3. 手动启动 Tomcat：

   /usr/local/tomcat8/bin/startup.sh

4. 在浏览器中访问：

   http://<宿主机IP>:8080

---

3. 优化 Dockerfile：自动启动 Tomcat

为了解决需要手动启动 Tomcat 的问题，可以优化 Dockerfile，使得容器启动时，Tomcat 服务自动运行。这需要修改 Dockerfile 的 CMD 或 ENTRYPOINT 指令。

以下是优化后的 Dockerfile：

# 使用 Ubuntu 基础镜像
FROM ubuntu:22.04
 
# 设置非交互模式
ENV DEBIAN_FRONTEND=noninteractive
 
# 更新系统并安装必要工具
RUN apt-get update && apt-get install -y \
    openjdk-8-jdk \
    wget \
    && rm -rf /var/lib/apt/lists/*
 
# 设置 JAVA_HOME 环境变量
ENV JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64
ENV PATH=$JAVA_HOME/bin:$PATH
 
# 下载并安装指定版本的 Tomcat
RUN wget https://downloads.apache.org/tomcat/tomcat-9/v9.0.99/bin/apache-tomcat-9.0.99.tar.gz -O /tmp/tomcat.tar.gz && \
    mkdir -p /usr/local/tomcat && \
    tar -xzf /tmp/tomcat.tar.gz -C /usr/local/tomcat --strip-components=1 && \
    rm -rf /tmp/tomcat.tar.gz
 
# 声明容器对外暴露的端口
EXPOSE 8080
 
# 启动 Tomcat
CMD ["/usr/local/tomcat/bin/catalina.sh", "run"]

优化点说明：

1. ENV： 配置 Java 和 Tomcat 的环境变量，确保运行时可以正常找到 JDK 和 Tomcat 的目录。
2. CMD： 将 Tomcat 的启动命令设置为 catalina.sh run，确保容器启动时 Tomcat 服务立即运行并在前台运行。

---

4. 构建和验证

1. 构建镜像

docker build -t ubuntu-tomcat1 .

2. 启动容器

docker run -d -p 8080:8080 --name tomcat1-container ubuntu-tomcat1

3. 验证运行状态

1. 查看容器是否正常运行：

   docker ps

   如果看到 STATUS 为 Up，说明容器已经启动。

2. 在浏览器中访问：

   http://<宿主机IP>:8080

   如果能看到 Tomcat 默认首页，则表示 Tomcat 服务已经自动启动。

---

验证测试过程

---

5. 常见问题

1. 容器启动后立即退出

• 原因： Tomcat 未在前台运行，导致容器退出。
• 解决： 使用 CMD ["/usr/local/tomcat9/bin/catalina.sh", "run"]，让 Tomcat 在前台运行。

2. 端口冲突

• 原因： 容器的 8080 端口与宿主机已有服务冲突。
• 解决： 修改端口映射，例如：

  docker run -d -p 9090:8080 --name tomcat8 tomcat8:v2

3. 缺少必要依赖

• 原因： 基础镜像未安装所需的依赖。
• 解决： 在 Dockerfile 中添加缺失依赖的安装命令，例如 yum install -y unzip。

---

6. 总结

通过本教程，我们完成了以下内容：

1. 使用 Dockerfile 构建了一个 Tomcat 镜像。
2. 解决了容器启动时 Tomcat 服务未自动启动的问题。
3. 学习了关键指令（FROM、ADD、RUN、ENV、CMD 等）的使用方法。

优化后的 Dockerfile 可以直接用于生产环境，确保容器启动时服务自动运行。如果你还有其他问题，欢迎随时提问！