Gunicorn 使用与配置指南

本教程将引导您了解并使用名为 Gunicorn 的 Python WSGI HTTP 服务器，它适用于 UNIX 平台。我们将涵盖以下主要内容：

1. 项目目录结构
2. 启动文件简介
3. 配置文件介绍

1. 项目目录结构

在克隆或下载 Gunicorn 项目后，您可能会看到如下的基本目录结构：

gunicorn/
├── examples/         # 示例文件夹
│   └── ...
├── gunicorn/         # 主代码库
│   ├── __init__.py   
│   ├── ...            # 各种模块和脚本
├── tests/            # 测试套件
│   ├── __init__.py   
│   ├── ...            
├── README.md         # 项目概述
├── CHANGES.txt       # 更新日志
└── ...                # 其他相关文件

• examples: 包含演示如何使用 Gunicorn 的示例应用。
• gunicorn: 存放核心代码，包括各种类和函数。
• tests: 测试用例，用于验证项目功能。
• README.md: 对项目进行简要介绍。
• CHANGES.txt: 记录每次版本更新的内容。

2. 启动文件简介

在 Gunicorn 中，启动文件通常不是单独存在的，而是通过命令行工具来调用的。您可以使用 gunicorn 命令直接在终端中启动您的 WSGI 应用。基本格式如下：

gunicorn [OPTIONS] APP_MODULE

其中，APP_MODULE 是按照 MODULE_NAME:VARIABLE_NAME 格式指定的 WSGI 应用程序入口点。例如，如果你的应用程序有一个名为 application 的可调用对象，存在于名为 myapp 的模块中，你可以这样启动 Gunicorn:

gunicorn myapp:application

您可以通过在命令行添加额外的选项来自定义 Gunicorn 的行为，比如设置工作进程数、端口等。

3. 配置文件介绍

Gunicorn 支持通过配置文件来管理服务器的设置，而不是仅通过命令行参数。配置文件通常是 .ini, .yaml 或 .py 格式的文本文件。

以下是一个简单的配置文件示例 (gunicorn.conf.py)：

bind = "127.0.0.1:8000"
workers = 4
worker_class = "sync"

• bind: 用于指定 Gunicorn 监听的地址和端口号。
• workers: 设置工作进程的数量。
• worker_class: 工作进程类型，可以是同步（sync）、异步（asyncio）等。

要使用配置文件，启动 Gunicorn 时需指明配置文件路径：

gunicorn --config=gunicorn.conf.py APP_MODULE

现在，您已经掌握了 Gunicorn 的基本目录结构、启动方式以及配置文件的使用。请根据自身需求调整这些设置，以优化您的 Python WSGI 应用部署。