Upgrading to 0.7.0

Instance format

In Cluster Broccoli 0.7.0 the instance format has changed. To convert instances from older versions (0.5.0 and 0.6.0) you can use the the instances-0.6.0-to-0.7.0.sh upgrade script to upgrade the instance JSON files in your instance directory.

The script requires jq 1.5.

1. nomad stop cluster-broccoli
2. script/instances-0.6.0-to-0.7.0.sh /path/to/broccoli/instances
3. nomad run cluster-broccoli.hcl

Docker folder paths

In the Docker production image the paths to templates and instances changed from /templates and /instances to /cluster-broccoli-dist/templates and /cluster-broccoli-dist/instances respectively.

Default parameter type

In the 0.7.0 release we introduced parameter types (#17). The default parameter type is string which means that all quotes inside the parameter values will be escaped. This might break your existing templates if you rely on unescaped quotes. To make the new release backwards compatible, set broccoli.instances.parameters.default-type to raw.

For more details please look at the parameter types docs.

Configuration Changes

Template Storage

• broccoli.templates.storage.type has been removed
• broccoli.templates.storage.fs.url has been moved to broccoli.templates.path

Instance Storage

• broccoli.instances.storage.couchdb.dbName has been renamed to broccoli.instances.storage.couchdb.database
• broccoli.instances.storage.fs.url has been renamed to broccoli.instances.storage.fs.path
• broccoli.instances.storage.type has been removed. Switching between different instance storage types is now done by loading the corresponding module. See reference.conf for details.