Развёртывание 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 (Optional[Iterable[str]]) – Релоадер будет отслеживать изменения в этих файлах помимо модулей Python. Например, отслеживать файл конфигурации.
• exclude_patterns (Optional[Iterable[str]]) – Релоадер будет игнорировать изменения в любых файлах, соответствующих этим шаблонам fnmatch. Например, игнорировать кешированные файлы.
• reloader_interval (int) – Частота проверки релоадера на изменения.
• reloader_type (str) – Используемый релоадер. Встроенный 'stat' релоадер, но может потребовать значительных ресурсов процессора для отслеживания файлов. 'watchdog' релоадер намного эффективнее, но для его использования необходимо предварительно установить пакет watchdog.
• threaded (bool) – Обработка одновременных запросов с помощью потоков. Не может быть использовано с processes.
• processes (int) – Обработка одновременных запросов с помощью указанного количества процессов. Не может быть использовано с threaded.
• request_handler (Optional[Type[werkzeug.serving.WSGIRequestHandler]]) – Использование другого BaseHTTPRequestHandler подкласса для обработки запросов.
• static_files (Optional[Dict[str, Union[str, Tuple[str, str]]]]) – Словарь, сопоставляющий префиксы URL с каталогами для обслуживания статических файлов с помощью SharedDataMiddleware.
• passthrough_errors (bool) – Не перехватывать необработанные исключения на уровне сервера, а вместо этого позволять серверу аварийно завершиться. Если use_debugger включено, отладчик всё равно перехватит такие ошибки.
• ssl_context (Optional[Union[ssl.SSLContext, Tuple[str, Optional[str]], te.Literal['adhoc']]]) – Настройка 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 (Optional[str]) – имя хоста. Это может быть использовано как альтернатива для cn.
• cn (Optional[str]) – CN для использования.

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

Кортеж[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)