Buildout and Plone
Tim Knapp
Emerge Technology
www.emergetec.com

Why Buildout?

Consistency

Dependency Management

Speeds Up Deployment

Buildout Basics

Configuration File
[buildout]
parts =
zope
plone
instance
[plone]
recipe = plone.recipe.plone
[zope2]
recipe = plone.recipe.zope2instance
user = admin:admin
eggs = ${plone:eggs}
products = ${plone:products}
Buildout and Plone
NZPUG Meeting Dec 2008 / Tim Knapp

Advanced Syntax
Variable Substitution
${parts:option}
${plone:eggs}
${buildout:directory}
option = ${buildout:directory}/somefolder
Option Addition and Removal
options = foo bar
options += baz
options -= foo
Buildout and Plone
NZPUG Meeting Dec 2008 / Tim Knapp

Buildout Directory
●
bin/
●
bootstrap.py
●
buildout.cfg
●
develop-eggs/
●
downloads/
●
eggs/
●
parts/
●
products/
●
src/
Buildout and Plone
NZPUG Meeting Dec 2008 / Tim Knapp

Buildout Options
●
bin-directory
●
develop-eggs-directory
●
eggs-directory
●
parts
●
parts-directory
●
log-level
Buildout and Plone
NZPUG Meeting Dec 2008 / Tim Knapp

Parts
[buildout]
parts =
instance
[instance]
recipe = plone.recipe.zope2instance
user = admin:admin
eggs = ${plone:eggs} archetypes.schemaextender
zcml = archetypes.schemaextender
products = ${plone:products}
environment­vars =
TZ Pacific/Auckland
http­address = 8080
zeo­address = 8000
debug­mode = on
verbose­security = on
event­log­level = debug
Buildout and Plone
NZPUG Meeting Dec 2008 / Tim Knapp

Plone Recipes
[buildout]
parts =
zope2
plone
instance
[plone]
recipe = plone.recipe.plone
[zope2]
recipe = plone.recipe.zope2install
[instance]
recipe = plone.recipe.zope2instance
user = admin:admin
eggs = ${plone:eggs}
products = ${plone:products}
Buildout and Plone
NZPUG Meeting Dec 2008 / Tim Knapp

The Command Line

Command Line Options
$cd path/to/my/buildout
$python2.4 bootstrap.py
Creating directory 'mybuildout/bin'.
Creating directory 'mybuildout/parts'.
Creating directory 'mybuildout/develop­eggs'.
Generated script 'mybuildout/bin/buildout'.
$ bin/buildout
$ bin/instance start
Buildout and Plone
NZPUG Meeting Dec 2008 / Tim Knapp

Advanced CLI Options
●
-v and -q
– increase and decrease verbosity
●
-n and -N
– Newest and non-newest modes
●
-O and -o
– online and offline mode
Buildout and Plone
NZPUG Meeting Dec 2008 / Tim Knapp

Wrapping Up
●
Buildout Basics
– Configuration File
– Buildout Directory
– Buildout Options
– Parts
– Recipes
●
Command Line
Buildout and Plone
NZPUG Meeting Dec 2008 / Tim Knapp