You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
TacticalWatermarks/README.md

90 lines
2.5 KiB
Markdown

# Run
## in Development
`export FLASK_APP=run.py`
`export FLASK_ENV=development`
`flask run`
**Using gunicorn:**
`gunicorn --env SCRIPT_NAME=/watermark -w 4 -b 127.0.0.1:5000 app:app --log-level debug`
* `-w` workers
* `-b` bind to address / unix socker
**And gunicorn with using unix sock:** (this how it should run in production)
` gunicorn --env SCRIPT_NAME=/watermark --workers 4 --bind unix:app.sock -m 007 app:app --log-level debug
## in Production with gunicorn and unix sockets
Based on https://medium.com/faun/deploy-flask-app-with-nginx-using-gunicorn-7fda4f50066a
### systemd service file
Add to /etc/systemd/system/watermarks.service
```
[Unit]
After=network.target
[Service]
User=psc
Group=www-data
WorkingDirectory=/var/www/TacticalApp
Environment="PATH=/var/www/TacticalApp/venv/bin"
ExecStart=/var/www/TacticalApp/venv/bin/gunicorn --env SCRIPT_NAME=/watermarks --workers 4 --bind unix:app.sock -m 007 app:app
[Install]
WantedBy=multi-user.target
```
## enable & start service file
`systemctl enable watermarks.service`
`systemctl start watermarks.service`
It is also a good idea to check the status of the service
`systemctl status watermarks.service`
## Nginx config
```
location / {
# if using gunicorn with app sock, use:
proxy_pass http://unix:/var/www/TacticalApp/app.sock;
# if using gunicord with port 5000, use:
proxy_pass http://127.0.0.1:5000;
}
```
## debug.
It might be helpful to enable gunicorn logging, while in development, to check what is going on,
by replacing in watermarks.service, the `ExecStart=` value with:
`ExecStart=/var/www/TacticalApp/venv/bin/gunicorn --log-level debug --error-logfile /var/www/TacticalApp/app.log --workers 4 --bind unix:app.sock -m 007 app:app`
And reloading the services
`systemctl daemon-reload`
`systemctl restart watermarks.service`
and the start following app.log:
`tail -f /var/www/TacticalApp/app.log`
But in the long run logging should be disabled
----
09.06.2020 Handling url path /watermarks
* gunicorn has to be started with argument `--env SCRIPT_NAME=/watermark` which defines its path:
`gunicorn --env SCRIPT_NAME=/watermark --workers 4 --bind unix:app.sock -m 007 app:app --log-level debug`
* allows for the following URLs
* http://127.0.0.1/watermark
* http://127.0.0.1/watermark/uploadbook
* http://127.0.0.1/watermark/about
* added page /test `watermark/test` for testing url_for() - correct
* made urls relative
* service file with `--env SCRIPT_NAME=/watermark` see above
*
gunicorn -w 4 -b :5000 app:app