Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
U
unique-xids
Project
Project
Details
Activity
Releases
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Wiki
Wiki
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
uplex-varnish
unique-xids
Commits
b31835c4
Commit
b31835c4
authored
Sep 07, 2012
by
Per Buer
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Merge backend stuff into one chapter
parent
f53869e8
Changes
2
Hide whitespace changes
Inline
Side-by-side
Showing
2 changed files
with
163 additions
and
159 deletions
+163
-159
advanced_backend_servers.rst
doc/sphinx/users-guide/advanced_backend_servers.rst
+0
-157
backend_servers.rst
doc/sphinx/users-guide/backend_servers.rst
+163
-2
No files found.
doc/sphinx/users-guide/advanced_backend_servers.rst
deleted
100644 → 0
View file @
f53869e8
Advanced Backend configuration
------------------------------
At some point you might need Varnish to cache content from several
servers. You might want Varnish to map all the URL into one single
host or not. There are lot of options.
Lets say we need to introduce a Java application into out PHP web
site. Lets say our Java application should handle URL beginning with
/java/.
We manage to get the thing up and running on port 8000. Now, lets have
a look a default.vcl.::
backend default {
.host = "127.0.0.1";
.port = "8080";
}
We add a new backend.::
backend java {
.host = "127.0.0.1";
.port = "8000";
}
Now we need tell where to send the difference URL. Lets look at vcl_recv.::
sub vcl_recv {
if (req.url ~ "^/java/") {
set req.backend = java;
} else {
set req.backend = default.
}
}
It's quite simple, really. Lets stop and think about this for a
moment. As you can see you can define how you choose backends based on
really arbitrary data. You want to send mobile devices to a different
backend? No problem. if (req.User-agent ~ /mobile/) .... should do the
trick.
.. _users-guide-advanced_backend_servers-directors:
Directors
---------
You can also group several backend into a group of backends. These
groups are called directors. This will give you increased performance
and resilience. You can define several backends and group them
together in a director.::
backend server1 {
.host = "192.168.0.10";
}
backend server2{
.host = "192.168.0.10";
}
Now we create the director.::
director example_director round-robin {
{
.backend = server1;
}
# server2
{
.backend = server2;
}
# foo
}
This director is a round-robin director. This means the director will
distribute the incoming requests on a round-robin basis. There is
also a *random* director which distributes requests in a, you guessed
it, random fashion.
But what if one of your servers goes down? Can Varnish direct all the
requests to the healthy server? Sure it can. This is where the Health
Checks come into play.
.. _users-guide-advanced_backend_servers-health:
Health checks
-------------
Lets set up a director with two backends and health checks. First lets
define the backends.::
backend server1 {
.host = "server1.example.com";
.probe = {
.url = "/";
.interval = 5s;
.timeout = 1 s;
.window = 5;
.threshold = 3;
}
}
backend server2 {
.host = "server2.example.com";
.probe = {
.url = "/";
.interval = 5s;
.timeout = 1 s;
.window = 5;
.threshold = 3;
}
}
Whats new here is the probe. Varnish will check the health of each
backend with a probe. The options are
url
What URL should varnish request.
interval
How often should we poll
timeout
What is the timeout of the probe
window
Varnish will maintain a *sliding window* of the results. Here the
window has five checks.
threshold
How many of the .window last polls must be good for the backend to be declared healthy.
initial
How many of the of the probes a good when Varnish starts - defaults
to the same amount as the threshold.
Now we define the director.::
director example_director round-robin {
{
.backend = server1;
}
# server2
{
.backend = server2;
}
}
You use this director just as you would use any other director or
backend. Varnish will not send traffic to hosts that are marked as
unhealthy. Varnish can also serve stale content if all the backends are
down. See :ref:`users-guide-handling_misbehaving_servers` for more
information on how to enable this.
Please note that Varnish will keep probes active for all loaded
VCLs. Varnish will coalesce probes that seem identical - so be careful
not to change the probe config if you do a lot of VCL
loading. Unloading the VCL will discard the probes.
doc/sphinx/users-guide/backend_servers.rst
View file @
b31835c4
...
...
@@ -23,7 +23,7 @@ We comment in this bit of text making the text look like.::
backend default {
.host = "127.0.0.1";
.port = "80";
.port = "80
80
";
}
Now, this piece of configuration defines a backend in Varnish called
...
...
@@ -32,5 +32,166 @@ connect to port 8080 on localhost (127.0.0.1).
Varnish can have several backends defined and can you can even join
several backends together into clusters of backends for load balancing
purposes. XXX: ref
purposes.
Multiple backends
-----------------
At some point you might need Varnish to cache content from several
servers. You might want Varnish to map all the URL into one single
host or not. There are lot of options.
Lets say we need to introduce a Java application into out PHP web
site. Lets say our Java application should handle URL beginning with
/java/.
We manage to get the thing up and running on port 8000. Now, lets have
a look at the default.vcl.::
backend default {
.host = "127.0.0.1";
.port = "8080";
}
We add a new backend.::
backend java {
.host = "127.0.0.1";
.port = "8000";
}
Now we need tell where to send the difference URL. Lets look at vcl_recv.::
sub vcl_recv {
if (req.url ~ "^/java/") {
set req.backend = java;
} else {
set req.backend = default.
}
}
It's quite simple, really. Lets stop and think about this for a
moment. As you can see you can define how you choose backends based on
really arbitrary data. You want to send mobile devices to a different
backend? No problem. if (req.User-agent ~ /mobile/) .. should do the
trick.
.. _users-guide-advanced_backend_servers-directors:
Directors
---------
You can also group several backend into a group of backends. These
groups are called directors. This will give you increased performance
and resilience. You can define several backends and group them
together in a director.::
backend server1 {
.host = "192.168.0.10";
}
backend server2{
.host = "192.168.0.10";
}
Now we create the director.::
director example_director round-robin {
{
.backend = server1;
}
# server2
{
.backend = server2;
}
# foo
}
This director is a round-robin director. This means the director will
distribute the incoming requests on a round-robin basis. There is
also a *random* director which distributes requests in a, you guessed
it, random fashion.
But what if one of your servers goes down? Can Varnish direct all the
requests to the healthy server? Sure it can. This is where the Health
Checks come into play.
.. _users-guide-advanced_backend_servers-health:
Health checks
-------------
Lets set up a director with two backends and health checks. First lets
define the backends.::
backend server1 {
.host = "server1.example.com";
.probe = {
.url = "/";
.interval = 5s;
.timeout = 1 s;
.window = 5;
.threshold = 3;
}
}
backend server2 {
.host = "server2.example.com";
.probe = {
.url = "/";
.interval = 5s;
.timeout = 1 s;
.window = 5;
.threshold = 3;
}
}
Whats new here is the probe. Varnish will check the health of each
backend with a probe. The options are
url
What URL should varnish request.
interval
How often should we poll
timeout
What is the timeout of the probe
window
Varnish will maintain a *sliding window* of the results. Here the
window has five checks.
threshold
How many of the .window last polls must be good for the backend to be declared healthy.
initial
How many of the of the probes a good when Varnish starts - defaults
to the same amount as the threshold.
Now we define the director.::
director example_director round-robin {
{
.backend = server1;
}
# server2
{
.backend = server2;
}
}
You use this director just as you would use any other director or
backend. Varnish will not send traffic to hosts that are marked as
unhealthy. Varnish can also serve stale content if all the backends are
down. See :ref:`users-guide-handling_misbehaving_servers` for more
information on how to enable this.
Please note that Varnish will keep probes active for all loaded
VCLs. Varnish will coalesce probes that seem identical - so be careful
not to change the probe config if you do a lot of VCL
loading. Unloading the VCL will discard the probes.
For more information on how to do this please see
ref:`reference-vcl-director`.
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment