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 Software Foundation 发布。 它为互联网上的大多数 Web 服务器提供支持。 mod_wsgi(由 Graham Dumpleton 开发)是一个 Apache 模块,它提供了一个 WSGI 接口,用于在 Apache 上部署基于 Python 的 Web 应用程序。

在本节中,将逐步解释在 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"

这些是要合并到 Apache 配置文件中的 mod_wsgi 模块设置。 打开 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 框架,我们需要借助 asgiref.wsgi 模块中定义的 WsgiToAsgi() 函数将 WSGI 应用程序对象转换为 ASGI 对象。

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