Parse Server with MongoDB ReplicaSet using Docker

This branch is for AWS EC2

If you want to use Google Cloud Platform, try GCP branch

Notes

It's probably not a good idea to run this setup in production as each mongo instance should be split across different machines. However for a single ec2 instance environment this fits our needs.

Usage

• Start and show logs (turn off logs : ctrl+c)

   $ docker-compose up -d && docker-compose logs -f
   (or)
   $ ./prod_start.sh

• Stop

   $ docker-compose down
   (or)
   $ ./prod_stop.sh

• Restart parseapi container

   $ docker-compose restart parseapi
   (or)
   $ ./prod_restart.sh

Setup

Init MongoDB

1. Initial replicaset

   $ docker-compose -f docker-compose-init.yml up
   (Stop after all work is done : ctrl + c)

2. Copy, remove '_sample' from the name, and change password these files

   • /scripts/config_sample.sh > /scripts/config.sh
   • /parse-server/config_sample.sh > /parse-server/config.sh
   • /parse-server/config_dev_sample.sh > /parse-server/config_dev.sh

3. Add authentication

   $ docker-compose -f docker-compose-addauth.yml up
   (Stop after all work is done : ctrl + c)

   If added user failed, retry until shown 'Successfully added user'.

Change Parse-server Keys

• You need to change Parse-server keys in these files.

  • /parse-server/config.sh
  • /parse-server/config_dev.sh

• For making new keys, I recommend to use randomkeygem.com

Parse-server

• Default address

   $ curl http://localhost/parse

• Dashboard (Web Data Browser)

   http://localhost/dashboard

Parse Server external path

• 'parse-server/cloud' and 'parse-server/public' are accessable volume.
  • you can modify them and restart parseapi container for deploy.

Development

• The MongoDB can be remotely located instance and you can run the local parse-server to facilitate cloud-code development.

   docker-compose -f docker-compose-dev.yml up -d && docker-compose logs -f
   (or)
   $ ./dev_start.sh

Access Bash shell of Container

• Check Status of Docker containers

   $ docker ps
   CONTAINER ID        IMAGE               COMMAND                  CREATED              STATUS              PORTS                                                NAMES
   b1ea1556bbf6        node:6              "/parse/setup.sh"        About a minute ago   Up About a minute   0.0.0.0:1337->1337/tcp                               dockerparsemongo_parseapi_1
   12cfb5cdbfd8        mongo:3.4           "mongod --replSet ..."   About a minute ago   Up About a minute   0.0.0.0:27017->27017/tcp, 0.0.0.0:28017->28017/tcp   dockerparsemongo_mongo1_1
   1c2627bb53a7        mongo:3.4           "mongod --replSet ..."   About a minute ago   Up About a minute   0.0.0.0:27019->27017/tcp, 0.0.0.0:28019->28017/tcp   dockerparsemongo_mongo2_1
   eb3996cdf662        mongo:3.4           "mongod --replSet ..."   About a minute ago   Up About a minute   0.0.0.0:27018->27017/tcp, 0.0.0.0:28018->28017/tcp   dockerparsemongo_mongo3_1

   $ docker-compose ps
               Name                           Command               State                          Ports                        
   ----------------------------------------------------------------------------------------------------------------------------
   dockerparsemongo_mongo1_1       mongod --replSet rs0 --jou ...   Up       0.0.0.0:27017->27017/tcp, 0.0.0.0:28017->28017/tcp
   dockerparsemongo_mongo2_1       mongod --replSet rs0 --jou ...   Up       0.0.0.0:27019->27017/tcp, 0.0.0.0:28019->28017/tcp
   dockerparsemongo_mongo3_1       mongod --replSet rs0 --noj ...   Up       0.0.0.0:27018->27017/tcp, 0.0.0.0:28018->28017/tcp
   dockerparsemongo_mongosetup_1   /scripts/setup.sh                Exit 0                                                      
   dockerparsemongo_parseapi_1     /parse/setup.sh                  Up       0.0.0.0:1337->1337/tcp

• Access shell of Parse-server container with

  • docker exec -it dockerparsemongo_parseapi_1 bash
  • docker-compose exec parseapi bash

• Access shell of MongoDB container with

  • docker exec -it dockerparsemongo_mongo1_1 bash

  • docker-compose exec mongo1 bash

  • And, access mongo shell using mongo

Host O/S Guide

Choose your favorite Linux, such as AML or Ubuntu. Docker and Docker-Compose are required.

Add swap

• t1-micro has 1Gb memory, requires swap

   $ sudo fallocate -l 2G /swapfile
   $ sudo chown root:root /swapfile
   $ sudo chmod 600 /swapfile
   $ sudo mkswap /swapfile	
   $ sudo swapon /swapfile
   $ sudo swapon -a
   $ sudo vi /etc/fstab
   
   (Add it to the last line.)
   /swapfile   swap   swap   defaults  0  0
   
   $ sudo swapon -s
   $ free -m

MongoDB Storage for EC2

• When created EC2 instance, add 3 ebs volumes for db path.

• mount ebs volumes to './data/rs0-1', './data/rs0-2', './data/rs0-3'

• The free tier provides 30 GB of storage, I recommend this capacity configuration.

  • host : 9 GB / rs0-1 : 10 GB / rs0-2 : 10 GB / rs0-3 : 1 GB

   $ sudo mkfs.ext4 /dev/xvdb
   $ sudo mkfs.ext4 /dev/xvdc
   $ sudo mkfs.ext4 /dev/xvdd
   $ echo '/dev/xvdb __your-path__/data/rs0-1 ext4 defaults,auto,noatime,noexec 0 0
   /dev/xvdc __your-path__/data/rs0-2 ext4 defaults,auto,noatime,noexec 0 0
   /dev/xvdd __your-path__/data/rs0-3 ext4 defaults,auto,noatime,noexec 0 0' | sudo tee -a /etc/fstab

MongoDB Guide

MongoDB Backup & Restore

• I recommend to use aws ebs snapshot for backup & restore.
  • lambda-ec2-snapshots
• And, you can read it.
  • EC2 Backup and Restore
  • MongoDB point-in-time recoveries

Management MongoDB

• I reccommend to use adminMongo
  • Thank you @mrvautin

Inspired & Referenced by

• soleo/docker-mongodb-replicaset
• yeasy/docker-compose-files
• b00giZm/docker-compose-nodejs-examples
• ParsePlatform/parse-server-example