Skip to content

Latest commit

 

History

History
251 lines (186 loc) · 7.27 KB

deploy-on-web-start.md

File metadata and controls

251 lines (186 loc) · 7.27 KB

How to deploy Cezerin on Web

1. Hosting

You can use any hosting: shared hosting with ssh, VM hosting, VDS hosting, NodeJS hosting, DigitalOcean, cloud services like Heroku, Amazon AWS, Google Cloud, any...) All you need is MERN stack (MongoDB + ExpressJS + ReactJs + NodeJS), nothing special. You can install it on virtual machine, or you can use "out of the box" services like Heroku, Google Firebase etc...

I'll use DigitalOcean to deploy Cezerin.

Register by this link at DigitalOcean and receive free 10$ coupon to your account.

You can add your site for free for 2 month. 5$ per month. coupon code is ACTIVATE10, activate it in your profile - billing tab.

2. Create droplet

  1. Click Create droplet
  • Choose an image: Ubuntu 19.04.4 x64
  • Choose a size: 2 GB (RAM), 1 vCPU, 50 GB (SSD)
  • Choose a datacenter region: San Francisco
  1. Then SSH to droplet.

3. Install NGinx Web Server + MERN Stack

NGinx Web Server Installation

apt update && apt install nginx-full

MongoDB 4.x Installation Guide.

Console command:

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 9DA31620334BD75D9DCB49F368818C72E52529D4
echo "deb [ arch=amd64 ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/4.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.0.list
sudo apt-get update
sudo apt-get install -y mongodb-org
systemctl start mongod
systemctl enable mongod

NodeJS 11.x Installation Guide.

Console command:

# Using Ubuntu
curl -sL https://deb.nodesource.com/setup_11.x | sudo -E bash -
sudo apt-get install -y nodejs

Update NPM:

npm i -g npm

PM2 Installation:

sudo npm install -g pm2

3. Run MongoDB

sudo service mongod start

4. Install and Run Cezerin

Cezerin Installation Guide.

Cezerin apps must be running, console command:

pm2 list all

root@ubuntu-s-1vcpu-1gb-nyc3-01:~# pm2 list all
┌───────┬────┬──────┬────────┬───┬──────┬────────────┐
│ Name  │ id │ mode │ status │ ↺ │ cpu  │ memory     │
├───────┼────┼──────┼────────┼───┼──────┼────────────┤
│ admin │ 1  │ fork │ online │ 2 │ 0.4% │ 54.1 MB    │
│ api   │ 0  │ fork │ online │ 6 │ 0.9% │ 149.1 MB   │
│ store │ 2  │ fork │ online │ 2 │ 0.5% │ 139.4 MB   │
└───────┴────┴──────┴────────┴───┴──────┴────────────┘

5. Run Nginx

To enable cezerin apps from browser, we need to setup web server.

We need to proxy all requests from web to our cezerin apps.

All requests from admin.domain.com proxy to localhost:3002 (running cezerin2-admin dashboard app) All requests from domain.com proxy to localhost:3000 (running cezerin2-store frontend app) All requests from domain.com/api, domain/ajax, domain/images proxy to localhost:3001 (running cezerin2 backend app)

All this settings available at default cezerin nginx config

We need to add a new website to Nginx.

  1. Change Nginx config file

    cd /etc/nginx/sites-available

    open default file and paste this config

P.S. Change admin.cezerin.org at this config to your domain name: admin.your-name.com

  1. Reload Nginx configuration 
    nginx -t && service nginx reload

6. Setup domain with CloudFlare

Cloudflare.

  • Get droplet IP on DigitalOcean DigitalOcean IP Address

  • Add A and CNAME to DNS on CloudFlare CloudFlare DNS

  • Set SSL to Flexible on CloudFlare CloudFlare SSL

  • Turn on Always use HTTPS on CloudFlare CloudFlare Always HTTPS

  • Add A record for admin dashboard:

Type: A Name: admin Content: your-droplet-ip-address

7. Cezerin configs changes:

You must edit cezerin configs and setup new domain name at configs.

/cezerin2/config/server.js

Change:

http://localhost:3000 to https://your-domain-name.com
http://localhost:3001 to https://your-domain-name.com
http://localhost:3002 to https://admin.your-domain-name.com

/cezerin2-store/config/store.js

Change:

http://localhost:3001 to https://your-domain-name.com

/cezerin2-admin/config/admin.js

Change:

http://localhost:3001 to https://your-domain-name.com

Change:

ws://localhost:3001 to wss://your-domain-name.com

Rebuild & restart apps with new configs:

cezerin (backend app does not need to be build, just reload):

pm2 reload api

cezerin2-store:

npm run build
pm2 reload store

cezerin2-admin:

npm run build
pm2 reload admin

8. Final checks

Thats all.

If you:

  1. Run cezerin2, cezerin2-store, cezerin2-admin apps.
  2. Run webserver nginx with cezerin config.
  3. Setup DNS records.

You will see working store in your browser by this urls:

Store: https://your-domain-name.com API: https://your-domain-name.com/api/v1/settings Dashboard: https://admin.your-domain-name.com

9. Turn off Developer Mode

By default, Cezerin is in developer mode. This means you can access API and Dashboard without authorizetion (access tokens).

Don't forget to switch off developer mode at working store. At dev mode api's and dashboard available for all without any restrictions.

To turn off developer mode, you need to do:

  • Add access token while install (npm run setup ...) or add email at Admin - Settings - Web tokens
  • Set SMTP server in cezerin2/config/server.js
  • Set false for option developerMode from cezerin2/config/server.js
  • Set false for option developerMode from cezerin2-store/config/store.js
  • Set false for option developerMode from cezerin2-admin/config/admin.js
  • Rebuild & restart apps with new configs:

cezerin (backend app does not need to be build, just reload):

pm2 reload api

cezerin2-store:

npm run build
pm2 reload store

cezerin2-admin:

npm run build
pm2 reload admin
  • Production mode is active now.

What is production mode?!

At production mode all requests to api must be authorized with JWT token. You must login before you access to admin. Login page - https://admin.your-domain-name.com/login

Specify your admin email address and email with authorize link will be send to you.

Click to link at email and you will set JWT token at all requests to api.

JWT token added to every request header - Bearer Authentication.