Standard administration of a khoe server is currently performed by executing ansible-playbook commands logged-in as user khoe on the server. (This will be replaced with a web frontend.)
For development however it is much more convenient to fall back to typical Ansible execution from a "control machine", e.g. your personal machine.
For remote development from your work machine some additional steps are required:
on work machine
- Install ansible
- Clone the khoe-nas project to a local workspace:
git clone --branch develop https://github.com/khoe-cloud/khoe-nas.git khoe-nas ansible-galaxy install -r requirements.yml(satisfy dependencies; installs toroles/_galaxy)sudo easy_install pip && pip install --user passlib(Mac only, needed for password hashing in user:create task)- Edit the file
ansible.cfg: search forinventoryand un/comment the development/localhost lines respectively. By default thelocalhostline is uncommented. - Enter the correct hostname in
inventory/development[default: khoe.lan].
To add to the backup protocols supported by Khoe the following files need to be edited:
inventory/host_vars/example.ymlroles/duply/tasks/backup.ymlroles/duply/tasks/restore.ymlroles/duply/tasks/fetch.yml
For testing [hostname].yml needs to be amended too.