salsa-nathan / ckan_284_vagrant

ckan_284_vagrant

A Vagrant based local development setup for CKAN 2.8.4

Local Setup

1. Clone this repository

2. Install vagrant, https://www.vagrantup.com/docs/installation/

3. Install some vagrant extensions, run this on your CLI

    vagrant plugin install vagrant-hostmanager
    vagrant plugin install vagrant-cachier
    vagrant plugin install vagrant-vbguest
   

4. Install any git submodules:

    git submodule init
    
    git submodule update
   

5. Launch the Vagrant box:

    cd vagrant
    
    vagrant up
   

6. SSH into the Vagrant box and launch the CKAN instance:

    vagrant ssh
    
    . /usr/lib/ckan/default/bin/activate
    
    paster serve --reload /etc/ckan/default/development.ini
   

7. Browse your local CKAN instance:

    http://ckan284.loc:5000
   

Test database

The setup_ckan script imports a CKAN database with some test data setup:

1. test organisation

2. test dataset

3. test users (all p/w: password):

   • admin
   • org_admin
   • org_editor
   • org_member
   • test_user (no affiliations)

4. test groups

   • Group 1
   • Group 2

Bash aliases

After vagrant ssh you can use the following commands:

serve - stop & start Solr, then serve CKAN

reserve - serve CKAN without stopping & starting Solr.

jobworker - start the CKAN Job Worker.