Adding spatial data with Git

Adding spatial data with Git

Overview

This document provides high level guidelines for adding layers to MoL using our Git repository. Git is a free & open source distributed version control system that we use as a mechanism for adding layers to the system.

Getting started

Note: You will need the Git repository password for adding layers to MoL.

Basically you just need to download and install a Git client program to your computer. Next, make sure you have an SSH client installed, then edit the ~/.ssh/config file in your home directory by adding the following lines:

Host mol.colorado.edu
  Port 312

Finally you just need to clone (donwload) the MoL Git repository. You only have to do this once. The process for this varies depending on your Git client, but for terminal based clients, you can simply type the following command (this is where you will need the password):

git clone git@mol.colorado.edu/mol-data

This will download the full repository (approximately 1GB) to your computer. After cloning is done (again, you only have to clone the repository once), you can start adding layers to the mol-data sub-directory that was assigned to you by MoL. To make the layers available to the system, you just need to add, commit, and push them to the remote Git repository by typing the following Git commands:

git add .
git commit -m 'Adding new layers'
git pull
git push

After the layers have completed uploading to the remote repository, you're all set. The system will automatically detect the new layers and will schedule them to be added to the system.