Cradle

Infrastructure definitions for MoodyTunes

Getting Started

• Create a directory on your computer to hold the MoodyTunes repositories

mkdir MoodyTunes && cd MoodyTunes

• Clone this repository and the moodytunes repository

git clone [email protected]:Moody-Tunes/cradle.git git clone [email protected]:Moody-Tunes/moodytunes.git

• Install virtualbox
• Install vagrant and add to $PATH
• Install vagrant plugins
  • vagrant plugin install vagrant-hostmanager
• Create and activate a python3 virtual environment: python3 -m venv venv
• Install dependencies: (venv) pip install -r requirements.txt
  • If you can't install ansible because of dependencies, you might need to install libffi-dev

Installing and booting Virtual Machine

• Bring up virtual machine with Vagrant: vagrant up mtdj

  • This should download the Ubuntu 18.04 virtualbox (might take a while the first time) and provision the box with the needed site programs, dependencies, and tools needed to run MoodyTunes

• The site is available through the hostname moodytunes.vm.

  • This is accomplished by vagrant-hostmanager adding the IP address for the virtual machine to your /etc/hosts file

• Now you can ssh into your virtual machine and run the application

  • We add a config file in your .ssh/ directory with the hosts managed by Vagrant called vagrant_config
  • You can use this file in ssh by passing it on the command line as an argument ssh -F ~/.ssh/vagrant_config moodytunes.vm
  • We also offer some aliases for making this command easier to use in scripts/ssh_aliases. You can add these aliases to your ~/.bash_aliases file to use them in your development: cat scripts/ssh_aliases >> ~/.bash_aliases

Specifying Provisioning Inventory

By default, ansible will use the inventory file defined in the inventory/local file. This will set ansible to provision a local instance of moodytunes, so if you're a developer you shouldn't have to worry about it. If you happen to be provisioning an instance outside of a local environment you can specify the inventory file to use with the -i option to ansible.

ansible-playbook -i inventory/prod site.yml