Niveshkrishna / docker-varnish

Official docker image

Home Page:https://hub.docker.com/_/varnish

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Build Status

This is the source repository use to build the official Varnish Docker image.

Versions

This repository tracks two Varnish versions:

  • fresh: the latest release.
  • stable: an Long-Term Support (LTS) release that will receive bug and security fixes even though it's not the latest one.

New major/minor versions are release on the 15th of March and of September, this is when the fresh and stable labels are reevaluated.

Building

The docker build directories are under fresh/ and stable/. Dockerfiles are generated all at once using:

# don't forget to commit there afterward
./populate.sh dockerfiles

Edit ./populate.sh first if you want to modify the labels and installed versions.

To generate the file that will become https://github.com/docker-library/official-images/blob/master/library/varnish, use:

# commit your changes first!
./populate.sh library

Running

When running the Varnish image, a varnishd process will be started that listens on the following ports:

  • port 80 for plain HTTP
  • port 8443 for the PROXY protocol

See TLS section for more information about the primary PROXY protocol use case.

Varnish will run with a default memory storage size of 100M. The VARNISH_SIZE environment variable can be used to extend the size.

TLS

If you want to connect to Varnish via HTTPS, you'll need to terminate the TLS connection elsewhere. TLS termination can be done on some loadbalancers or proxy servers, but the Varnish ecosystem also provides a purpose-built TLS terminator called Hitch.

Hitch supports the PROXY protocol and is transparent to Varnish. The PROXY protocol has the ability to keep track of the original client IP address.

Hitch, or any other TLS terminator that supports the PROXY protocol will connect to Varnish on port 8443.

Image documentation

Please see https://github.com/docker-library/docs/tree/master/varnish

About

Official docker image

https://hub.docker.com/_/varnish


Languages

Language:Shell 70.7%Language:Dockerfile 29.3%