Welcome to Martingale, this guide will walk you through installing and configuring a local standalone version of Martingale that later will be extended with Packs and proxied through Kong to support Google OAuth as a singin option.
Table of Contents
Prerequisites
In order to run Martingale locally you will need a few tools installed:
- Node.js 8.4.x - Install via NVM
- Yarn Package Manager
- Docker - Recommended but not required (You can also use the easy install script at https://get.docker.com/)
- Kong 0.10.3 (or the Docker version) - Recommended but not required
Installation
Clone the Martingale-UI Git Repo from https://github.com/pearsontechnology/martingale-ui to a new folder structure martingale/ui:
git clone git@github.com:pearsontechnology/martingale-ui.git martingale/ui
Change to the new folder and run yarn install:
cd martingale/ui
yarn install
Start Martingale in standalone mode serving the default Martingale and Documentation packs:
yarn start
Your browser should now open and load http://localhost:3000 displaying the default Martingale home page and two navigation menus. Under each of these menus are different pages within Martingale to help you get acquainted.
- Martingale
- Kitchen Sink - Shows most of the controls available within Martingale Packs.
- Designer - A simple playground where you can enter YAML source and view the output page design.
- Documentation
- Getting Started - This guide
- Configuration Basics - Talks about the different configuration options available within config.json
- Installing packs - Install the Kong Pack and hook it up to the new installation of Martingale
- Dockerize - Explains how to create a Docker image from your installation
- Building Packs - HTTPBin pack, the "Hello World" of Marginale
- Extended Packs - Packs that use or load other packs