Koha Sandbox Server

The Koha Sandbox Server is a system to allow easy testing of Koha patches and git branches.

It is powered by Docker, Ansible and Perl. It uses koha-testing-docker to create each Koha sandbox.

Installation

Starting with a Debian 9 system:

• Install the latest release of Ansible
• Become root user
• Clone this repository
• cd to the git clone
• Copy ansible/vars/user.yml.example to ansible/vars/user.yml
• Update ansible/vars/user.yml for your domain and account
• Run ./setup-sandbox-server.sh
• Browse to the domain you entered as SANDBOX_HOST_DOMAIN in your user.yml

Features

• Create and destroy Koha instances dyanmically
• Web-based viewing of logs
• Ability to sign off bugs from web
• Apply Koha bugs by community bug number
• Test Koha branches from arbitrary git repositories
• Restart Koha services ( koha-common, apache, memached ) from the web
• Re-index Zebra from the web
• Delete the database and start fresh without reprovisioning from the web

Future Goals

• Add ability to run specific unit tests from web
• Add ability to select a pre-generated database list ( also we need to generate those databases )
• Allow ssh to koha containers, either through web or cli
• Dockerize such that sandbox host needs only Docker. Ansible, the web app, and the daemon will run from a container and steer the host Docker daemon via Ansible.

Guide

Using a htpasswd

Using a password should be set before provisioning. Otherwise you'll need to reprovision after following the instructions below.

• sudo apt-get install apache2-utils
• sudo htpasswd -c /etc/apache2/.htpasswd <username>
• Edit ansible/vars/user.yml, set USE_HTPASSWD to true