A D-CENT project: an easily deployable oauth server for small organisations.
There has been an update to the deployment script
deploy_prod.sh. If you have deployed an instance of Stonecutter to an Ubuntu server using Ansible, you will need to rerun the last two steps of the deployment: Configure with ansible and Deploy application to the server.
You can develop and run the application in a VM to ensure that the correct versions of Stonecutter's dependencies are installed. You will need VirtualBox, Vagrant and Ansible installed.
First, clone the repository.
Navigate to the ops/ directory of the project and run:
vagrant up development
The first time this is run, it will provision and configure a new VM.
When the VM has started, access the virtual machine by running:
vagrant ssh
The source folder will be located at /var/stonecutter.
After initial setup, navigate to the source directory and build the assets with:
cd /var/stonecutter
gulp build
To start the app, run:
./start_app_vm.sh
To start a web server for the application in development mode, run:
lein ring server-headless
NB: running the application like this will save users into an in memory cache that will be destroyed as soon as the app is shutdown.
To run all tests, use this command:
lein test
Commands and aliases can be found in the project.clj file.
Simply type:
gulp server
The Continuous Delivery build and deployment architecture is documented here.
The Hosting Architecture is documented here.
To deploy using Docker, see here.
To deploy to an Ubuntu server using Ansible, see here.