README: note some prerequisites for deployment

The deployment instructions assume buildbot is already installed on the
target system.
Furthermore note that a copy of the yocto-autobuilder-helper is required.

Signed-off-by: Joshua Lock <joshua.g.lock@intel.com>
This commit is contained in:
Joshua Lock 2018-03-07 10:53:44 +00:00
parent 8400719f6a
commit 845aea0b5c

View File

@ -46,24 +46,32 @@ workflows and to replicate the workflows established with the outgoing
yocto-autobuilder[2].
### WriteLayerInfo buildstep
[steps/writelayerinfo.py](steps/writelayerinfo.py) -- implements a simple custom buildset to iterate the
repo_, branch_, and commit_ properties set by the schedulers and write a JSON
file with the user's values.
[steps/writelayerinfo.py](steps/writelayerinfo.py) -- implements a simple
custom buildset to iterate the repo_, branch_, and commit_ properties set by
the schedulers and write a JSON file with the user's values.
### WikiLog reporter
[reporters/wikilog.py](reporters/wikilog.py) -- a buildbot service to listen for build failures and
write some information on them to the configured wiki page.
[reporters/wikilog.py](reporters/wikilog.py) -- a buildbot service to listen
for build failures and write some information on them to the configured wiki
page.
[lib/wiki.py](lib/wiki.py) -- some helper functions for the wiki plugin, much of this code can
be replaced by porting the plugin to be a buildbot.util.service.HTTPClient
implementation
[lib/wiki.py](lib/wiki.py) -- some helper functions for the wiki plugin, much
of this code can be replaced by porting the plugin to be a
buildbot.util.service.HTTPClient implementation
## Deployment
The following deployment steps assume that the target system has a copy of
buildbot installed.
Various pieces of functionality _require_ that a copy of the
yocto-autobuilder-helper code be available in the home directory of the user
running buildbot at ~/yocto-autobuilder-helper.
__Note__: If using a reverse proxy be aware that modern buildbot uses a websocket for various communications between the master and the web UI.
Refer to the buildbot documentation for information on how to correctly configure a reverse proxy: http://docs.buildbot.net/latest/manual/cfg-www.html#reverse-proxy-configuration
### Upstream Yocto Project autobuilder
__on the controller__
#### on the controller_
```
$ buildbot create-master <yocto-controller>
$ cd <yocto-controller>
@ -77,11 +85,11 @@ $ $EDITOR <yocto-controller>/yoctoabb/services.py
$ $EDITOR <yocto-controller>/yoctoabb/www.py
<Configure and enable autorisation if desired>
$ $EDITOR <yocto-controller>/yoctoabb/config.py
<>
<Modify configuration options such as worker configuration, etc.>
$ buildbot start <yocto-controller>
```
__on the worker__
#### on the worker
```
$ buildbot-worker create-worker <yocto-worker> <localhost> <example-worker> <pass>
$ buildbot-worker start <yocto-worker>