manageiq/httpd-init

container-httpd-init 镜像文档

镜像概述

container-httpd-init是一个容器镜像，主要用途是在systemd环境下运行httpd（Apache HTTP服务器），并支持外部认证机制。该镜像专为需要在systemd管理的系统中部署具有身份验证功能的Web服务场景设计。

核心功能与特性

• 运行httpd服务：提供标准的Apache HTTP服务器功能，支持静态资源服务、反向代理等Web服务能力
• 外部认证支持：集成外部认证机制，可与外部身份验证系统（如LDAP、OAuth等）对接
• systemd环境适配：优化适用于systemd管理的环境，确保服务在systemd下的正确运行和管理

使用场景与适用范围

• 需要在systemd作为初始化系统的环境中部署httpd服务的场景
• 要求Web服务具备外部认证能力的企业内部系统
• 需要集中身份验证管理的Web应用部署
• 基于systemd的容器化部署环境中需要httpd服务的场景

使用方法与配置说明

基本运行方式

使用以下命令启动容器：

bash
docker run -d --name httpd-init \
  --systemd=always \
  -p 80:80 \
  docker.xuanyuan.run/container-httpd-init

外部认证配置

外部认证配置需通过挂载认证配置文件实现，示例：

bash
docker run -d --name httpd-init \
  --systemd=always \
  -p 80:80 \
  -v /path/to/auth/config:/etc/httpd/conf.d/auth.conf \
  docker.xuanyuan.run/container-httpd-init

其中/path/to/auth/config为包含外部认证配置的本地文件，配置内容需符合httpd的认证模块要求（如mod_auth_ldap、mod_auth_oauth等）。

系统集成

在systemd环境中，可通过创建systemd服务单元文件实现容器的自动启动和管理，示例服务单元文件（/etc/systemd/system/httpd-init.service）：

ini
[Unit]
Description=container-httpd-init service
After=docker.service
Requires=docker.service

[Service]
Restart=always
ExecStart=/usr/bin/docker run --name httpd-init --systemd=always -p 80:80 container-httpd-init
ExecStop=/usr/bin/docker stop httpd-init
ExecStopPost=/usr/bin/docker rm httpd-init

[Install]
WantedBy=multi-user.target

启用并启动服务：

bash
systemctl enable httpd-init.service
systemctl start httpd-init.service