plone.recipe.apache 0.2.1

trunk (2008-07-02)

• xxx [Ingeniweb]

0.2.1 (2008-07-02)

• fix Cheetah require in setup.py [yboussard]

0.2.0 (2008-06-30)

• Add log_format option to configure apache log [yboussard]

0.1.0 (2008-04-27)

• Created recipe with ZopeSkel [Paris sprint 2008].

Supported options

The recipe supports the following options:

url

URL for an archive containing the Squid sources. Either url or svn has to be specified.

svn

URL for a subversion repository containing Aapache sources. Either url or svn has to be specified.

modules

Here you you can specify the extra modules that you want apache to be compiled with. Each module goes in one line. The module name will be appended to the configure statement –con–

Example usage

We’ll start by creating a buildout that uses the recipe:

>>> write('buildout.cfg',
... """
... [buildout]
... parts = apachebuild
...
... [apachebuild]
... recipe = plone.recipe.apache:build
... url = http://mir2.ovh.net/ftp.apache.org/dist/httpd/httpd-2.2.8.tar.gz
... """ )

Running the buildout gives us:

>>> print system(buildout)
Installing apachebuild.
apachebuild: Downloading apache tarball.
apachebuild: Compiling Apache
...

Supported options

The recipe supports the following options:

mainconfig

location of apache configuration (ex: /etc/apache2/apache2.conf). if no value is provided we use the location of the config file from build recipe

bind

Hostname and port on which Apache will listen for requests. Syntax is [hostname][:port]. Defaults to 80. If hostname is omitted then Apache will bind to all available interfaces.

backends

Specifies the backend or backends which will process the requests. The syntax for backends:

<hostname>[/<path>]:<ip address>:<port>

If multiple backends are specified then each backend must include a hostname.

zope2_vhm_map

zope2_vhm_map Defines a virtual host mapping for Zope servers. This is a list of hostname:ZODB location entries which specify the location inside Zope where the website for a virtual host lives. The syntax for zope servers:

<hostname>:<path>

log_format

Specify the log format of apache (combined, common) , common is the default

Example usage

We’ll start by creating a buildout that uses the recipe:

>>> write('buildout.cfg',
... """
... [buildout]
... parts = apacheconfig
...
... [apacheconfig]
... recipe = plone.recipe.apache:config
... mainconfig = /usr/local/apache/config/httpd.conf
... bind = 80
... backends = plone.org:127.0.0.1:3128
... zope2_vhm_map = plone.org:/plone
... """)

Running the buildout gives us:

>>> print system(buildout)
Installing apacheconfig.
...