pyruvate 1.3.0

二进制包

manylinux_2_17和musllinux_1_1轮子在x86_64架构和活动的Python 3版本（目前3.8-3.12）中可用。

源代码安装

在macOS上或如果出于任何其他原因您想安装源tar包（例如使用 pip install –no-binary），您首先需要安装Rust。

开发安装

• 安装Rust

• 安装并激活Python 3（>= 3.8）虚拟环境

• 使用pip安装setuptools_rust

  $ pip install setuptools_rust

• 安装Pyruvate，例如使用pip

  $ pip install -e git+https://gitlab.com/tschorr/pyruvate.git#egg=pyruvate[test]

通过TCP端口使用Python

一个使用Pyruvate监听在127.0.0.1:7878并使用2个工作线程的hello world WSGI应用程序如下所示

import pyruvate

def application(environ, start_response):
    """Simplest possible application object"""
    status = '200 OK'
    response_headers = [('Content-type', 'text/plain')]
    start_response(status, response_headers, None)
    return [b"Hello world!\n"]

pyruvate.serve(application, "127.0.0.1:7878", 2)

通过Unix套接字使用Python

一个使用Pyruvate监听在unix:/tmp/pyruvate.socket并使用2个工作线程的hello world WSGI应用程序如下所示

import pyruvate

def application(environ, start_response):
    """Simplest possible application object"""
    status = '200 OK'
    response_headers = [('Content-type', 'text/plain')]
    start_response(status, response_headers, None)
    return [b"Hello world!\n"]

pyruvate.serve(application, "/tmp/pyruvate.socket", 2)

使用PasteDeploy

再次监听在127.0.0.1:7878并使用2个工作线程

[server:main]
use = egg:pyruvate#main
socket = 127.0.0.1:7878
workers = 2

配置选项

套接字

必需：Pyruvate应该绑定的TCP套接字。 Pyruvate 也支持 systemd套接字激活 如果您将套接字值指定为 None，Pyruvate 将尝试获取由 systemd 绑定的套接字。

工作线程

必需：要使用的工作线程数量。

异步日志记录

可选：使用专用线程异步记录日志。默认为 True。

分块传输

可选：如果没有Content-Length头，是否使用分块传输编码。默认为 False。

保持连接超时

可选：指定保持连接的超时时间（以整数秒为单位）。在超时后，持久连接将被关闭。默认为60秒。

最大头部数量

可选：将解析的最大请求数量。如果请求包含比配置更多的头部，则请求处理将停止，并显示一个错误，指示请求不完整。默认为32个头部。

最大重用次数

可选：指定多久重用一次现有连接。将此参数设置为0将有效地禁用保持连接。这是默认值。

qmon警告阈值

可选：请求队列中请求数量的警告阈值。如果队列中的请求数量达到此值，将记录一条警告。该值必须是正整数。默认为 None，这将禁用队列监控。

发送超时

可选：在EAGAIN后等待客户端连接可用于写入的时间（以秒为单位）。在此时间内没有收到数据的连接将被关闭。该值必须是正整数。默认为60秒。

日志记录

Pyruvate使用标准的 Python日志设施。记录器名称为 pyruvate。有关配置选项，请参阅Python文档（logging，logging.config）。

Django

在您的Django虚拟环境中安装Pyruvate后，创建或修改您的 wsgi.py 文件（一个工作线程监听在127.0.0.1:8000）

import os
import pyruvate

from django.core.wsgi import get_wsgi_application

os.environ.setdefault("DJANGO_SETTINGS_MODULE", "your_django_application.settings")

application = get_wsgi_application()

pyruvate.serve(application, "127.0.0.1:8000", 1)

现在您可以使用以下命令启动Django + Pyruvate

$ python wsgi.py

根据需要使用 DJANGO_SETTINGS_MODULE 环境变量覆盖设置。已测试与 Django 4.1.x, 3.2.x, 2.2.x。

MapProxy

首先根据 MapProxy部署文档 创建基本的WSGI配置。然后修改 config.py 以使用Pyruvate（2个工作线程监听在127.0.0.1:8005）

import os.path
import pyruvate

from mapproxy.wsgiapp import make_wsgi_app
application = make_wsgi_app(r'/path/to/mapproxy/mapproxy.yaml')

pyruvate.serve(application, "127.0.0.1:8005", 2)

从您的虚拟环境启动

$ python config.py

已测试与 Mapproxy 1.15.x, 1.13.x, 1.12.x。

Plone

[server:main]
use = egg:pyruvate#main
socket = localhost:7878
workers = 2

[instance]
recipe = plone.recipe.zope2instance
http-address = 127.0.0.1:8080
eggs =
    Plone
    pyruvate
wsgi-ini-template = ${buildout:directory}/templates/pyruvate.ini.in

[server:main]
use = egg:pyruvate#main
socket = %(http_address)s
workers = 3

Pyramid

使用 pip 在您的 Pyramid 虚拟环境中安装 Pyruvate

$ pip install pyruvate

修改您的 .ini 文件中的服务器部分，以使用 Pyruvate 的 PasteDeploy 入口点（监听在 127.0.0.1:7878 并使用 5 个工作进程）

[server:main]
use = egg:pyruvate#main
socket = 127.0.0.1:7878
workers = 5

使用 pserve 正常启动您的应用程序

$ pserve path/to/your/configfile.ini

已在 Pyramid 2.0, 1.10.x 上测试。

Radicale

您可以在包的 示例目录 中找到 Radicale 的示例配置。已在 Radicale 3.1.8 上测试。

Nginx 设置

与其他 WSGI 服务器一样，Pyruvate 应该位于反向代理之后，例如 Nginx

....
location / {
    proxy_pass http://localhost:7878;
    ...
}
...

Nginx 默认不使用 keepalive 连接，因此如果您想使用持久连接，您需要 修改您的配置