collective.diazo.readheaders 0.1

WSGI管道

以下是为PasteScript准备的配置

[server:main]
use = egg:Paste#http
host = 0.0.0.0
port = 5000

[composite:main]
use = egg:Paste#urlmap
/ = default

[pipeline:default]
pipeline = theme
           proxy

[filter:theme]
use = egg:collective.diazo.readheaders
#You can use any other Diazo middleware options here, too!
read_network = True
debug = True

[app:proxy]
use = egg:djb.headerproxy

在http://docs.diazo.org/en/latest/quickstart.html标准Diazo/WSGI配置中，细心的读者会注意到以下内容

1. 我们使用collective.diazo.readheaders而不是diazo——这允许从传入的WSGI环境中读取X-Diazo-Rules头部并将其用作传统的rules选项。这意味着如果设置为这个头部，任何rules选项接受的格式（例如基于网络的URL）都将有效。在特定情况下，对于网络URL，您需要配置read_network启用。

   本节自动接受任何选项并添加Diazo的功能：请参阅http://docs.diazo.org/en/latest/deployment.html#wsgi——我们上面已经展示了这一点。

2. 我们使用特殊的WSGI代理djb.headerproxy，该代理将基于传入的头部反向代理到任意位置。相比之下，标准的Paste代理需要在配置中显式定义地址。根据djb.headerproxy的文档，上游的头部默认情况下期望是X-Proxy-Force-Host和X-Proxy-Force-Scheme——这个映射是可配置的。

前端

现在，在我们的前端服务器中，我们可以配置我们的反向代理并相应地设置头部。例如，使用Apache，您可能做以下操作

RequestHeader set "X-Diazo-Rules" "/path/to/rules.xml"
RequestHeader set "X-Proxy-Force-Host" "app-server.example.com:8080"
RequestHeader set "X-Proxy-Force-Scheme" "http"
RewriteRule / https://127.0.0.1:5000 [L,P]

其中，重写规则指向运行上述Paste WSGI配置的服务位置。

别忘了，X-Diazo-Rules选项将在运行WSGI管道的本地计算机上被解释。所以，如果您引用本地文件，它将是该机器的本地文件。如果您在相同的机器上运行Diazo，这一点无足轻重——但仍然应该强调。还要记住，您可以配置像这样的选项

RequestHeader set X-Diazo-Rules "http://example.com/path/to/rules.xml"

它们也将正常工作（假设，至少在这个例子中，您的中间件已启用read_network选项）。

[uwsgi]
home = /opt/diazo
processes = 8
vacuum = true
master = true
socket = %(home)/var/uwsgi.sock
pythonpath = %(home)/eggs/*.egg
pythonpath = %(home)/src/*

cd /opt/diazo
virtualenv .
source bin/activate
pip install uwsgi collective.diazo.readheaders djb.headerproxy

./bin/uwsgi --ini-paste diazo.ini

[buildout]
parts = lxml instance
eggs-directory = eggs

[lxml]
recipe = z3c.recipe.staticlxml
egg = lxml

[instance]
recipe = zc.recipe.egg
eggs =
    collective.diazo.readheaders
    djb.headerproxy
    uwsgi
dependent-scripts = true