Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-26

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

2 В этом уроке разберем, где хранить конфигурацию.

3 <h2>Приложение двенадцати факторов</h2>

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

5 <ul><li>Часть этих данных секретная. Хранить их в репозитории нельзя из-за возможных проблем с безопасностью. Любой, у кого есть доступ к репозиторию, сможет получить доступ. Есть вариант с шифрованием, но он выходит за рамки обсуждаемой темы. Для интересующихся рекомендуем изучить<a>Ansible Vault</a></li>

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

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

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

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

10 <h2>Переменные окружения</h2>

11 У Django большое количество настроек для разных подсистем, которые задаются через файлsettings.py. Например, так можно запустить фреймворк в режиме отладки:

12 Таких переменных довольно много. Например, они отвечают за настройку кеширования или за отправку почты. Все они указываются в файлеsettings.py.

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

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

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

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

17 <li>Необходимо конвертировать типы вручную</li>

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

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

20 Чтобы подключитьpython-dotenv, необходимо в файлеsettings.pyпроизвести следующие настройки:

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

22 Для конфигурации продакшен-окружения одной библиотекой не обойтись. Здесь нужно применять либо системы управления конфигурацией, такие как<a>Ansible</a>, либо использовать системы оркестрации, например,<a>Kubernetes</a>, либо системы, подобные<a>Vault</a>.

23 <h2>База данных</h2>

24 По умолчанию Djano создает локальную SQLite базу, но в продакшен среде зачастую требуется другая база с отдельным сервером. Чтобы поменять базу, достаточно указать параметры подключения в переменной DATABASES файлаsettings.py.

25 В зависимости от среды (разработка или продакшен) нам может понадобиться и разная база. Локальная для тестирования в разработке и уже полноценная для задеплоенного приложения. В дополнение, указывать все параметры подключения в коде нельзя - это небезопасно, и потому они также передаются через переменную окружения. Для решения этих задач есть сторонняя библиотека<a>dj-database-url</a>:

26 В примере выше, по умолчанию используется локальная SQLite база. При этом, если будет указана база по ссылке DATABASE_URL, то использоваться будет она. Так мы можем разделять среду разработки и деплоя.

27 Ссылку на базу, как и все конфиденциальные переменные мы также храним в .env.