Public | Automated Build

Last pushed: 10 months ago
Short Description
Kernel image with DG dependencies and tools baked in
Full Description

timbr-omnibus

Monorepo for most RADD-related apps and libs.

Managed by lerna.

Below are basic setup instructions. See the :open_file_folder: docs directory for
more detailed information.

Setup

You must do all of these steps, in the order specified below. Please read and follow each one carefully (including the bullet points inside the steps). Failure to do so, or proceeding anyway even when a step fails, is likely to create lots of complications.

  1. Set up accounts.

  2. Clone this repo using SSH

  3. Make sure all our required env vars have been added permanently to your environment. (Contact @jed or @pramukta for access.)

    On systems with a bash shell (tested on OS X) you can do this by editing the .bashrc file: vim ~/.bashrc. Add all EXPORT lines to the end of the file.

    NOTE: The above vars include a path in TWOLA_DATA that defaults to
    '/Users/twola-data'. The app will store its data here. You will need to do ONE of the following:

    • Create that /Users/twola-data directory and make sure your user has write
      permissions. To do this in *nix systems use the following commands:
      mkdir /Users/twola-data
      sudo chown -R <username> /Users/twola-data
      If you don't know your username it can be found with the command whoami

    • Point to a different directory in TWOLA_DATA.

  4. Edit sudoers.

    Because of Docker's virtual environment, directories created by the app need
    to have a user id recognized both inside and outside of containers. On many
    *nix systems (tested on OS X), you can enable this as follows:

    a. $ sudo visudo

    b. Add a new line at the end of the "User privilege specification" section:

       %admin  ALL=(ALL) NOPASSWD: /usr/sbin/chown -R 2001*
    
  5. Set up your db and elasticsearch.

    This assumes you have Docker on your machine already.

    If you already have mongo, put your connection url in
    a TIMBR_WAMPIFY_DATABASE env var. Otherwise you can:

    $ docker run --name mongo -d -p 27017:27017 mongo
    

    If you already have elasticsearch running somewhere you can put the
    connection string in TWOLA_ELASTICSEARCH_1. Otherwise you can:

    $ docker run --name elasticsearch -d -p 9200:9200 -p 9300:9300 elasticsearch:2
    
  6. Bootstrap the app.

    NOTE: You will need a recent version of node. We recommend nvm but you can also use Homebrew or your modern package manager of choice.

    ~/timbr-omni $ git checkout development
    ~/timbr-omni $ npm i -g lerna
    ~/timbr-omni $ npm i
    ~/timbr-omni $ lerna init
    ~/timbr-omni $ lerna bootstrap # <-- may take a long time
    
  7. Get the docker images.

    This assumes you have Docker on your machine already.

    $ docker login # this will prompt for your dockerhub creds
    ~/timbr-omni $ lerna run pull-images
    

Use

~/timbr-omni $ npm run dev

The app is running at http://localhost:3000.

Docker Pull Command
Owner
timbr
Source Repository