01010010

This repository contains configuration and management code for 01010010, our public errbot instance on Gitter.

This document and the code contained within this repository is intended for core project contributors. People curious about our deployment process are most welcome to check it out, but it is of no interest otherwise.

Webhooks

01010010 can be reached via webhook at https://gitter.errbot.net/.

Jenkins

A Jenkins instance is available at https://jenkins.errbot.net to help manage 01010010.

Jobs relevant to 01010010 are accessible only to members of the errbotio core team.

The Track 01010010 repository job is triggered via GitHub webhook whenever a commit is made to the master branch.

It will trigger seperate jobs to update the repository checkout in /srv/errbot and perform an upgrade of the bot code.
The Track errbot repository job is triggered via GitHub webhook whenever a commit is made to the errbotio/errbot master branch.

This will trigger an update of submodules which will cascade down through the update pipeline.

Scripts

update_repository.sh: Update the repository (and its submodules) to the latest version on GitHub.
update_submodules.sh: Update the submodules included in this repository. The result may be published to GitHub automatically by specifying --publish as an argument.
upgrade_bot.sh: Upgrade (and restart) the bot after updating the code bundled with this repository.

Note: All scripts expect to be run from the repository root.

Server setup

01010010 is installed into /srv/errbot/ and runs under the user errbot. The bot process is managed by supervisor (program name = errbot-gitter).

Directory layout

/srv/errbot/virtualenv: The Python virtualenv used to run the bot
/srv/errbot/data: The bot data directory
/srv/errbot/extra_backends: Extra backends (err-backend-gitter) go here. (Note: This is a git submodule!)
/srv/errbot/repository: This directory contains the code for errbot. (Note: This is a git submodule!)

Important commands

sudo supervisorctl status errbot-gitter
sudo supervisorctl stop errbot-gitter
sudo supervisorctl start errbot-gitter
sudo supervisorctl restart errbot-gitter
sudo supervisorctl tail errbot-gitter
sudo supervisorctl tail -f errbot-gitter
less /var/log/supervisor/errbot-gitter.log