如何打包Python Web项目,实现免安装一键启动?

共 1857字,需浏览 4分钟

 ·

2020-05-21 23:20

一、现状
Python 有诸多优秀的 Web 开发框架供我们使用,比如Django、Flask、Sanic。正常的情况下,我们基于这些 Web 框架开发好了网站,最终都会使用 Nginx 搭配 uWSGI 或gunicorn 将其部署在 Linux 服务器上,这样,用户就可以通过 绑定的域名或 IP 地址访问。

96d33b1bee4828f0d843855263b911cd.webp
是的,这是正常的情况。

往往很多场景,我们面对的就不是一个正常的情况。正常的情况下一切环境的问题都不是问题,因为有运维的伙伴帮我们处理好了所有环境的问题,从Python特定版本的安装,到特定依赖库的安装,再到服务的配置。一切都不需要操心。
但是,如果所有的这些问题都需要自己操心呢?那可真是一个灾难性的问题。Docker的出现解决了一部分的问题,但是对于完全小白而言,docker的安装和使用,又成为了一个问题。
f06f509cf8f3b13e7685924b3e864915.webp
州的先生在开发MrDoc觅道文档的时候,就遇到了这个问题。如果要源码安装 MrDoc,那么需要:

  • 安装Python(基本不会出问题)

  • pip安装依赖库(非常容易出问题)

  • 安装依赖的第三方软件包(非常容易出问题)


很多想体验一下 MrDoc 的小伙伴,直接就死在了第二步,各种报错无所适从。
有 MrDoc 交流群里的热心伙伴制作了docker镜像,这解决了一定的环境问题,但是对于真正零基础的计算机小白而言,命令行还是自带恐惧属性。
0b1a7bece444bce879f002e8d2257d29.webp
怎么办呢?能不能让Python编写的Web项目像 PHP 或GO 语言编写的Web服务一样可以直接启动呢?
在互联网上逛荡了老半天,发现老伙计——PyInstaller可以实现这个功能。
二、打包
PyInstaller是Python中一个用于将Python程序打包为可执行文件的第三方模块。州的先生之前经常使用它将PyQt5编写的桌面图形界面程序打包分发。来看看它在打包Web程序上的应用。
PyInstaller官方提供了一个打包Django项目的文档,其链接为:https://github.com/pyinstaller/pyinstaller/wiki/Recipe-Executable-From-Django
按照这个文档,我们根据项目的具体情况,运行下述命令:
pyinstaller --name=mysite mysite/manage.py

就会得到一个dist文件夹,里面包含了运行Django项目的所有文件,我们打开命令行界面,使用xxx.exe文件就可以达到像正常使用:
python manage.py
一样的效果。比如运行runserver服务:
xxx.exe runserver

但是,很大概率是运行不起来的,报错的信息,不是缺少模块,就是缺少静态文件。

我们需要显式地告诉PyInstaller,哪些包、哪些模块、哪些文件需要一起打包进去。
在上一次运行 pyinstaller 命令之后,文件夹下会生成一个.spec后缀的配置文件,其实质是一个Python文件,我们对其进行修改。
import syssys.setrecursionlimit(5000)

在文件第3行的位置,添加上述2行代码,用于避免pyinstaller索引模块层级的错误
00b2421b8e74b5521177c704829c2b14.webp
然后,在datas列表中,将Django项目的静态文件目录、媒体文件目录、以及其他使用到的文件目录全都以元组的形式添加进去。这会让PyInstaller直接将这些文件打包到最后生成的文件夹中。

48b59a16030b05d8de519bd81f857e04.webp
接着,在hidedenimports列表中,将Django项目的应用模块路径也添加进去。可以根据每次生成的报错来一个一个添加,但是那样太浪费时间了,还不如直接都添加进去。
修改好了之后,我们把之前生成的build目录和dist目录删除,使用spec文件调用Pyinstaller命令:
pyinstaller MrDoc.spec

等待一会儿,整个Django项目就打包好了,其完整的打包文件如下所示:

9859cb87ab0ab9e1bbc81c8653fdd40a.webp
三、效果
打包好之后,我们打开命令行界面,输入命令:
mrdoc.exe runserver
就启动了Django Web网站,如下图所示:

6b0fe89da95544e1a009ed485f8c1614.webp
在浏览器上访问:127.0.0.1:8000 就可以看到我们的MrDoc觅道文档了:

4e4329b77cb0813c75961b4636809ecd.webp


为了方便使用,我们还可以写一个bat脚本,双击即可启动它,免去打开命令行界面输入命令的繁琐:
start ./mrdoc.exe runserver

这样,一个免安装、一键启动的Django网站应用就打包制作完成了。
点击“阅读原文”,可以获取这个Windows免安装便携体验版MrDoc下载地址详细使用说明
浏览 21
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报