The tree contains Ansible code to build and manage the various IHTSDO services. It does not contain configuration data.

Getting started

Install ansible e.g. brew install ansible or pip install ansible. See the Ansible docs for detailed information.

There is an ansible playbook that will point the files and inventory symlinks.

$ ansible-playbook -i .local.ini setup_ansible_inventory.yml -e inventory_path=<your_inventory_location>

Note that your_inventory_location must contain directories files and inventory containing files used by the various modules and the inventory files. It should be an absolute path.

ansible-playbook must alway be run in the ihtsdo-ansible directory

Running playbooks

Playbooks are run in typical ansible fashion by passing the inventory file to use and naming the playbook.

$ ansible-playbook -i inventory/live.ini build_environment.yml

You can also specific the user to login as with -u .

Setting up a new machine

ansible-playbook -i inventory/<INVENTORY_FILE.ini> system_setup.yml -u <username> --limit <machine>

see https://github.com/IHTSDO/ops-docs/wiki

SSH

Ansible uses SSH as a transports. These means you can use ~/.ssh/config to set connection defaults. It's useful to add lines such as

Host *.ihtsdotools.org
  User myihtsdousername

to that file.

Further Reading

For more information on using this repository, see the IHTSDO Ops Docs