Apache HTTP Server 2.4 容器镜像文档

镜像概述与主要用途

概述

本容器镜像包含 Apache HTTP Server 2.4，适用于 OpenShift 平台及通用场景。用户可选择基于 RHEL、CentOS 或 Fedora 的镜像版本：

• RHEL 镜像：可通过 Red Hat Container Catalog 获取
• CentOS 镜像：托管于 Quay.io
• Fedora 镜像：可通过 Fedora Registry 获取

生成的镜像可使用 podman 或 docker 运行（所有 podman 命令可直接替换为 docker，参数保持一致）。

主要用途

提供运行 Apache HTTP Server 2.4 的平台，或用于构建基于 httpd 的应用程序。

核心功能与特性

• 模块化架构：支持通过编译模块扩展核心功能，涵盖服务端编程语言支持、认证方案等
• 虚拟主机：单 Apache 实例可托管多个网站
• Source-to-Image (S2I) 支持：兼容 OpenShift S2I 框架，可直接将应用源码构建为容器镜像
• 多平台兼容：提供 RHEL、CentOS、Fedora 多种基础镜像版本
• 灵活日志配置：默认日志输出至标准输出，支持通过环境变量切换至卷存储
• 非 root 用户运行：默认以 UID 1001 运行，增强安全性
• MPM 配置可调：支持通过环境变量切换多处理模块（MPM）

使用场景与适用范围

• OpenShift 平台部署：通过 S2I 快速构建并部署 httpd 应用
• Docker/Podman 环境：直接运行 httpd 服务或挂载静态文件目录
• 应用构建：作为基础镜像，通过 Dockerfile 构建自定义 httpd 应用
• 开发测试：快速搭建 httpd 服务环境，验证静态网站或应用配置

使用方法与配置说明

在 OpenShift 中使用

假设使用 rhel8/httpd-24 镜像（通过 OpenShift 中的 httpd:24 镜像流标签可用）。

构建示例应用

以 httpd-sample-app 为例：

bash
oc new-app httpd:24~[***]

访问应用

1. 获取 Pod 名称：

   bash
   oc get pods
   

2. 在 Pod 内访问应用：

   bash
   oc exec <pod名称> -- curl 127.0.0.1:8080
   

Source-to-Image (S2I) 框架与脚本

本镜像支持 OpenShift 的 S2I 构建策略，可将应用源码输入，通过构建镜像生成包含应用的新镜像。

核心 S2I 脚本

• /usr/libexec/s2i/assemble：负责将应用源码放置到镜像内正确目录，生成包含应用的新镜像
• /usr/libexec/s2i/run：作为最终镜像的默认启动命令，启动 httpd 服务

应用源码结构要求

应用源码需符合以下目录结构，以便 S2I 脚本正确处理：

• ./httpd-cfg：存放额外 Apache 配置文件（*.conf）
• ./httpd-pre-init：存放启动 httpd 前执行的 shell 脚本（*.sh）
• ./httpd-ssl：存放 SSL 证书（certs/ 子目录）和密钥（private/ 子目录）
• ./：应用源码根目录（如静态文件）

使用 Dockerfile 构建应用

相比 S2I，Dockerfile 提供更灵活的构建方式，适用于非 OpenShift 环境或需要自定义构建流程的场景。

步骤 1：拉取基础镜像

bash
docker pull rhel8/httpd-24

步骤 2：准备应用源码

克隆示例应用源码：

bash
git clone [***] app-src

步骤 3：编写 Dockerfile

提供两种构建方式，根据需求选择：

方式 1：自定义配置

手动复制应用文件并指定启动命令：

dockerfile
FROM registry.redhat.io/rhel8/httpd-24

# 添加应用源码
ADD app-src/index.html /var/www/html/index.html

# 使用标准命令启动服务
CMD run-httpd

方式 2：使用 S2I 脚本

复用 S2I 脚本自动处理应用部署：

dockerfile
FROM registry.redhat.io/rhel8/httpd-24

# 添加源码至 S2I 脚本预期目录，并设置权限（非 root 运行）
USER 0
ADD app-src/index.html /tmp/src/index.html
RUN chown -R 1001:0 /tmp/src
USER 1001

# 执行 S2I 装配脚本
RUN /usr/libexec/s2i/assemble

# 使用 S2I 启动脚本
CMD /usr/libexec/s2i/run

步骤 4：构建镜像

bash
docker build -t httpd-app .

步骤 5：运行应用

bash
docker run -d httpd-app

直接挂载目录运行

将主机目录挂载为容器卷，直接提供静态文件服务。

准备主机目录

示例主机目录结构（/wwwdata）：

bash
ls -lZ /wwwdata/html
-rw-r--r--. 1 1001 1001 54321 Jan 01 12:34 index.html
-rw-r--r--. 1 1001 1001  5678 Jan 01 12:34 page.html

启动容器

挂载 /wwwdata 至容器 /var/www 目录：

bash
docker run -d --name httpd -p 8080:8080 -v /wwwdata:/var/www:Z rhel8/httpd-24

• -p 8080:8080：映射容器 8080 端口至主机
• -v /wwwdata:/var/www:Z：挂载主机目录，:Z 调整 SELinux 标签

环境变量与卷配置

环境变量

通过 -e 参数设置，支持以下变量：

示例

• 日志输出至卷（需 root 运行）：

  bash
  docker run -d -u 0 -e HTTPD_LOG_TO_VOLUME=1 --name httpd -v /wwwlogs:/var/log/httpd24:Z rhel8/httpd-24
  

• 使用 event MPM：

  bash
  docker run -d -e HTTPD_MPM=event --name httpd rhel8/httpd-24
  

卷挂载点

通过 -v /host/path:/container/path 挂载，支持以下目录：

默认配置

默认 SSL 证书

• 生成机制：首次启动时自动生成唯一 SSL 密钥对（非持久化，容器重建后失效）
• 存储路径：
  • 证书：/etc/httpd/tls/localhost.crt
  • 密钥：/etc/httpd/tls/localhost.key
• 自定义证书：将证书放入应用源码 ./httpd-ssl/certs/，密钥放入 ./httpd-ssl/private/，S2I 脚本会自动应用

默认用户

• 运行用户：默认以 UID 1001 运行（非 root）
• 调整用户：通过 -u 参数指定 UID，例如：

  bash
  docker run -d -u 1234 rhel8/httpd-24
  

• 注意：挂载日志卷（/var/log/httpd24）时需以 root（UID 0）运行

故障排除

查看日志

默认日志输出至标准输出，通过以下命令查看：

bash
docker logs <容器名称或ID>

参见

• 镜像源码及 Dockerfile：[***]
  • CentOS 7：Dockerfile
  • RHEL 7：Dockerfile.rhel7
  • RHEL 8：Dockerfile.rhel8
  • Fedora：Dockerfile.fedora