Project: Code Quality Portal

Link: http://codequalityportal.tk

Team 6 Members:

1. Fatema Olia: folia
2. Rachit Shah: rshah25
3. Udit Misra: umisra

Milestone 1: Design

Milestone 2: Portal

Milestone 3: Services

Milestone 4: Deployment

Final Report

• Steps adopted from this tutorial

1. Create an account on Digital Ocean and buy an Ubuntu 18.04 droplet
2. Add the necessary SSH keys to access the droplet remotely via terminal

1. Create a domain name on sites like FreeNom (e.g., codequalityportal.tk).
2. Add ip address of the droplet to their DNS service when buying the domain name.
3. Add ns1.digitalocean.com, ns2.digitalocean.com and ns3.digitalocean.com to the nameserver on FreeNom client area.
4. Add the domain to DigitalOcean's droplet

1. Create a non-root user on the droplet and ssh to the droplet using that user. We create a non-root user named sammy. If you use another name, change the consecutive steps accordingly.
2. Install nginx on the droplet.
3. Domain name should redirect to "Welcome nginx" page after following the above steps

1. Install python and other packages from terminal.

sudo apt update
sudo apt install python3-pip python3-dev build-essential libssl-dev libffi-dev python3-setuptools

2. Clone our repository and switch to branch "deploy".
3. Create a Python3 virtual env

sudo apt install python3-venv
python3.6 -m venv myprojectenv
source myprojectenv/bin/activate

4. Install all requirements.

cd csc510-project/CodeQualityPortal
pip install -r requirements.txt

1. Open port 5000 in the firewall to let remote users access the hosted app on localhost

sudo ufw allow 5000

2. Before deploying the app check if the app works on the localhost by following these steps from the first CodeQualityPortal folder in the repo

cd csc510-project/CodeQualityPortal
export FLASK_APP=__init__
flask run --host=0.0.0.0

3. Accessing the site with the domain name/ip address and port should open the app in the browser.

http://your_server_ip:5000 (e.g. http://codequalityportal.tk:5000)

4. Close the flask run command.

1. Test if uWSGI is working to deploy our app using the following command.

uwsgi --socket 0.0.0.0:5000 --protocol=http -w wsgi:app

2. Again accessing the site with the domain name/ip address and port should open the app in the browser.

http://your_server_ip:5000 (e.g. http://codequalityportal.tk:5000)

3. Close the command and deactivate the virtual environment

deactivate

1. Create a systemd unit service file which will allow Ubuntu's init system to automatically start uWSGI and serve the Flask application whenever the server boots.

sudo nano /etc/systemd/system/CodeQualityPortal.service

2. Add the following code changing user name and paths accordingly

[Unit]
Description=uWSGI instance to serve CodeQualityPortal
After=network.target

[Service]
User=sammy
Group=www-data
WorkingDirectory=/home/sammy/CodeQualityPortal
Environment="PATH=/home/sammy/myprojectenv/bin"
ExecStart=/home/sammy/myprojectenv/bin/uwsgi --ini CodeQualityPortal.ini

[Install]
WantedBy=multi-user.target

3. Start the uWSGI service we created and enable it so that it starts at boot

sudo systemctl start CodeQualityPortal
sudo systemctl enable CodeQualityPortal

4. Check the status and check that it returns active

sudo systemctl status CodeQualityPortal

1. Create a new server block configuration file in Nginx's sites-available directory named CodeQualityPortal

sudo nano /etc/nginx/sites-available/CodeQualityPortal

2. Add the following to the file while changing domain name, user name, paths and ports as needed.

server {
    listen 80;
    server_name codequalityportal.tk www.codequalityportal.tk;

    location / {
        include uwsgi_params;
        uwsgi_pass unix:/home/sammy/CodeQualityPortal/CodeQualityPortal.sock;
    }
}

3. Enable the Nginx server block configuration you've just created and link the file to the sites-enabled directory. Test for syntax errors

sudo ln -s /etc/nginx/sites-available/CodeQualityPortal /etc/nginx/sites-enabled
sudo nginx -t

4. If there are no syntax errors, restart the Nginx process to read the new configuration.

sudo systemctl restart nginx

5. Adjust firewall to open ports

sudo ufw delete allow 5000
sudo ufw allow 'Nginx Full'

6. Done! This should deploy the app. Check your domain name to see if its working. http://codequalityportal.tk

7. Check logs to see if there are any errors.

cat ~/log/CodeQualityPortal.log