Python Pyramid 部署
到目前为止,本教程中开发的Pyramid应用程序的例子都是在本地机器上执行的。为了使其能够公开访问,必须将其部署在一个能够满足WSGI标准的生产服务器上。
许多WSGI兼容的http服务器可用于此目的。例如 –
- waitress
- paste.httpserver
- CherryPy
- uWSGI
- gevent
- mod_wsgi
我们已经讨论了如何使用Waitress服务器来托管一个Pyramid应用程序。它可以在拥有公共IP地址的机器的80(HTTP)和443(HTTPS)端口上提供服务。
mod_wsgi
Apache服务器是一个流行的开源HTTP服务器软件,由Apache软件基金会发布。它为互联网上的大多数网络服务器提供动力。 mod_wsgi (由 Graham Dumpleton 开发)是一个Apache模块,为在Apache上部署基于Python的web应用程序提供了一个WSGI接口。
在本节中,我们将逐步解释在Apache服务器上部署Pyramid应用程序的过程。在这里,我们将使用XAMPP,一个流行的开源Apache发行版。它可以从https://www.apachefriends.org/download.html 下载。
mod_wsgi模块是通过PIP安装程序安装的。在安装之前,将MOD_WSGI_APACHE_ROOTDIR环境变量设置为Apache可执行文件所在的目录。
C:\Python310\Scripts>set MOD_WSGI_APACHE_ROOTDIR=C:/xampp/apache
C:\Python310\Scripts>pip install mod_wsgi
接下来,在命令终端运行以下命令。
C:\Python310\Scripts>mod_wsgi-express module-config
LoadFile "C:/Python310/python310.dll"
LoadModule wsgi_module "C:/Python310/lib/site-packages/mod_wsgi/server/mod_wsgi.cp310-win_amd64.pyd"
WSGIPythonHome "C:/Python310"
这些是mod_wsgi模块的设置,要纳入Apache的配置文件。打开你的XAMPP安装的 httpd.conf 文件,将上述命令行的输出复制到其中。
接下来,为我们的应用程序创建一个虚拟主机配置。Apache在 httpd-vhosts.conf 文件中存储虚拟主机信息,该文件在C:\XAMPP\Apache\conf\extra\文件夹中找到。打开该文件并在其中添加以下几行
<VirtualHost *>
ServerName localhost:6543
WSGIScriptAlias / e:/pyramid-env/hello/production.ini
<Directory e:/pyramid-env/hello>
Order deny,allow
Allow from all
Require all granted
</Directory>
</VirtualHost>
这里假设使用Cookiecutter工具构建了一个Hello Pyramid项目。这里使用的是生产环境中使用的PasteDeploy配置文件。
这个虚拟主机配置需要被纳入Apache的httpd.conf文件中。这可以通过在文件中添加以下几行来完成
# Virtual hosts
Include conf/extra/httpd-vhosts.conf
我们现在必须将以下代码保存为 pyramid.wsgi 文件,该文件返回Pyramid WSGI应用程序对象。
from pyramid.paster import get_app, setup_logging
ini_path = 'e:/pyramid-env/hello/production.ini'
setup_logging(ini_path)
application = get_app(ini_path, 'main')
执行上述程序后,重新启动XAMPP服务器,我们应该能够在Apache服务器上运行Pyramid应用程序。
在Uvicorn上部署
Uvicorn是一个兼容ASGI的服务器(ASGI是指异步网关接口)。由于Pyramid是一个基于WSGI的Web框架,我们需要将WSGI应用对象转换为ASGI对象,借助于 asgiref.wsgi 模块中定义的 WsgiToAsgi() 函数。
from asgiref.wsgi import WsgiToAsgi
from pyramid.config import Configurator
from pyramid.response import Response
def hello_world(request):
return Response("Hello")
with Configurator() as config:
config.add_route("hello", "/")
config.add_view(hello_world, route_name="hello")
wsgi_app = config.make_wsgi_app()
app = WsgiToAsgi(wsgi_app)
将上述代码保存为app.py。用pip工具安装Uvicorn。
pip3 install uvicorn
在ASGI模式下运行Pyramid应用程序。
uvicorn app:app
同样,它也可以使用 daphne 服务器来提供服务。
daphne app:app