Add docs for web server component

Change-Id: I8e23494e86ad0c9aa2bd074c0e19813be774b4fe
This commit is contained in:
David Shrewsbury 2017-07-11 12:41:59 -04:00
parent 91fad2609f
commit ae734d1b82
2 changed files with 41 additions and 0 deletions

View File

@ -323,3 +323,41 @@ currently running jobs have completed, run ``zuul-executor graceful``.
To enable or disable running Ansible in verbose mode (with the '-vvv' To enable or disable running Ansible in verbose mode (with the '-vvv'
argument to ansible-playbook) run ``zuul-executor verbose`` and argument to ansible-playbook) run ``zuul-executor verbose`` and
``zuul-executor unverbose``. ``zuul-executor unverbose``.
Web Server
----------
The Zuul web server currently acts as a websocket interface to live log
streaming. Eventually, it will serve as the single process handling all
HTTP interactions with Zuul.
Configuration
~~~~~~~~~~~~~
In addition to the ``gearman`` common configuration section, the following
sections of **zuul.conf** are used by the web server:
web
"""
**listen_address**
IP address or domain name on which to listen (default: 127.0.0.1).
``listen_address=127.0.0.1``
**log_config**
Path to log config file for the web server process.
``log_config=/etc/zuul/logging.yaml``
**pidfile**
Path to PID lock file for the web server process.
``pidfile=/var/run/zuul-web/zuul-web.pid``
**port**
Port to use for web server process.
``port=9000``
Operation
~~~~~~~~~
To start the web server, run ``zuul-web``. To stop it, kill the
PID which was saved in the pidfile specified in the configuration.

View File

@ -33,6 +33,9 @@ Zuul provides the following components:
merger if dedicated mergers are not provided. One or more of merger if dedicated mergers are not provided. One or more of
these must be run. these must be run.
- **zuul-web**: A web server that currently provides websocket access to
live-streaming of logs.
- **gearman**: optional builtin gearman daemon provided by zuul-scheduler - **gearman**: optional builtin gearman daemon provided by zuul-scheduler
External components: External components: