HubDrop Server

This project is used to develop & deploy HubDrop. You want Vagrant 1.6 or later.

This project now uses Ansible for radically simple provisioning.

Local Development Setup

Everything is now built into the Vagrantfile. To get an instance of hubdrop running, simply:

1. Clone this repo and change directory:

$ git clone [email protected]:hubdrop/server.git HubDrop
$ cd HubDrop

2. Vagrant up:

$ vagrant up

Then, you should be able to visit http://hubdrop.local

The Vagrantfile will clone the hubdrop app source for you and provision a vagrant server.

Vagrant will handle saving a hosts file record so when you are done with vagrant up simply visit and you should see the website.

If you are working on interactions with github or drupal.org, you will need to...

3. Add Authorizations.

There is an easy to use configure command to setup your github authorization and drupal.org password. It must be called within the VM.

$ vagrant ssh
vagrant@hubdrop $ sudo su - hubdrop
hubdrop@hubdrop $ hubdrop configure

4. Mirror all the repos.

You can mirror all the already-mirrored repos by running hubdrop mirror:all

Server Deployment

Updating with Ansible

To update the server, you must be able to SSH in as root, and you must have ansible installed, and you must have this repository cloned.

Once you do, simply run:

ansible-playbook -i inventory playbook.yml --sudo 

Using Vagrant to Deploy

Vagrant can be used to provision servers on digitalocean.com.

To launch a hubdrop server on digitalocean.com, first install the vagrant plugin:

vagrant plugin install vagrant-digitalocean

Then change to the digitalocean directory

$ cd digitalocean
$ vagrant

The first time you call "vagrant", it will create an empty file located at ./digitalocean/.vagrant/digitalocean.yml.

Add size: 2GB to adjust the size of the droplet.

Edit this file with your Digital Ocean Client ID and API key.

After that, you can simply call vagrant up --provider=digital_ocean to create a new droplet!

$ vagrant up --provider=digital_ocean
Bringing machine 'default' up with 'digital_ocean' provider...
==> default: Using existing SSH key: Vagrant
==> default: Creating a new droplet...
==> default: Assigned IP address: 0.0.0.0
==> default: Rsyncing folder: /home/jon/Projects/Hubdrop/Server/ => /vagrant...
==> default: Checking for host entries
==> default: Running provisioner: ansible...

One provisioned, you can do everything you can with a virtual server:

vagrant ssh will ssh you into the server. vagrant destroy will destroy the droplet. vagrant provision will re-run the ansible playbook.