105 lines
2.8 KiB
Groff
105 lines
2.8 KiB
Groff
.TH Varnish Cache 5.0 HTTP reverse proxy Container image
|
|
.PP
|
|
This container image includes Varnish 5.0 Cache server and a reverse proxy for OpenShift and general usage.
|
|
Users can choose between RHEL and CentOS based images.
|
|
The RHEL image is available in the Red Hat Container Catalog
|
|
\[la]https://access.redhat.com/containers/#/registry.access.redhat.com/rhscl/varnish-5-rhel7\[ra]
|
|
as registry.access.redhat.com/rhscl/varnish\-5\-rhel7.
|
|
The CentOS image is then available on Docker Hub
|
|
\[la]https://hub.docker.com/r/centos/varnish-5-centos7/\[ra]
|
|
as centos/varnish\-5\-centos7.
|
|
|
|
.SH Description
|
|
.PP
|
|
Varnish available as container is a base platform for
|
|
running Varnish server or building Varnish\-based application.
|
|
Varnish Cache stores web pages in memory so web servers don't have to create
|
|
the same web page over and over again. Varnish Cache serves pages much faster
|
|
than any application server, giving the website a significant speed up.
|
|
|
|
.PP
|
|
The image can be used as a base image for other applications based on Varnish Cache 5.0 or using s2i tool.
|
|
|
|
.SH Usage
|
|
.PP
|
|
To build a simple sample\-app
|
|
\[la]https://github.com/sclorg/varnish-container/tree/generated/5/test/test-app\[ra] application
|
|
using standalone S2I
|
|
\[la]https://github.com/openshift/source-to-image\[ra] and then run the
|
|
resulting image with Docker
|
|
\[la]http://docker.io\[ra] execute:
|
|
.IP \(bu 2
|
|
|
|
.PP
|
|
\fBFor RHEL based image\fP
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
$ docker pull registry.access.redhat.com/rhscl/varnish\-5\-rhel7
|
|
$ s2i build https://github.com/sclorg/varnish\-container.git \-\-context\-dir=5/test/test\-app/ registry.access.redhat.com/rhscl/varnish\-5\-rhel7 sample\-server
|
|
$ docker run \-p 8080:8080 sample\-server
|
|
|
|
.fi
|
|
.RE
|
|
.IP \(bu 2
|
|
|
|
.PP
|
|
\fBFor CentOS based image\fP
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
$ docker pull centos/varnish\-5\-centos7
|
|
$ s2i build https://github.com/sclorg/varnish\-container.git \-\-context\-dir=5/test/test\-app/ centos/varnish\-5\-centos7 sample\-server
|
|
$ docker run \-p 8080:8080 sample\-server
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.PP
|
|
\fBAccessing the application:\fP
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
$ curl 127.0.0.1:8080
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.SH Configuration
|
|
.PP
|
|
No further configuration is required.
|
|
|
|
.SH S2I build support
|
|
.PP
|
|
The Varnish Cache 5.0 Container image supports the S2I tool (see Usage section).
|
|
Note that the default.vcl configuration file in the directory accessed by S2I needs
|
|
to be in the VCL format.
|
|
|
|
.SH Environment variables and volumes
|
|
.PP
|
|
No special environment variables or volumes available.
|
|
|
|
.SH Troubleshooting
|
|
.PP
|
|
Varnish logs into standard output, so the log is available in the container log. The log can be examined by running:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
docker logs <container>
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.SH See also
|
|
.PP
|
|
Dockerfile and other sources for this container image are available on
|
|
|
|
\[la]https://github.com/sclorg/varnish-container\[ra]\&.
|
|
In that repository, Dockerfile for CentOS is called Dockerfile, Dockerfile
|
|
for RHEL is called Dockerfile.rhel7.
|