/usr/share/doc/nginx-doc/upstream is in nginx-doc 1.9.15-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 | ##
# File:
# upstream
# Description:
# This file describes how to use upstream blocks.
##
An upstream block allows you to set a list of upstream locations for both
proxy_pass and fastcgi_pass directives.
Examples of upstream blocks:
# PHP listening on the same server
upstream php {
# ip_hash ensures the same backend is used for client reconnects.
ip_hash;
# This assumes we have multiple PHP listeners on different known ports.
server 127.0.0.1:9000;
server 127.0.0.1:9001;
server 127.0.0.1:9002;
server 127.0.0.1:9003;
# In addition to listening on ports, we can listen to unix sockets.
server unix:/tmp/php-cgi.socket;
}
# Multiple backend Apache instances on separate servers
upstream apache {
# Adding a weight alters the chance the upstream server will be used.
server apache1.domain.com weight 5;
server apache2.domain.com;
server apache3.domain.com;
# Adding 'down' keeps the upstream from being used. Useful for downtime management.
server apache4.domain.com down;
server apache5.domain.com;
}
Using an upstream location:
# Passing PHP to upstream
location ~ \.php$ {
fastcgi_split_path_info ^(.+\.php)(/.+)$;
include fastcgi_params;
fastcgi_pass php;
}
# Passing all requests for /cgi-bin/* to Apache upstreams.
location /cgi-bin {
proxy_pass apache;
}
For more information see http://wiki.nginx.org/HttpUpstreamModule
|