blob: bd09bfefa21bfe40e63ac26415c3bb03dd18d6a7 [file] [log] [blame]
James E. Blair01c2e632014-01-23 10:55:08 -08001Since 2.0.0:
2
3* The push_change_refs option which specified that Zuul refs should be
James E. Blair9ca39832014-01-28 12:27:13 -08004 pushed to Gerrit has been removed.
James E. Blair01c2e632014-01-23 10:55:08 -08005
James E. Blair4076e2b2014-01-28 12:42:20 -08006* Git merge operations are now performed in a separate process. Run
7 at least one instance of the ``zuul-merger`` program which is now
8 included. Any number of Zuul-Mergers may be run in order to
9 distribute the work of speculatively merging changes into git and
10 serving the results to test workers. This system is designed to
11 scale out to many servers, but one instance may be co-located with
12 the Zuul server in smaller deployments. Several configuration
13 options have moved from the ``zuul`` section to ``merger``.
14
James E. Blair66eeebf2013-07-27 17:44:32 -070015Since 1.3.0:
James E. Blaird78576a2013-07-09 10:39:17 -070016
17* The Jenkins launcher is replaced with Gearman launcher. An internal
18 Gearman server is provided, and there is a Gearman plugin for
19 Jenkins, so migration to the new system should be fairly
20 straightforward. See the Launchers section of the documentation for
21 details.
22
James E. Blaird0470972013-07-29 10:05:43 -070023* The custom parameter function signature has changed. It now takes a
24 QueueItem as the first argument, rather than the Change. The
25 QueueItem has the full context for why the change is being run
26 (including the pipeline, items ahead and behind, etc.). The Change
27 is still available via the "change" attribute on the QueueItem. The
James E. Blair6c358e72013-07-29 17:06:47 -070028 second argument is now the Job that is about to be run, and the
James E. Blaird0470972013-07-29 10:05:43 -070029 parameter dictionary is shifted to the third position.
30
Jeremy Stanleye6abe812013-07-31 21:14:16 +000031* The ZUUL_SHORT_* parameters have been removed (the same
James E. Blaird0470972013-07-29 10:05:43 -070032 functionality may be achieved with a custom parameter function that
33 matches all jobs).
James E. Blair6736beb2013-07-11 15:18:15 -070034
James E. Blair63bb0ef2013-07-29 17:14:51 -070035* Multiple triggers are now supported (currently Gerrit and a simple
36 Timer trigger ar supported). Your layout.yaml file will need to
James E. Blair6c358e72013-07-29 17:06:47 -070037 change to add the key "gerrit:" inside of the "triggers:" list to
38 specify a Gerrit trigger (and facilitate adding other kinds of
James E. Blair63bb0ef2013-07-29 17:14:51 -070039 triggers later). See the sample layout.yaml and Zuul section of the
40 documentation.
James E. Blair6c358e72013-07-29 17:06:47 -070041
James E. Blair66eeebf2013-07-27 17:44:32 -070042* Some statsd keys have changed in a backwards incompatible way:
43 * The counters and timers of the form zuul.job.{name} is now split
44 into several keys of the form:
45 zuul.pipeline.{pipeline-name}.job.{job-name}.{result}
46 * Job names in statsd keys now have the '_' character substituted
47 for the '.' character.
Joshua Hesketh1879cf72013-08-19 14:13:15 +100048
49* The layout.yaml structure has changed to introduce configurable
50 reporters. This requires restructuring the start/success/failure
51 actions to include a dictionary of reporters and their parameters.
52 See reporters in the docs and layout.yaml-sample.
James E. Blair01ca4982013-12-04 08:57:35 -080053
54* The zuul_url configuration option is required in zuul.conf. It
55 specifies the URL of the git repositories that should be used by
56 workers when fetching Zuul refs and is passed to the workers as the
57 ZUUL_URL parameter. It should probably be set to
58 "http://zuul-host-name/p/".