Metamaps Docker

Metamaps is a free and AGPL open source technology for changemakers, innovators, educators and students. It enables individuals and communities to build and visualize their shared knowledge and unlock their collective intelligence. You can find out about more about the project at the blog.

You can find a version of this software running at metamaps.cc, where the technology is being tested in a private beta.

This repository is some scripts to get yourself a docker container up and running, for use in development and production. Tweak it as necessary and open issues specifically related to annoyances or problems with the dockerized Metamaps here. Please use the main metamaps respository for all other issues related to the metamaps platform itself.

If you don't have docker installed, you should probably Google it.

Type this if you want Docker for Ubuntu 14.04

 $ curl -sSL https://get.docker.com/ubuntu/ | sudo sh

Installation

Simple clone the repository and make use the ./docker.sh script to build, run, and provision the docker container(s). If you know what you're doing, it's easy to use the Dockerfile directly. If you are a scripting ninja who would like to help us grasshoppers improve our scripts, then pull request it!

 # clone this repository
 $ git clone https://github.com/metamaps/metamaps_gen002 metamaps-docker

This is our repository's structure.

# default development instance		
├── config 
│   ├── database.yml
│   └── Dockerfile

# script to perform common tasks for MetaMaps
├── docker.sh

# will be downloaded later
├── src
└── volumes

Usage

docker.sh is the file

Prepare

 # clones repo and applies configuration from the config directory
 $ ./docker.sh prepare
 
 # If it succeeded you will have a new ./src folder

Build

 # pulls "rails" docker image...
 # copies gem lock, installs ruby gems...
 # copy src into container...
 $ ./docker.sh build
 
 # this will take a while the first time, but caches layers and goes quickly later
 # rerun this when you change the src, or gems

Run Containers

 # Pulls and runs the postgres container
 $ ./docker.sh run db 
 
 # Run the metamaps container
 $ ./docker.sh run mm
 
 # verify this succeeded by typing 
 $ docker ps

Seed Postgres DB

$ ./docker.sh seed

Contributing

Fork it!
Create your feature branch: git checkout -b my-new-feature
Commit your changes: git commit -am 'Add some feature'
Push to the branch: git push origin my-new-feature
Submit a pull request :D

History

TODO: Write history

Credits

Credits to the Metamaps team for an awesome platform!

The dockerization was put together and contributed by Daniel Sont =].

License

Have fun, see MetaMaps License.