添加部署相关文件

Author: gsw945

deploy-demo/Python-Web应用部署-讲义.md

@@ -0,0 +1,156 @@
+# Python-Web应用部署步骤
+
+> 假设:
+> * 操作系统为原生`Ubuntu 18.04 LTS`
+> * 当前登录用户为`xyz`
+> * Web程序目录: `/home/xyz/myblog`
+> * 虚拟环境运行启动脚本: `/home/xyz/runinenv.sh`
+
+* `/home/xyz/runinenv.sh`内容如下:
+    ```shell
+    #!/bin/bash
+    export SOME_ENV=test-message
+
+    VENV=$1
+    if [ -z $VENV ]; then
+    echo "usage:runinenv [virtualenv_path] CMDS"
+    exit 1
+    fi
+    source ${VENV}/bin/activate
+    shift 1
+    echo "Executing $@ in ${VENV}"
+    exec "$@"
+    deactivate
+    ```
+
+---
+
+1. 安装必须的软件
+    ```shell
+    sudo apt-get install python3-pip virtualenv -y
+    sudo apt-get install vim -y
+    sudo apt-get install nginx supervisor -y
+    ```
+2. 创建虚拟环境、安装包、测试程序
+    ```shell
+    cd ~
+    virtualenv v3web --python=python3
+    
+    source /home/xyz/v3web/bin/activate
+    pip install Flask flask_sqlalchemy
+
+    cd /home/xyz/myblog
+    python index.py
+
+    deactivate
+    ```
+3. 使用supervisor管理进程（后台运行）
+    ```shell
+    cd /etc/supervisor/conf.d/
+    vim demo.conf
+    ```
+    `/etc/supervisor/conf.d/demo.conf`内容如下:
+    ```
+    [program:demo]
+    user=xyz
+    directory=/home/xyz/myblog/
+    command=/bin/bash /home/xyz/runinenv.sh /home/xyz/v3web python /home/xyz/myblog/index.py
+    autostart=true
+    autorestart=true
+    startsecs=5
+    stopsignal=HUP
+    stopasgroup=true
+    stopwaitsecs=5
+    stdout_logfile_maxbytes=20MB
+    stdout_logfile=/var/log/supervisor/%(program_name)s-out.log
+    stderr_logfile_maxbytes=20MB
+    stderr_logfile=/var/log/supervisor/%(program_name)s-err.log
+    ```
+    配置要点：
+    - `[program:<名称>]`
+    - `user=<运行用户>`
+    - `directory=<启动目录>`
+    - `command=<运行的命令>`
+    - `environment=<环境变量>`
+        参考: [Supervisor and Environment Variables](https://stackoverflow.com/questions/12900402/supervisor-and-environment-variables/19611920#19611920)
+4. supervisor管理命令
+    ```shell
+    # 重新加载配置
+    sudo supervisorctl reload
+    # 查看进程状态
+    sudo supervisorctl status
+    # 停止/启动/重启某个进程（此处为demo）
+    sudo supervisorctl stop/start/restart demo
+    ```
+5. Linux基础命令
+    ```shell
+    # 查看和python相关的tcp连接
+    netstat -antp | grep python
+    # 查看和python相关的进程
+    ps uax | grep python
+    # 杀死指定名称的进程（此处为python）
+    sudo pkill python
+    ```
+6. 配置nginx
+    ```shell
+    cd /etc/nginx/conf.d/
+    sudo vim demo.conf
+    ```
+    `/etc/nginx/conf.d/demo.conf`内容如下:
+    ```
+    server {
+        listen 80;
+        listen [::]:80;
+        server_name localhost;
+
+        location / {
+            proxy_set_header X-Real-IP $remote_addr;
+            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+            proxy_set_header Host $http_host;
+            proxy_set_header X-NginX-Proxy true;
+
+            proxy_pass http://127.0.0.1:5000/;
+            # proxy_pass http://10.0.0.10:8999/;
+            proxy_redirect off;
+        }
+        
+        location /static/ {
+            alias /home/xyz/myblog/static/;
+        }
+    }
+    ```
+7. nginx管理命令
+    ```shell
+    # 重启nginx服务（会重新加载配置文件）
+    sudo service nginx restart
+    # 启动、停止服务器
+    sudo service nginx start/stop
+    ```
+8. nginx静态文件403解决方案
+    修改nginx配置文件(改完了需要重启)
+    ```shell
+    vim /etc/nginx/nginx.conf
+    ```
+    将如下的行(nginx运行用户默认为`www-data`)
+    ```
+    user www-data;
+    ```
+    改为(将nginx运行用户改为`root`)
+    ```
+    user root;
+    ```
+    一般情况下，也将nginx运行用户改为当前用户（此处为`xyz`）
+    ```
+    user xyz;
+    ```
+    重启服务器
+    ```shell
+    sudo service nginx restart
+    ```
+9. 添加用户, 并添加到sudo组
+    ```shell
+    # 创建名为pyuser的用户
+    adduser pyuser
+    # 将用户pyuser添加到sudo组里
+    usermod -a -G sudo pyuser
+    ```

deploy-demo/nginx-demo.conf

@@ -0,0 +1,19 @@
+server {
+    listen 80;
+    listen [::]:80;
+    server_name _;
+
+    location / {
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header Host $http_host;
+        proxy_set_header X-NginX-Proxy true;
+
+        proxy_pass http://127.0.0.1:<PORT>/;
+        proxy_redirect off;
+    }
+    
+    location /static/ {
+        alias <PROJ-ROOT-ABSPATH>/static/;
+    }
+}

deploy-demo/runinenv.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+export SOME_ENV=some-value
+
+VENV=$1
+if [ -z $VENV ]; then
+echo "usage:runinenv [virtualenv_path] CMDS"
+exit 1
+fi
+source ${VENV}bin/activate
+shift 1
+echo "Executing $@ in ${VENV}"
+exec "$@"
+deactivate

deploy-demo/supervisor-demo.conf

@@ -0,0 +1,14 @@
+[program:<APP-NAME>]
+user=<USER>
+directory=<PROJ-ROOT-ABSPATH>/
+command=/bin/bash <RUNINENV-ABSPATH>/runinenv.sh <VEVE-ABSPATH>/ python <PY-FILE-ABSPATH>
+autostart=true
+autorestart=true
+startsecs=5
+stopsignal=HUP
+stopasgroup=true
+stopwaitsecs=5
+stdout_logfile_maxbytes=20MB
+stdout_logfile=/var/log/supervisor/%(program_name)s-out.log
+stderr_logfile_maxbytes=20MB
+stderr_logfile=/var/log/supervisor/%(program_name)s-err.log

main/urls.py

@@ -25,4 +25,7 @@
     path('admin/', admin.site.urls),
     path('martor/', include('martor.urls')),
     path('api/uploader/', markdown_uploader, name='markdown_uploader_page'),
-] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
+]
+
+if settings.DEBUG:
+    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

main/views.py

@@ -13,6 +13,17 @@
 from martor.utils import LazyEncoder
 
 
+def image_thumbnail(path, width=128, height=None):
+    '''
+    创建缩略图
+    TOOD: 图片尺寸修改和保存
+    '''
+    from PIL import Image
+    img = Image.open(path[0])
+    img = img.resize((width, height), Image.ANTIALIAS)
+    import ipdb; ipdb.set_trace()
+    pass
+
 @login_required
 def markdown_uploader(request):
     """
@@ -53,6 +64,7 @@ def markdown_uploader(request):
             def_path = default_storage.save(save_path, ContentFile(image.read()))
             img_url = os.path.join(settings.MEDIA_URL, tmp_file).replace('\\', '/')
             img_path = def_path
+            # image_thumbnail((image, img_path, img_url), width=128) # debug
 
             data = json.dumps({
                 'status': 200,

wsgi-server.py

@@ -0,0 +1,21 @@
+# -*- coding: utf-8 -*-
+import os
+import tornado.httpserver
+import tornado.ioloop
+import tornado.wsgi
+from django.core.wsgi import get_wsgi_application
+
+
+def main():
+    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "main.settings")
+    application = get_wsgi_application()
+    container = tornado.wsgi.WSGIContainer(application)
+    http_server = tornado.httpserver.HTTPServer(container)
+    port = 8000
+    host = '0.0.0.0'
+    print('visit by: [http: //{0}:{1}/]'.format(host, port))
+    http_server.listen(port, address=host)
+    tornado.ioloop.IOLoop.instance().start()
+
+if __name__ == "__main__":
+    main()