Deploy Twitcher

Note

You can safely try the installation using Vagrant or Docker. See Testing.

Prepare

You need a recent Ansible version (>=2.7) on your local client:

$ ansible --version
ansible 2.7.2

If you don’t have Ansible installed, then follow these instructions: Requirements.

Get the Playbook

Clone this playbook from GitHub:

$ git clone https://github.com/bird-house/ansible-twitcher-playbook.git
$ cd ansible-twitcher-playbook

Customize Configuration

Configure your Twitcher installation. See Configuration:

$ cp etc/sample-twitcher-standalone.yml custom.yml
$ vim custom.yml

Running your playbook locally

Warning

If your system has already a Supervisor or a PostgreSQL installation, please remove them manually.

Warning

Make sure your Ansible directory is not world-readable, otherwise the ansible.cfg file will not be read. See Ansible Documentation.

If not already done (see Requirements), fetch required roles/recipes from ansible-galaxy:

$ ansible-galaxy -p roles -r requirements.yml install

Run your playbook locally:

$ ansible-playbook -c local playbook.yml

Note

You can also use the shortcut to run both:

$ make play

For remote deployment follow the instructions in the next section Live host deployment.