Public | Automated Build

Last pushed: a year ago
Short Description
DEPRECATED: use muchlearning/kubernetes-varnish2 instead
Full Description

Dynamic Varnish for Kubernetes

by MuchLearning

Updates Varnish config based on Kubernetes configuration changes. Intended for use with


This pod watches Kubernetes (or more specifically, the etcd2 used by Kubernetes) for configuration changes (creates, deletes). When a change is detected, the configuration is updated, and Varnish is gracefully reloaded if needed. It uses etcd2's watch feature rather than polling, so updates should be near-instantaneous.


Environment variables

  • ETCD2BASE: (required) the base URL for the etcd2 server (with no trailing slash). The URL must be an HTTP URL; HTTPS is not (yet) supported. Defaults to (which will probably not work).


The HAProxy configuration is driven by some Kubernetes configmaps and secrets in the lb namespace. The pod watches these and updates the configuration when they change.

  • services configmap: each key defines a service to be exposed. The value is a JSON object as defined in, but with the following additional keys used by the example template
    • varnish: an object with the following keys:
      • recv, backend_fetch, backend_response, deliver: (optional) VCL to execute in the vcl_* subroutines when a request is made for the service
  • config configmap: the varnishtemplate key in this configmap defines a Jinja2 template to use to generate the Varnish VCL file. The template is passed these replacements:
    • services: a list of services, each of which is a dict corresponding to the values given in the services configmap above. The list is sorted in the order of the service name (the keys in the services configmap). In addition to the keys given in the service's JSON object, each service has the following keys:
      • name: the name of the service
    • env: a dict containing the process' environment variables


See examples/varnish.yaml in

Docker Pull Command
Source Repository

Comments (0)