eeacms/reportek-varnish

reportek Varnish镜像

镜像概述和主要用途

reportek Varnish镜像是基于Varnish的缓存服务镜像，专为reportek应用设计，提供高效的HTTP缓存能力，支持灵活的配置自定义和容器生命周期管理，适用于提升reportek应用的响应速度和稳定性。

前提条件

• 安装Docker
• 安装Docker Compose

安装

获取源代码

bash
$ git clone https://github.com/eea/eea.docker.varnish-reportek
$ cd eea.docker.varnish-reportek

本地构建并运行镜像

bash
$ docker build -t varnish:local .
$ docker run varnish:local

核心功能和特性

1. 缓存服务：提供Varnish基础缓存功能，支持自定义缓存大小和端口配置
2. 灵活配置：通过环境变量自定义default.vcl配置，满足个性化缓存需求
3. 定时重建：支持通过AUTOKILL_CRON设置UTC时间的crontab规则，定时重建容器
4. 动态后端解析：可配置后端服务地址及DNS检查频率，适应动态服务环境

环境变量配置

官方Varnish镜像变量

• VARNISH_HTTP_PORT - Varnish HTTP端口
• VARNISH_HTTPS_PORT - Varnish HTTPS端口
• VARNISH_SIZE - Varnish缓存大小

eeacms/varnish镜像变量

• AUTOKILL_CRON - Varnish重建crontab，强制重建容器。使用UTC时间，格式为Linux crontab（例如0 2 * * *表示每天UTC时间02:00）
• VARNISH_CFG_CONTENT - 多行变量，内容将写入default.vcl文件

varnish.vcl专用变量

• VARNISH_BACKEND - 后端主机名/Rancher服务名
• VARNISH_BACKEND_PORT - 服务内部端口
• VARNISH_DNS_TTL - Varnish检查后端主机名/服务IP的频率
• VARNISH_BERESP_TTL、VARNISH_BERESP_GRACE、VARNISH_BERESP_KEEP - 对象生命周期配置（参考：[***]

如何在varnish.vcl中添加新变量

1. 选择以VARNISH_为前缀的变量名，例如VARNISH_EXAMPLE

2. 在Dockerfile中添加默认值

   dockerfile
   ENV VARNISH_EXAMPLE="GET"
   

3. 在varnish.vcl中用<>包含变量

   vcl
   set req.http.X-Varnish-Routed = "<VARNISH_EXAMPLE>";
   

使用场景和适用范围

适用于需要为reportek应用部署Varnish缓存层的场景，尤其适合需要动态调整缓存策略、定时更新容器配置或在容器化环境（如Rancher）中使用的场景，可有效减轻后端服务负载，提升用户访问速度。