https://github.com/masonm/hssonline_vagrant
https://github.com/masonm/hssonline_vagrant
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/masonm/hssonline_vagrant
- Owner: MasonM
- Created: 2016-03-08T00:53:21.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2016-03-08T00:53:54.000Z (over 10 years ago)
- Last Synced: 2025-05-24T01:47:43.756Z (about 1 year ago)
- Language: Shell
- Size: 36.1 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Overview
This repository contains code for creating a virtual machine using [Vagrant](https://www.vagrantup.com/) that can be used for developing or testing HSS projects. It handles provisioning a VM based on Ubuntu Linux 14.04, installing all necessary packages, cloning the three main HSS repositories ([newhssonline](https://bitbucket.org/hssonline/newhssonline), [django-conference](https://bitbucket.org/hssonline/django-conference), and [django-elect](https://bitbucket.org/hssonline/django-elect)), installing all necessary Python libraries, and setting up the MySQL databases and users.
# Guide
1. Create a [BitBucket](http://bitbucket.org) account if you don't have one and have Mason add you to the [hssonline team](https://bitbucket.org/hssonline/).
* Make sure to [configure Bitbucket to use your SSH key](https://confluence.atlassian.com/bitbucket/set-up-ssh-for-mercurial-728138122.html) if you haven't already.
2. Install [Vagrant](https://www.vagrantup.com/), [VirtualBox](https://www.virtualbox.org/), and [Mercurial](https://www.mercurial-scm.org/).
3. Clone this repository via `hg clone ssh://hg@bitbucket.org/hssonline/hssonline_vagrant` to a folder you want all the HSS projects to live. The projects will be placed in the parent directory of `hssonline_vagrant`.
4. Run `vagrant up hss` in the `hssonline_vagrant` directory. It will automatically download the files for the OS (~500MB).
* If you get the error `The Ansible software could not be found`, run `vagrant provision hss`
Once it's finished, you should be able to run the tests using the `./run_tests.sh` script and have everything pass.
To browse the site, run `./run_server.sh` to start the Django webserver. You should now be able to access it in your browser at `https://localhost:8000`. The site will run in DEBUG mode.
In order to populate the DB with a dump, place the .sql file in the `hssonline_vagrant` folder and load it with `vagrant ssh hss -c 'sudo mysql hssonline < /vagrant/DUMPFILENAME.sql'`.