Skip to content

ansible.md

Latest commit

 

History

History
74 lines (48 loc) · 1.88 KB

ansible.md

File metadata and controls

74 lines (48 loc) · 1.88 KB

Ansible

Using Ansible and Vagrant you can run many of the Queens programs in a Linux virtual machine, without needing to install all the different languages on your host machine.

You need to have this software installed to use Ansible with Vagrant:

Set up a Python3 virtual environment, following instructions in python.md.

Vagrant setup

Install the providers.

# vagrant plugin install vagrant-aws   # fails on macOS
vagrant plugin install vagrant-azure   # 2.0.0
vagrant plugin install vagrant-google  # 2.5.0

Creating the virtual machine

To create and provision the virtual machine with Vagrant, run this command:

vagrant up

The provisioning script downloads and installs a lot of different packages, and can take a while, depending on your internet connection speed.

Some HTTP downloads are not 100% reliable, so the script may fail. In case of a partial provision, or if you want to pick up changes to the provisioning script, re-run provisioning with this command:

vagrant provision

Running programs

To run any of the Queens programs in the virtual machine, we connect to the virtual machine using SSH. The project folder is shared in the virtual machine at /vagrant.

vagrant ssh
cd /vagrant

For example, to run using C:

clang/run.sh Queens 8 14

Shutting down the virtual machine

To stop the virtual machine but leave it available to run again:

vagrant halt

To destroy the virtual machine and free up space:

vagrant destroy

To restart the virtual machine later:

vagrant up

If you stopped the virtual machine with vagrant halt, it should restart quite quickly. If you destroyed it, it needs to be provisioned all over again.