Deployment Procedures
pi@raspberrypi:~ $ sudo apt update; sudo apt upgrade
NOTE: This updates and then upgrade all your packages in your system. You should regularly run this command.
pi@raspberrypi:~ $ sudo apt install python3-pip nginx
pi@raspberrypi:~ $ sudo pip3 install virtualenv
pi@raspberrypi:~ $ cd ~
- This clone and cd name MUST change to matcch your repository
+ REPLACE flask-idea-homesite with your repo namepi@raspberrypi:~ $ git clone https://github.com/nighthawkcoders/flask-idea-homesite
pi@raspberrypi:~ $ cd ~/flask-idea-homesite
- The homesite name should be a name that corresponds with project for easy recall
+ REPLACE homesite with your virtualenv preferred namepi@raspberrypi:~/flask-idea-homesite $ virtualenv -p /usr/bin/python3 homesite
pi@raspberrypi:~/flask-idea-homesite $ source homesite/bin/activate
(homesite) pi@raspberrypi:~/flask-idea-homesite $ pip install gunicorn
(homesite) pi@raspberrypi:~/flask-idea-homesite $ pip install -r requirements.txt
- The main.py name should be a name that corresponds with the file you typically run in development environment, it should contain app
+ REPLACE main.py with your <my-python-file>.py(homesite) pi@raspberrypi:~/flask-idea-homesite $ python main.py
stop test server by typing control-c in terminal
(homesite) pi@raspberrypi:~/flask-idea-homesite $ ^c
Verify Python virual environment and package dependencies. If it fails pip install each missing dependency, best to get these into requirements.txt
- The main:app with file that contain Flask app
+ REPLACE main:app with your <my-python-file>:app(homesite) pi@raspberrypi:~/flask-idea-homesite $ homesite/bin/gunicorn --bind 0.0.0.0:5000 main:app
in your browser ...
(homesite) pi@raspberrypi:~/flask-idea-homesite $ ^c
(homesite) pi@raspberrypi:~/flask-idea-homesite $ deactivate
pi@raspberrypi:~/flask-idea-homesite $ cd
In console/terminal with nano, vi, or other text editor (first time only: setup Gunicorn configuration file)...
- The homesite filename and name reference, the main:app should change as discussed previously
+ REPLACE according to your project requirementspi@raspberrypi:~ $ sudo nano /etc/systemd/system/homesite.service
[Unit]
Description=Gunicorn instance to serve homesite web project
After=network.target
[Service]
User=pi
Group=www-data
WorkingDirectory=/home/pi/flask-idea-homesite
Environment="PATH=/home/pi/flask-idea-homesite/homesite/bin"
ExecStart=/home/pi/flask-idea-homesite/homesite/bin/gunicorn --workers 3 --bind unix:homesite.sock -m 007 main:app
[Install]
WantedBy=multi-user.target
- THESE server_name values MUST CHANGE to match your solution:
- nighthawkcoders.cf 70.95.179.231
+ REPLACE with yourdomain.com yourpublic-ipIn console/terminal with nano, vi, or other text editor (first time only: setup Nginx configuration file)...
pi@raspberrypi:~ $ sudo nano /etc/nginx/sites-available/homesite
server {
listen 80;
listen [::]:80;
server_name idea.nighthawkcodingsociety.com;
location / {
include proxy_params;
proxy_pass http://unix:/home/pi/flask-idea-homesite/homesite.sock;
}
}
- This service file name MUST CHANGE to match your name of your gunicorn service
+ REPLACE with <filename>.servicepi@raspberrypi:~ $ sudo systemctl start homesite.service
pi@raspberrypi:~ $ sudo systemctl enable homesite.service
check the status, if all OK enable service permanentley...
pi@raspberrypi:~ $ sudo systemctl status homesite.service
stop status by typing q in terminal
link file...
pi@raspberrypi:~ $ sudo ln -s /etc/nginx/sites-available/homesite /etc/nginx/sites-enabled
test for errors...
pi@raspberrypi:~ $ sudo nginx -t
start the web server...
pi@raspberrypi:~ $ sudo systemctl restart nginx
check nginx status...
pi@raspberrypi:~ $ sudo systemctl status nginx
stop status by typing q in terminal
in address bar of browser on another device in LAN type IP address of this Nginx server ...
- This IP address MUST CHANGE to match your Raspberry Pi
+ REPLACE with yourpi-ip