Обслуживание WSGI-приложений

Существует множество способов обслуживания WSGI-приложения. Во время разработки вы обычно не хотите использовать полнофункциональный веб-сервер, такой как Apache, а вместо этого простой автономный. Именно поэтому Werkzeug поставляется с встроенным сервером разработки.

Самый простой способ — создать небольшой start-myproject.py файл, который запускает приложение с помощью встроенного сервера:

from werkzeug.serving import run_simple
from myproject import make_app

app = make_app(...)
run_simple('localhost', 8080, app, use_reloader=True)

Вы также можете передать ему extra_files ключевое слово со списком дополнительных файлов (например, файлов конфигурации), за которыми вы хотите наблюдать.

werkzeug.serving.run_simple(hostname, port, application, use_reloader=False, use_debugger=False, use_evalex=True, extra_files=None, exclude_patterns=None, reloader_interval=1, reloader_type='auto', threaded=False, processes=1, request_handler=None, static_files=None, passthrough_errors=False, ssl_context=None)

Запустить сервер разработки для WSGI-приложения. Можно включить различные дополнительные функции.

Предупреждение

Не используйте сервер разработки при развертывании в рабочей среде. Он предназначен только для использования во время разработки на локальном компьютере. Он не предназначен для высокой эффективности, стабильности или безопасности.

Параметры:

• hostname (str) – Хост, к которому нужно подключиться, например 'localhost'. Может быть доменом, IPv4 или IPv6 адресом, или путём к файлу, начинающимся с unix:// для Unix-сокет.
• port (int) – Порт для подключения, например 8080. Использование 0 заставляет операционную систему выбрать случайный свободный порт.
• application (WSGIApplication) – WSGI-приложение, которое нужно запустить.
• use_reloader (bool) – Использовать процесс перезагрузки, чтобы перезапустить серверный процесс при изменении файлов.
• use_debugger (bool) – Использовать отладчик Werkzeug, который отобразит отформатированные трассировки при необработанных исключениях.
• use_evalex (bool) – Сделать отладчик интерактивным. Для любой рамки в трассировке можно открыть терминал Python. Некоторое ограничение обеспечивается требованием PIN-кода, но это никогда не должно активироваться на публичном сервере.
• extra_files (t.Iterable[str] | None) – Загрузчик будет следить за изменениями в этих файлах помимо модулей Python. Например, следить за файлом конфигурации.
• exclude_patterns (t.Iterable[str] | None) – Загрузчик проигнорирует изменения в любых файлах, соответствующих этим шаблонам fnmatch. Например, игнорировать файлы кэша.
• reloader_interval (int) – Как часто загрузчик пытается проверить изменения.
• reloader_type (str) – Используемый загрузчик. Встроенный загрузчик 'stat' , но может потребовать значительных ресурсов процессора для отслеживания файлов. Загрузчик 'watchdog' намного эффективнее, но для его использования необходимо предварительно установить пакет watchdog.
• threaded (bool) – Обрабатывать параллельные запросы с помощью потоков. Нельзя использовать с processes.
• processes (int) – Обрабатывать параллельные запросы, используя до этого количества процессов. Нельзя использовать с threaded.
• request_handler (type[WSGIRequestHandler] | None) – Использовать другой BaseHTTPRequestHandler подкласс для обработки запросов.
• static_files (dict[str, str | tuple[str, str]] | None) – Словарь, сопоставляющий префиксы URL-адресов с каталогами для обслуживания статических файлов с использованием SharedDataMiddleware.
• passthrough_errors (bool) – Не перехватывать необработанные исключения на уровне сервера, позволять серверу аварийно завершиться. Если use_debugger включен, отладчик по-прежнему перехватит такие ошибки.
• ssl_context (_TSSLContextArg | None) – Настроить TLS для обслуживания по HTTPS. Может быть объектом ssl.SSLContext, кортежем (cert_file, key_file) для создания типичного контекста или строкой 'adhoc' для генерации временного самоподписанного сертификата.

Тип возвращаемого значения:

None

Изменения

Изменено в версии 2.1: Показаны инструкции по работе с ошибкой «адрес уже используется».

Изменено в версии 2.1: Запуск на 0.0.0.0 или :: отображает локальный IP-адрес в дополнение к реальному IP-адресу.

Изменено в версии 2.1: Интерфейс командной строки был удален.

Изменено в версии 2.0: Запуск на 0.0.0.0 или :: показывает реальный IP-адрес, который был привязан, а также предупреждение о том, что сервер разработки не следует запускать в рабочей среде.

Изменено в версии 2.0: Добавлен параметр exclude_patterns.

Изменено в версии 0.15: Подключение к Unix-сокету путём передачи hostname, начинающегося с unix://.

Изменено в версии 0.10: Улучшен загрузчик и добавлена поддержка изменения бэкенда через параметр reloader_type.

Изменено в версии 0.9: Добавлен интерфейс командной строки.

Изменено в версии 0.8: ssl_context может быть кортежем путей к файлам сертификата и закрытого ключа.

Изменено в версии 0.6: Добавлен параметр ssl_context.

Изменено в версии 0.5: Добавлены параметры static_files и passthrough_errors.

werkzeug.serving.is_running_from_reloader()

Проверить, запущен ли сервер как дочерний процесс в загрузчике Werkzeug.

Изменения

Добавлена в версии 0.10.

Тип возвращаемого значения:

bool

werkzeug.serving.make_ssl_devcert(base_path, host=None, cn=None)

Создаёт SSL-ключ для разработки. Его следует использовать вместо ключа 'adhoc', который генерирует новый сертификат при каждом запуске сервера. Он принимает путь к месту хранения ключа и сертификата, а также имя хоста или CN. Если задан хост, будет использовано имя CN *.host/CN=host.

Для получения дополнительной информации см. run_simple().

Журнал изменений

Добавлен в версии 0.9.

Параметры:

• base_path (str) – путь к сертификату и ключу. Расширение .crt добавляется для сертификата, .key добавляется для ключа.
• host (str | None) – имя хоста. Это может быть использовано как альтернатива cn.
• cn (str | None) – используемое CN.

Тип возвращаемого значения:

tuple[str, str]

127.0.0.1       localhost yourapplication.local api.yourapplication.local

import multiprocessing
from werkzeug import Request, Response, run_simple

def get_token(q: multiprocessing.Queue) -> None:
    @Request.application
    def app(request: Request) -> Response:
        q.put(request.args["token"])
        return Response("", 204)

    run_simple("localhost", 5000, app)

if __name__ == "__main__":
    q = multiprocessing.Queue()
    p = multiprocessing.Process(target=get_token, args=(q,))
    p.start()
    print("waiting")
    token = q.get(block=True)
    p.terminate()
    print(token)

::1             localhost

import ssl
ctx = ssl.SSLContext(ssl.PROTOCOL_TLS_SERVER)
ctx.load_cert_chain('ssl.cert', 'ssl.key')
run_simple('localhost', 4000, application, ssl_context=ctx)

$ openssl genrsa 1024 > ssl.key
$ openssl req -new -x509 -nodes -sha1 -days 365 -key ssl.key > ssl.cert

run_simple('localhost', 4000, application,
           ssl_context='adhoc')

from werkzeug.serving import run_simple
run_simple('unix://example.sock', 0, app)