Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-26

1 В этом уроке мы узнаем, что такое конфигурация и как настраивать и деплоить приложение.

2 <h2>Конфигурация</h2>

3 Любое нетривиальное приложение взаимодействует с внешним миром: использует базу данных, обращается к внешним сервисам (например, платежным), отправляет письма и получает список друзей, например, из Facebook. Для подавляющего большинства этих операций необходимы специальные параметры: ключи, пароли, адреса серверов и порты. Все эти параметры называются конфигурацией приложения.

4 Возникает вопрос, где хранить конфигурацию? Самый простой и самый неправильный ответ - прямо в приложении. Проблем у такого подхода две:

5 <ul><li>Часть этих данных секретная. Хранить их в репозитории просто нельзя из-за возможных проблем с безопасностью. Любой кто имеет доступ к репозиторию сможет получить любой доступ.

6 </li>

7 <li>При изменении этих параметров придется заново деплоить приложение, хотя, по сути, ничего не изменилось, нет новых фич, нет исправления старых багов. Просто изменилась конфигурация.

8 </li>

9 </ul>В 2011 году разработчики компании<a>Heroku</a>выложили в интернете сайт, который называется<a>12factors</a>. Он описывает методологию для создания веб-приложений. Она уменьшает затраты на установку и настройку приложения, повышает переносимость между средами исполнения, позволяет масштабироваться без существенных изменений в инструментах, архитектуре и практике разработки. С тех пор эта методология фактически стала стандартом в индустрии.

10 Рекомендуем полностью изучить этот документ. Сейчас же нас интересует один его аспект - конфигурация. Двенадцать факторов требуют строгого разделения конфигурации и кода. Конфигурация может меняться между развертываниями: локальное окружение разработчика, продакшен, среда для тестирования. Код не меняется.

11 Конфигурация должна передаваться в приложение снаружи. Единственный универсальный способ сделать это - использовать переменные окружения.

12 <h3>Переменные окружения</h3>

13 У Flask большое количество<a>настроек</a>для разных подсистем. Все они задаются в объекте app.config. Например, так можно запустить фреймворк в режиме отладки:

14 Таких переменных может быть довольно много - от настроек логгирования до путей к базе данных. Все они указываются в коде и могут загружаться из окружения.

15 Некоторые такие настройки конфиденциальны и должны храниться отдельно от основного кода проекта. Для этих целей используются переменные окружения:

16 У данного способа есть несколько недостатков:

17 <ul><li>Переменные загружаются только из окружения</li>

18 <li>Необходимо обрабатывать исключения KeyError</li>

19 <li>Необходимо конвертировать типы вручную (например, DEBUG=True из строки в bool)</li>

20 </ul>Для простоты конфигурации Flask можно использовать стороннюю библиотеку<a>python-dotenv</a>. Она позволяет загружать переменные не только из окружения, но и из специального файла.env, который находится в корне проекта. Этот файл не должен храниться в репозитории, ведь в нем конфидециальные данные: ключи, пароли. Он специфичен для окружения, в котором идет запуск. Вот его пример:

21 Это обычный текстовый файл, в каждой строке которого находится имя переменной и ее значение.python-dotenvавтоматически подгружает его, и затем эти переменные используются в коде, если это необходимо.

22 Чтобы подключитьpython-dotenv, необходимо в файле инициализации приложения (например,app.py) произвести следующие настройки:

23 Теперь можно использовать переменные окружения, которые описаны в файле.env:

24 <h2>WSGI</h2>

25 Любое веб-приложение, которое написано с использованием Flask, являетсяWSGI-приложением- Web Server Gateway Interface. Оно используется практически всеми веб-фреймворками для Python. Это соглашение об описании веб-приложения в виде обычной функции request -> response.

26 Приложение-функцию может вызывать любой WSGI-сервер, который берет на себя работу с сетью, запуск нужного количества копий приложения и раздачу им запросов.

27 Обычно в продакшене используют сервер с многоядерным процессором, а одновременных запросов может приходить помногу каждую секунду. Интерпретатор Python в силу особенностей реализации многопоточности не слишком эффективно работает с большим количеством одновременных задач.

28 WSGI-сервер знает об этих особенностях и позволяет эффективно использовать ресурсы железа. Он запускает одновременно несколько работающих интерпретаторов, следит за каждым из них и раздает им запросы поровну. А WSGI-интерфейс позволяет веб-разработчикам использовать всю возможность WSGI-серверов вне зависимости от выбранного фреймворка.

29 До этого момента мы запускали приложение с помощью команды flask. Эта команда запускает WSGI-приложение на упрощенном сервере разработчика. Этот сервер может обрабатывать только один запрос за раз и не позволяет запускать несколько интерпретаторов. При этом его не нужно настраивать, а приложение он умеет перезапускать сам, как только код будет изменен.

30 Это очень важные качества на этапе разработки. Поэтому веб-разработчик обычно использует и dev-сервер и полноценный WSGI-сервер - один при разработке, а второй в разработке для продакшена. Запустим наше приложение на продакшен-сервере.

31 <h2>Gunicorn</h2>

32 Один из самых популярных WSGI-серверов -<a>Gunicorn</a>. Установим его в наш проект - в то же виртуальное окружение, в которое установили flask:

33 Когда Gunicorn будет установлен, для запуска приложения вместо команды flask можно будет запустить приложение так:

34 Это пример типичной команды для запуска. Он показывает две самых важных опции Gunicorn:

35 <ul><li>Количество интерпретаторов, которые будут выполнять код приложения - воркеры</li>

36 <li>Адрес, запросы к которому и будет обслуживать сервер</li>

37 </ul>Вот соответствующие опции в приведенной команде:

38 <ul><li>--workers=4 - использовать четыре воркера</li>

39 <li>--bind=127.0.0.1:8000 - слушать порт 8000 на хосте 127.0.0.1</li>

40 </ul>WSGI-приложение указывается в виде полное.имя.модуля:переменная. Нужно указывать не имя файла, а имя модуля или пакета, который экспортирует переменную, ссылающуюся на WSGI-приложение - объект Flask.

41 <h2>Доставка приложений до сервера</h2>

42 Когда сайт написан, его нужно выложить в интернет. Стандартный путь включает три пункта:

43 <ol><li>Покупка домена</li>

44 <li>Покупка хостинга и его настройка</li>

45 <li>Деплой</li>

46 </ol>Рассмотрим эти пункты более подробно.

47 <h3>Покупка домена</h3>

48 Чтобы приобрести домен, необходимо обратиться в компании-регистраторы. Домен оплачивается раз в год и закрепляется за определенным человеком или компанией. Иногда хостер и регистратор - одна и та же компания. Тогда домен и сервер связываются одновременно. Иначе нужно производить определенные настройки на стороне сервера и подтверждать свое право владения доменом.

49 <h3>Покупка хостинга и его настройка</h3>

50 Хостинг - это ресурсы для размещения и обслуживания сайта в интернете. Хостинг бывает разным. Он может представлять уже полностью готовую среду, в которую заливается код сайта. Также он может быть просто железными серверами, которыми можно и нужно управлять самостоятельно.

51 Обычно работа с хостингом выглядит следующим образом:

52 <ol><li>Производится регистрации на сайте хостинга</li>

53 <li>Выбирается подходящий тариф и вид хостинга (On-Prem, IaaS, PaaS, SaaS) и привязывается банковская карточка</li>

54 <li>Предоставляется доступ к ресурсам, например, IP-адрес и пара логин/пароль для ssh- или ftp-доступа</li>

55 <li>При необходимости производится настройка хостинга и деплой проекта</li>

56 </ol><h3>Деплой</h3>

57 Деплой- процесс выкладки новой версии сайта на сервер. Этот процесс может быть довольно сложным и зависит от используемых технологий. Во время деплоя могут выполняться следующие задачи:

58 <ol><li>Код проекта скачивается на сервер - обычно через клонирование Git</li>

59 <li>Ставятся все необходимые зависимости</li>

60 <li>Выполняется процесс сборки, например, собирается фронтенд-часть</li>

61 <li>Выполняютсямиграции- SQL-скрипты, которые изменяют структуру базы данных</li>

62 <li>Запускается новая версия кода</li>

63 </ol>Во многих компаниях этот процесс выполняется руками. Программист заходит на сервер, запускает git pull и далее проходится по списку выше. Это худший способ деплоить. Деплой относится к тем задачам, которые должны быть автоматизированы.

64 Несмотря на разнообразие способов деплоя, есть одно важное правило для всех - деплоить можно только вперед. Деплой нельзя откатывать. И в первую очередь это касается миграций. Если после или во время деплоя что-то пошло не так, то правильно деплоить снова, но предыдущую версию.

65 Также деплои можно классифицировать по способу обновления и отката:

66 <ul><li>Последовательное обновление - сервера обновляются по очереди</li>

67 <li><a>Сине-Зеленый деплой</a>- полное дублирование инфраструктуры с подменой</li>

68 </ul>Отдельно стоит сказать про канареечный релиз - canary release. При таком подходе переключение на использование новой версии происходит постепенно - сначала для небольшого процента пользователей, а затем и для всех.

69 Способ деплоя зависит от используемого хостинга и способа настройки серверного окружения. Выделяют следующие типы хостингов:

70 <ul><li>Виртуальный хостинг (Shared Hosting)- самый дешевый способ размещать сайт в интернете. Такая услуга включает доступ на сервер с уже настроенным программным обеспечением под конкретный стек, например, Linux + Python + MySQL. Этот способ подходит для самых простых сайтов и требует минимальной настройки</li>

71 <li>VPS/VDS- наиболее сбалансированная услуга, в рамках которой предоставляется виртуальная машина. Плюс в том, что такой вид хостинга позволяет задействовать больше серверных мощностей: ЦПУ, память и диск. Предустановленного ПО нет, все нужно делать самостоятельно. По сравнению с виртуальным хостингом мы не ограничены в правах и можем настраивать сервер как угодно</li>

72 <li>Выделенный сервер (Dedicated Server)- сервер либо свой, либо арендованный. Такой хостинг требует больше всего участия, но зато мы получаем лучшее соотношение производительность/цена</li>

73 <li>IaaS (Infrastructure as a Service)- инфраструктура как сервис. Вид хостинга, при котором большая часть возможностей представляется как сервис, например, Amazon Web Service (AWS)</li>

74 <li>PaaS (Platform as a Service)- платформа как сервис. Наиболее дорогой и самый автоматизированный способ из коробки по размещению сайтов. Выкладка сайта происходит по команде git push. Кроме цены важно учитывать используемые технологии и подходы. PaaS обладает наибольшим числом ограничений по тому, что и как можно делать, но в обмен мы получаем не просто автоматизированный хостинг, но и платформу, которая автоматически масштабируется под нагрузку</li>

75 </ul>Все способы деплоя можно разбить на две большие категории: деплой на PaaS и деплой на все остальное.

76 <h4>Деплой на PaaS</h4>

77 Самый простой способ начать деплоить. Большинство PaaS-хостеров имеют бесплатные планы, достаточные для публикации учебных проектов. Из плюсов: не придется покупать адрес, домен третьего уровня предоставляется бесплатно.

78 Самое популярное PaaS-решение на текущий день -<a>Heroku</a>. Также в качестве бесплатной альтернативы Heroku мы предлагаем<a>Render</a>. Он поддерживает деплой как из Github репозиториев, так и из локальных с помощью cli-утилиты.

79 <h4>Деплой на все остальное</h4>

80 Если не брать в расчет самый примитивный виртуальный хостинг, который не позволяет настраивать серверное окружение, все остальные виды хостингов имеют схожие задачи для публикации.

81 Самая первая задача - настроить окружение. Если в виртуальном хостинге всегда есть набор предустановленных программ, то в остальных видах хостинга нет ничего, кроме голой операционной системы. Установка необходимого ПО такой же автоматизируемый процесс, как процесс деплоя, и у него есть даже собственное название - Управление конфигурациями (Configuration Management).

82 Рекомендуем использовать Ansible - популярное решение для настройки. На Хекслете есть соответствующий<a>курс</a>.

83 Ключевое понятие Ansible - Playbook (плейбук). Это файл или файлы в формате YAML. В них описывается, что нужно сделать на указанной машине. В каждом плейбуке используются готовые модули, которые поставляются вместе с Ansible. Этих модулей сотни, с помощью них можно делать практически всё: от установки программ до настройки сети и управления правами файловой системы.

84 Например, для установки python нужно воспользоваться следующим playbook:

85 Ansible - универсальный инструмент, с его помощью можно не только настраивать окружение, но и деплоить. При этом для деплоя есть готовый модуль -<a>deploy helper</a>.

86 В более продвинутых случаях, там где используется, например, Docker, развертывание осуществляется системами оркестрации, среди которых выделяется<a>Kubernetes</a>.