toaster-manual: update runbuilds instructions
Added sample configuration files and instructions for the runbuilds systemd service. Service runs runbuilds in a screen session for user convenience. User can attach to the session to see the runbuilds output, monitor logs and build environment. (From yocto-docs rev: 40beaa575fb96a06992a1d62bb45cd0cbbe2ae86) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
parent
3d24037b76
commit
4e017740b7
|
@ -440,22 +440,53 @@
|
||||||
</literallayout>
|
</literallayout>
|
||||||
</para></listitem>
|
</para></listitem>
|
||||||
<listitem><para>
|
<listitem><para>
|
||||||
Install the build runner service.
|
Prepare the systemd service to run Toaster builds.
|
||||||
This service needs to be running in order to dispatch
|
Here is a sample configuration file for the service:
|
||||||
builds.
|
|
||||||
Use this command:
|
|
||||||
<literallayout class='monospaced'>
|
<literallayout class='monospaced'>
|
||||||
/var/www/toaster/poky/bitbake/lib/toaster/manage.py runbuilds
|
[Unit]
|
||||||
|
Description=Toaster runbuilds
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
Type=forking
|
||||||
|
User=toaster
|
||||||
|
ExecStart=/usr/bin/screen -d -m -S runbuilds /var/www/toaster/poky/bitbake/lib/toaster/runbuilds-service.sh start
|
||||||
|
ExecStop=/usr/bin/screen -S runbuilds -X quit
|
||||||
|
WorkingDirectory=/var/www/toaster/poky
|
||||||
|
|
||||||
|
[Install]
|
||||||
|
WantedBy=multi-user.target
|
||||||
</literallayout>
|
</literallayout>
|
||||||
Here is an example:
|
Prepare the <filename>runbuilds-service.sh</filename>
|
||||||
|
script that you need to place in the
|
||||||
|
<filename>/var/www/toaster/poky/bitbake/lib/toaster/</filename>
|
||||||
|
directory by setting up executable permissions:
|
||||||
<literallayout class='monospaced'>
|
<literallayout class='monospaced'>
|
||||||
#!/bin/sh
|
#!/bin/bash
|
||||||
# toaster run builds dispatcher
|
|
||||||
cd /var/www/toaster/
|
#export http_proxy=http://proxy.host.com:8080
|
||||||
source ./venv/bin/activate
|
#export https_proxy=http://proxy.host.com:8080
|
||||||
./bitbake/lib/toaster/manage.py runbuilds
|
#export GIT_PROXY_COMMAND=$HOME/bin/gitproxy
|
||||||
|
|
||||||
|
cd ~/poky/
|
||||||
|
source ./oe-init-build-env build
|
||||||
|
source ../bitbake/bin/toaster $1 noweb
|
||||||
|
[ "$1" == 'start' ] && /bin/bash
|
||||||
</literallayout>
|
</literallayout>
|
||||||
</para></listitem>
|
</para></listitem>
|
||||||
|
<listitem><para>
|
||||||
|
Run the service:
|
||||||
|
<literallayout class='monospaced'>
|
||||||
|
# service runbuilds start
|
||||||
|
</literallayout>
|
||||||
|
Since the service is running in a detached screen
|
||||||
|
session, you can attach to it using this command:
|
||||||
|
<literallayout class='monospaced'>
|
||||||
|
$ sudo su - toaster
|
||||||
|
$ screen -rS runbuilds
|
||||||
|
</literallayout>
|
||||||
|
You can detach from the service again using "Ctrl-a"
|
||||||
|
followed by "d" key combination.
|
||||||
|
</para></listitem>
|
||||||
</orderedlist>
|
</orderedlist>
|
||||||
You can now open up a browser and start using Toaster.
|
You can now open up a browser and start using Toaster.
|
||||||
</para>
|
</para>
|
||||||
|
|
Loading…
Reference in New Issue