Обслуживание 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-адреса.

Изменено в версии 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)