Changeset 2379

Show
Ignore:
Timestamp:
11/11/08 19:05:26 (2 months ago)
Author:
taher
Message:

--

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • cherokee/trunk/doc/Makefile.am

    r2375 r2379  
    7373modules_handlers_mirror.html \ 
    7474modules_handlers_admin.html \ 
     75modules_handlers_proxy.html \ 
    7576modules_loggers.html \ 
    7677modules_loggers_combined.html \ 
    …… 
    136137media/images/admin_vserver.png \ 
    137138media/images/admin_vserver_vserver.png \ 
     139media/images/admin_handler_proxy.png \ 
    138140media/images/cookbook_django_common.png \ 
    139141media/images/cookbook_django_infosources.png \ 

  • cherokee/trunk/doc/dev_cherokee.conf.txt

    r2313 r2379  
    543543    include = /etc/cherokee/mods-enabled/ 
    544544---- 
     545 
     546Reverse Proxy 
     547~~~~~~~~~~~~~ 
     548 
     549The reverse proxy , like everything in Cherokee, is modular. It is 
     550configured as any other of the modules that use load balancers. 
     551 
     552You need to define a balancing strategy, the information source to be 
     553used by the balancer and, optionally, any expression matches that you 
     554might wish to rewrite in the headers before relaying the connection. 
     555 
     556This is a basic example: 
     557 
     558---- 
     559server!port = 1234 
     560 
     561# The proxy configuration 
     562vserver!1!nick = default 
     563vserver!1!document_root = /tmp 
     564vserver!1!rule!1!match = default 
     565vserver!1!rule!1!handler = proxy 
     566vserver!1!rule!1!handler!header_hide!1 = server 
     567vserver!1!rule!1!handler!balancer = round_robin 
     568vserver!1!rule!1!handler!balancer!source!1 = 1 
     569 
     570# URL rewrite 
     571vserver!1!rule!1!handler!rewrite_request!1!regex = ^/(.+).png$ 
     572vserver!1!rule!1!handler!rewrite_request!1!substring = /$1.jpg 
     573vserver!1!rule!1!handler!rewrite_request!2!regex = ^/test/(.+)$ /$1.jpg 
     574vserver!1!rule!1!handler!rewrite_request!2!substring = /test.php?$1 
     575 
     576# The information source 
     577source!1!type = host 
     578source!1!host = localhost:9090 
     579---- 

  • cherokee/trunk/doc/dev_issues.txt

    r2376 r2379  
    1818to be half-baked, and as such are only of interest for developers. 
    1919 
     20[fastcgi] 
    2021FastCGI Handler 
    2122~~~~~~~~~~~~~~~ 
    …… 
    3536moment "fcgi" is a better option. 
    3637 
     38[reverse_proxy] 
    3739Reverse Proxy 
    3840~~~~~~~~~~~~~ 
    3941 
    40 The reverse proxy is currently one of the most demanded features and 
    41 is under heavy development.  The Cherokee-admin module is not yet 
    42 written, so you'll have to do what no final user is meant to do. It's 
    43 easy to configure though, so don't worry. It is working nicely, and 
    44 since r2373 it supports URL rewriting. 
     42The reverse proxy has been one of the most demanded features and is 
     43under heavy development. It is currently released as a standard 
     44handler, so check out the link:modules_handlers_proxy.html[HTTP 
     45reverse proxy] handler documentation. 
    4546 
    46 Here you have a basic configuration example: 
    47  
    48 ---- 
    49 server!port = 1234 
    50  
    51 # The proxy configuration 
    52 vserver!1!nick = default 
    53 vserver!1!document_root = /tmp 
    54 vserver!1!rule!1!match = default 
    55 vserver!1!rule!1!handler = proxy 
    56 vserver!1!rule!1!handler!header_hide!1 = server 
    57 vserver!1!rule!1!handler!balancer = round_robin 
    58 vserver!1!rule!1!handler!balancer!source!1 = 1 
    59  
    60 # URL rewrite 
    61 vserver!1!rule!1!handler!rewrite_request!1!regex = ^/(.+).png$ 
    62 vserver!1!rule!1!handler!rewrite_request!1!substring = /$1.jpg 
    63 vserver!1!rule!1!handler!rewrite_request!2!regex = ^/test/(.+)$ 
    64 vserver!1!rule!1!handler!rewrite_request!2!substring = /test.php?$1 
    65  
    66 source!1!type = host 
    67 source!1!host = localhost:9090 
    68 ---- 
    69  
    70  
     47[wizards] 
    7148Configuration Wizards 
    7249~~~~~~~~~~~~~~~~~~~~~ 
    …… 
    8259further tuning. 
    8360 
     61[boolean_rules] 
    8462AND, OR and NOT rule types 
    8563~~~~~~~~~~~~~~~~~~~~~~~~~~ 

  • cherokee/trunk/doc/index.txt

    r2376 r2379  
    7777    - link:modules_handlers_fcgi.html[FastCGI]: Fast Common Gateway Interface. 
    7878    - link:modules_handlers_scgi.html[SCGI]: Simple Common Gateway Interface. 
     79    - link:modules_handlers_proxy.html[HTTP reverse proxy]: Surrogate/reverse proxy handler. 
    7980    - link:modules_handlers_ssi.html[Server Side Includes] - SSI Server Support. 
    8081    - link:modules_handlers_server_info.html[Server Info]: Provide info about Cherokee. 

  • cherokee/trunk/doc/modules.txt

    r2306 r2379  
    1414    - link:modules_handlers_fcgi.html[FastCGI]: Fast Common Gateway Interface. 
    1515    - link:modules_handlers_scgi.html[SCGI]: Simple Common Gateway Interface. 
     16    - link:modules_handlers_proxy.html[HTTP reverse proxy]: Surrogate/reverse proxy handler. 
    1617    - link:modules_handlers_ssi.html[Server Side Includes] - SSI Server Support. 
    1718    - link:modules_handlers_server_info.html[Server Info]: Provide info about Cherokee. 

  • cherokee/trunk/doc/modules_handlers.txt

    r2306 r2379  
    2121* link:modules_handlers_fcgi.html[FCGI] - **FastCGI Server Support**. 
    2222* link:modules_handlers_scgi.html[SCGI] - **SCGI Server Support**. 
     23* link:modules_handlers_proxy.html[HTTP reverse proxy] - **Surrogate/reverse proxy handler**. 
    2324* link:modules_handlers_ssi.html[Server Side Includes] - **SSI Server Support**. 
    2425* link:modules_handlers_server_info.html[Server Info] - **Server 

  • cherokee/trunk/doc/modules_handlers_mirror.txt

    r1816 r2379  
    55 
    66This is the generic handler that provides the specific balancing 
    7 strategy provided by the balancer modules. Check the documentation for 
    8 link:modules_balancers.html[Balancers] for information about the 
     7strategy implemented by the balancer modules. Check the documentation 
     8for link:modules_balancers.html[Balancers] for information about the 
    99necessary parameters for any of these. 
    1010 
    …… 
    1414any of those but want to distribute the load among several servers, 
    1515this is the handler you should be using. 
     16 
     17Currently it supports connection forwarding and balancing, so you can 
     18configure it to forward the connection to a series of intranet servers 
     19for example. The generic balancer will forward the whole request, 
     20totally preserving its integrity: same URL, same headers, same 
     21eveything. If you would require a more complex behavior you should 
     22probably be using the link:modules_handlers_proxy.html[Rreverse Proxy] 
     23handler. 

  • cherokee/trunk/doc/modules_handlers_redir.txt

    r2218 r2379  
    55 
    66The main idea of a redirection is telling the web client to go to 
    7 another URL when the requested URL matches a rule. 
     7another URL when the requested URL matches a rule. If you are looking 
     8for connection forwarding, you should check the 
     9link:modules_handlers_mirror.html[generic balancer] instead. 
     10 
    811 
    912For example, if you have URLs like::