openeuler/varnish repository overview

⁠Quick reference

• The official Varnish Cache docker image.

• Maintained by: openEuler CloudNative SIG⁠.

• Where to get help: openEuler CloudNative SIG⁠, openEuler⁠.

⁠Varnish Cache | openEuler

Current Varnish Cache docker images are built on the openEuler⁠. This repository is free to use and exempted from per-user rate limits.

Varnish Cache is a web application accelerator also known as a caching HTTP reverse proxy. You install it in front of any server that speaks HTTP and configure it to cache the contents. Varnish Cache is really, really fast. It typically speeds up delivery with a factor of 300 - 1000x, depending on your architecture.

Read more on Varnish Docs⁠.

⁠Supported tags and respective Dockerfile links

The tag of each varnish docker image is consist of the version of varnish and the version of basic image. The details are as follows

⁠Usage

In this usage, users can select the corresponding {Tag} based on their requirements.

• Pull the openeuler/varnish image from docker

  docker pull openeuler/varnish:{Tag}
  

  Copy

• Run with an interactive shell

  You can start the container with an interactive shell to use varnish.

  docker run -it --rm openeuler/varnish:{Tag} bash
  

  Copy

• Create Varnish configuration file

  Create the directory to store Varnish configuration files:

  mkdir -p /etc/varnish
  

  Copy

  Create the VCL file /etc/varnish/default.vcl, example content could be:

  vcl 4.0;
  
  backend default {
      .host = "127.0.0.1"; 
      .port = "8080";
  }
  

  Copy

• Start a simple backend HTTP server

  Run a basic HTTP server using Python3 on port 8080:

  nohup python3 -m http.server 8080 &
  

  Copy

  The python HTTP server acts as the backend that Varnish caches.

• Start Varnish in the background

  nohup varnishd -F -f /etc/varnish/default.vcl -a :6081 & 
  

  Copy

  Varnish listens on port 6081 and forwards requests to the backend on port 8080.

• Test Varnish HTTP service

  Use curl to send a HEAD request and check if Varnish is responding:

  curl -I http://localhost:6081
  

  Copy

⁠Question and answering

If you have any questions or want to use some special features, please submit an issue or a pull request on openeuler-docker-images⁠.