Tools for standing up and managing a CommCare HQ server environment.
Docs at https://dimagi.github.io/commcare-cloud/ .
- Ansible
- Fabric
- configurable environments (under
environments/) - Assorted small tools for managing and accessing servers
- Command line interface (
commcare-cloud) for running commands backed by the other components
You will need python 2.7.12+ and virtualenvwrapper installed to follow these instructions:
sudo apt-get install git python-dev python-pip
sudo pip install virtualenv virtualenvwrapper --ignore-installed six
This should be run from your home directory:
source <(curl -s https://raw.githubusercontent.com/dimagi/commcare-cloud/master/control/init.sh)
Alternately:
git clone https://github.com/dimagi/commcare-cloud.git
source commcare-cloud/control/init.sh
You may now use commcare-cloud or its shorter alias cchq whenever you're in the virtualenv.
We also recommend that you put the following in your ~/.profile which gives you access to the tool
from anywhere:
export PATH=$PATH:~/.commcare-cloud/bin
source ~/.commcare-cloud/repo/control/.bash_completion
Before making any commits, make sure you install the git hooks:
./git-hooks/install.sh
This will make sure you never commit an unencrypted vault.yml file.