apache-varnish 镜像文档

镜像概述和主要用途

apache-varnish 是一个集成了 Apache Web 服务器、PHP 解释器和 Varnish 缓存的 Docker 镜像。该镜像旨在提供一个开箱即用的 Web 服务解决方案，通过 Varnish 缓存机制提升静态内容和动态页面的访问性能，适用于需要高效内容分发的 Web 应用场景。

核心功能和特性

• Apache Web 服务器：提供标准 HTTP 服务，支持虚拟主机配置
• PHP 支持：集成 PHP 运行环境，可直接运行 PHP 应用
• Varnish 缓存：内置 Varnish 缓存系统，优化内容交付性能
• 灵活配置：通过环境变量自定义 Apache 配置
• 可扩展性：支持自定义虚拟主机配置和入口点脚本

使用场景和适用范围

• 开发和测试 PHP Web 应用
• 部署需要缓存加速的中小型网站
• 构建需要快速响应的动态内容服务
• 作为前端代理服务器缓存静态资源

详细配置说明

环境变量

Apache 相关变量

Apache 配置生成机制

默认情况下，虚拟主机配置文件 FILE_CONF_VHOST 会在入口点 RUN_APACHE_VARNISH 执行时通过 generate-conf-vhost.sh 脚本生成。生成过程受以下环境变量控制：

• APACHE_OPTIONS: 控制 PATH_HTML 目录的 Options 指令
• APACHE_ALLOW_OVERRIDE: 控制 PATH_HTML 目录的 AllowOverride 指令

如果在执行 RUN_APACHE_VARNISH 前 FILE_CONF_VHOST 文件已存在且非空，则会跳过虚拟主机配置生成过程。

Varnish 配置

关于 Varnish 缓存的详细配置，请参考 docker-varnish 仓库 文档。

使用方法

获取代码

由于 rahti-scripts 是子模块，克隆仓库时建议使用：

git clone --recursive <repository-url>

更新代码时使用：

git pull --recurse-submodules

构建镜像

./docker-build.sh [-c]

参数说明：

• -c: 无缓存构建

运行容器

基本运行

./docker-run.sh

默认情况下，服务可通过 localhost:8080 访问。

手动运行示例

docker run -d -p 8080:80 \
  -e APACHE_OPTIONS="Indexes FollowSymLinks MultiViews" \
  -e APACHE_ALLOW_OVERRIDE="All" \
  -v $(pwd)/html:/var/www/html \
  --name apache-varnish <image-name>

Docker Compose 示例

version: '3'
services:
  apache-varnish:
    build:
      context: .
      args:
        - NO_CACHE=true
    ports:
      - "8080:80"
    environment:
      - APACHE_OPTIONS=Indexes FollowSymLinks
      - APACHE_ALLOW_OVERRIDE=All
    volumes:
      - ./html:/var/www/html
      - ./vhost.conf:/etc/apache2/sites-available/000-default.conf
    restart: always

自定义配置

对于复杂配置需求，可通过以下方式自定义：

1. 覆盖虚拟主机配置：在下游镜像中覆盖 FILE_CONF_VHOST 文件或通过挂载方式替换
2. 自定义入口点：在自定义入口点脚本中，可通过执行 $EXEC_APACHE_VARNISH 启动 apache+varnish 服务

调试容器

进入运行中的容器：

docker exec -it <container-name> bash

在 Rahti 上部署

初始化 OpenShift 资源

./rahti-init.sh

也可通过 Web 界面完成，具体模板和参数参见 rahti-params.sh 文件。

重建服务

./rahti-rebuild.sh

也可通过 Web 界面操作：导航到相应的 BuildConfig 并点击 "Start Build"。

删除 OpenShift 资源

./rahti-scrap.sh

Webhooks

模板会生成用于触发构建和重新部署的 WebHook。可通过以下命令查看 WebHook URL：

oc describe bc <ENVIRONMENT>-<APP_NAME> | grep -A 1 "Webhook"
oc describe bc -l "app=<APP_NAME>,environment=<ENVIRONMENT>"

或通过 OpenShift Web 控制台导航到相应的 BuildConfig 查看。