README.md 3.9 KB

MusareNode

Musare in NodeJS, Express, SocketIO and VueJS.

Requirements

Important Notes

The latest version of Vagrant (1.8.5) has some issues with inserting ssh keys into the machine. It's a show stopping bug that they aren't going to fix until the next release. So for now, I recommend using Vagrant 1.8.4. You'll also need to use a slightly older version of Virtualbox because of this.

Getting Started

Once you've installed the required tools:

  1. git clone https://github.com/MusareNode/MusareNode.git
  2. cd MusareNode
  3. cp backend/config/template.json backend/config/default.json

The secret key can be whatever. It's used by express's session module. The apis.youtube.key value can be obtained by setting up a YouTube API Key.

  1. vagrant up
  2. vagrant reload

This will ensure that the services we've created start up correctly.

Once this is done you should be able to access Musare in your local browser at 172.16.1.2. To access the RethinkDB admin panel, go to 172.16.1.2:8080 in your local web browser.

You can also now access your machine using:

vagrant ssh

Or if you have mosh installed (and have ran vagrant plugin install vagrant-mosh), you can run:

vagrant mosh

You can run vagrant to view more options.

Production Logs

You can view logs at the following locations:

  • Musare: /var/log/upstart/musare.log
  • mongoDB: /var/log/upstart/mongodb.log

Development

Make sure to vagrant ssh from the root of the repo before calling these (make sure your ssh'd into the vagrant machine).

# Start backend server
cd /musare; sudo node backend/app.js
	
# Build frontend in development mode
cd /musare/frontend; npm run development
	
# Build frontend in production mode
cd /musare/frontend; npm run production

# Automatically build frontend in development mode when files change
cd /musare/frontend; npm run development-watch

Production (these can also be used in development)

Make sure to vagrant ssh from the root of the repo before calling these (make sure your ssh'd into the vagrant machine).

# Start the production server
sudo service musare start

# Start the mongodb database server
sudo service mongodb start

FAQ

What does vagrant up do?

This will pull down the Ubuntu 14.04 vagrant box and setup a virtualbox machine for you. It'll ask you what network interface you want the virtualbox machine to connect to the internet with. On macOS I typically choose en0: Wi-Fi (AirPort), but it'll be different on different platforms. It will then run the commands in the bootstrap.sh file on this virtual machine. This will install nodejs, rethinkdb, and a bunch of other goodies. This same file could be ran on a production Ubuntu 14.04 server with very little modifications (if any at all).

What does vagrant ssh and vagrant mosh do?

Vagrant automagically generates and inserts a openssh keypair for you. This doesn't really have any security (as it doesn't really need to be since it's only for development). This allows you to access your machine in a very convenient way. The second command, vagrant mosh, is actually just a vagrant plugin. Mosh is a replacement for SSH, and if you haven't checked it out before, you really should! :)

Why use Vagrant? I can run NodeJS and mongoDB locally

The reason for using vagrant is simple. It gives every developer the same local development server. This removes any inconsistencies across different dev enviroments (Windows vs macOS vs Linux). It also ensures that your changes are running on an environment that exactly matches the production server.