HenryHengZJ/Outerbridge_AWS_Host.md

## Outerbridge_AWS_Host.md

      
    Raw
  

              Outerbridge_AWS_Host.md
            
          
    Launch EC2 Instance

This walkthrough will skip how to launch an EC2 instance. There's plenty of resources and tutorial on how to do that.
In this case we are launching a EC2 instance with t2.micro.
After EC2 instance has successfully spinned up, SSH into EC2 instance.
Install Node


curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.34.0/install.sh | bash


. ~/.nvm/nvm.sh


nvm install --lts


Install Yarn

npm install yarn -g

Install MongoDB

Follow instruction: https://www.mongodb.com/docs/manual/tutorial/install-mongodb-on-amazon/


sudo nano /etc/yum.repos.d/mongodb-org-6.0.repo


Copy paste the following into the file you just created above:
[mongodb-org-6.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/amazon/2/mongodb-org/6.0/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-6.0.asc

Ctrl+X to exit, press Y to save the file.

sudo yum install -y mongodb-org


sudo systemctl start mongod


sudo systemctl status mongod


sudo systemctl enable mongod


Install Git

sudo yum install git -y

Install pm2

npm install pm2 -g

Setup the project

Two ways to setup:
Install Outerbridge via NPM:


npm install -g outerbridge


npx outerbridge start


App is now ready on port 3000.
To view the app, create 2 new inbound rules on the EC2 instance. Custom TCP Port 3000 that allows anywhere to access.
You can then view the app: "Your Public IPv4 DNS":3000. Example: http://ec2-18-222-246-22.eu-west-1.compute.amazonaws.com:3000

Install via Github


git clone https://github.com/Outerbridgeio/Outerbridge.git


cd Outerbridge


yarn setup


yarn bootstrap

Depending on your RAM size, for t2.micro this could take a while.

yarn build


yarn start


App is now ready on port 3000.
To view the app, create 2 new inbound rules on the EC2 instance. Custom TCP Port 3000 that allows anywhere to access.
You can then view the app: "Your Public IPv4 DNS":3000. Example: http://ec2-18-222-246-22.eu-west-1.compute.amazonaws.com:3000

Troubleshoot yarn bootstrap

In cases where t2.micro is taking forever on yarn bootstrap, here is the workaround:

Install the dependencies of each package independently. cd into each package: ui, components and server and do yarn install for each of them.
Back to the Outerbridge root path, do yarn bootstrap. Because the dependencies have been installed, the operation could be faster.

Troubleshoot yarn build

Most of the time, it is stuck at building the ui folder. As a temporary workaround:

Back to your EC2 home path (/home/ec2-user/) and do
git clone https://github.com/Outerbridgeio/OuterbridgeUIBuild.git


Copy the build folder to Outerbridge ui folder:
cp -r OuterbridgeUIBuild/build/ Outerbridge/packages/ui/


cd Outerbridge


Build server and components independently. cd into package: components and server and do yarn build for each of them.
Back to the Outerbridge root path, do yarn start to see if app can be started.

Using NGINX

If you want to get rid of the :3000 on the url and have a custom domain, you can use NGINX to reverse proxy port 80 to 3000. So user will be able to open the app using your domain. Example: http://yourdomain.com


Create 2 new inbound rules on the EC2 instance. Custom HTTP Port 80 and HTTPS Port 443 that allows anywhere IVP4 to access. You can proceed to delete the 2 Custom port 3000 TCP inbound rules created earlier.


sudo amazon-linux-extras install -y nginx1


nginx -v


sudo systemctl start nginx


sudo nano /etc/nginx/conf.d/outerbridge.conf


Copy paste the following and change to your domain:
server {
    listen 80;
    listen [::]:80;
    server_name yourdomain.com; #Example: demo.outerbridge.io

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_cache_bypass $http_upgrade;
    }
}


sudo systemctl restart nginx


Go to your DNS provider, and add a new A record with IP address using Public IPv4 address from EC2 instance.


You should now be able to open the app: http://yourdomain.com


Install Certbot to have HTTPS

If you like your app to have https://yourdomain.com. Here is how:


sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm


sudo yum-config-manager --enable epel 


sudo yum install certbot python2-certbot-nginx


certbot --version

sudo certbot --nginx


If cert expired, simply renew:
sudo certbot renew --dry-run


You can now open the app: https://yourdomain.com

Backup MongoDB

You can backup MongoDB database into S3 bucket. Here is the article that can be followed:


sudo yum --enablerepo epel install s3cmd


s3cmd --configure


sudo nano mongo_backup.sh


Copy paste and replace values:
#!/bin/bash

#Force file syncronization and lock writes
mongo admin --eval "printjson(db.fsyncLock())"

MONGODUMP_PATH="/usr/bin/mongodump"
MONGO_DATABASE="dbname_here" #replace with your database name

TIMESTAMP=`date +%F-%H%M`
S3_BUCKET_NAME="bucketname_here" #replace with your bucket name on Amazon S3
S3_BUCKET_PATH="mongodb-backups"

# Create backup
$MONGODUMP_PATH -d $MONGO_DATABASE

# Add timestamp to backup
mv dump mongodb-$HOSTNAME-$TIMESTAMP
tar cf mongodb-$HOSTNAME-$TIMESTAMP.tar mongodb-$HOSTNAME-$TIMESTAMP

# Upload to S3
s3cmd put mongodb-$HOSTNAME-$TIMESTAMP.tar s3://$S3_BUCKET_NAME/$S3_BUCKET_PATH/mongodb-$HOSTNAME-$TIMESTAMP.tar

#Unlock database writes
mongo admin --eval "printjson(db.fsyncUnlock())"
#Delete local files
rm -rf mongodb-*


bash mongo_backup.sh


Go to S3 bucket, you should see a tar file.
Setup cron
crontab -e


Copy paste:
#1st of every month at 9 am
00 09 1 * * /bin/bash /home/ec2-user/mongo_backup.sh


To get the backup:
 s3cmd get <s3://link>


Unzip it:
tar xvf <file.tar>


Restore it:
mongorestore -d <dbname> -c <collectionname> <dir/file.bson>