Все статьи

Getting Started

Что такое CICDoo Начало работы: мастер настройки Панель и карта инфраструктуры

Concepts

Стадии: продакшн, staging и разработка Домены, поддомены и SSL Версии и редакции Odoo (Community или Enterprise) Воркспейсы и командная работа

Servers

Добавление сервера Домены сервера и DNS Использование балансировщика нагрузки Подключение через jump-сервер Действия с сервером: деплой, логи и графики Deleting a server

Projects & Git

Создание проекта Подключение GitHub Project GitHub settings and webhook Подключение GitLab Ветки и инстансы Теги и фильтрация проектов Высокая доступность с узлами приложения Project environments, extensions and deletion

Instances & Console

Создание инстанса Перезапуск, остановка и удаление инстанса Слияние веток между стадиями Web IDE и удалённый доступ SSH access to instances Настройки инстанса Деплои и очередь задач

Agent Tasks

Что такое задачи агента Настройка задач агента Запуск задачи и разбор результата Время агента и его пополнение Agent insights and task filters

Monitoring & Backups

Мониторинг инстанса Резервные копии и восстановление S3 storage, uploads and bulk backup actions Уведомления об инцидентах (email и SMS)

Workspaces & Permissions

Приглашение участников в воркспейс Права участников и доступ к ресурсам Участник не видит ресурс или не может им пользоваться Audit log and server activity

Account & Security

Двухфакторная аутентификация (2FA) Настройки профиля и интеграций Пароли и восстановление доступа Instance security score and checks The Security page: every instance and member at a glance

Billing & Plans

Тарифы и цены Повышение тарифа и управление подпиской Если подписка на проект не оплачена Партнёрская программа Onboarding a client as a partner

Support & Tickets

Создание тикета в поддержку Помощь от команды CICDoo

Troubleshooting

Устранение неполадок: не удаётся подключить сервер Устранение неполадок: деплой завершился ошибкой Устранение неполадок: git push возвращает 403 после переноса репозитория Устранение неполадок: инстанс недоступен или работает медленно Устранение неполадок: проблемы с доменом или SSL

Проекты и Git

Высокая доступность с узлами приложения

Как запустить одну продакшн-базу Odoo на нескольких серверах, где основной проект работает с базой данных, а узлы приложения обслуживают её.

Как это работает

Высокая доступность позволяет запускать продакшн одной базы Odoo сразу на нескольких серверах. Если один сервер перестаёт отвечать, посетители направляются на остальные.

Кластер состоит из проектов с одинаковым кодом:

  • Основной проект: проект, продакшн-инстанс которого запускает Odoo и базу данных. Его база данных открыта для узлов приложения и ни для кого больше.
  • Узлы приложения: другие проекты, каждый на своём продакшн-сервере, продакшн-инстанс которых запускает только Odoo и использует базу данных основного проекта.
  • Реплики: узлы приложения, которые также хранят на своём сервере резервную копию базы основного проекта, готовую подхватить работу, если основной потерян.

Посетители заходят по адресу основного проекта. CICDoo направляет этот адрес на основной проект и на каждый отвечающий узел приложения и проверяет каждый узел раз в несколько минут. Узел, который перестал отвечать, исключается из адреса, пока не восстановится.

Сама база данных работает на одном сервере, сервере основного проекта. Узлы приложения делают избыточной часть Odoo. Чтобы защитить и базу, добавьте реплику: если сервер основного проекта потерян, вы повышаете реплику, и сайт продолжает работу с её копии. См. "Реплики и переключение" ниже.

Перед началом

  • Одинаковый код: все проекты кластера должны использовать один и тот же репозиторий, ветку по умолчанию, версию и редакцию Odoo. Если включена Time Machine, закреплённые коммиты тоже должны совпадать.
  • Разные серверы: у каждого узла приложения должен быть свой продакшн-сервер, отличный от сервера основного проекта и от серверов других узлов.
  • Прокси Cloudflare: распределение трафика между узлами сейчас работает для серверов, на которых включён прокси Cloudflare. Используйте серверы в одном регионе, так как каждая страница, которую отдаёт узел приложения, обращается к базе данных основного проекта.
  • Общий filestore: каждый сервер кластера должен монтировать одно и то же общее хранилище для filestore Odoo. Без него вложение, загруженное через один узел, отсутствует на остальных, а посетитель, попавший на другой узел, разлогинивается. Обратитесь в поддержку, если нужна помощь с настройкой.
  • Подключения к базе данных: каждый узел приложения открывает собственные подключения к базе данных основного проекта. По мере добавления узлов увеличивайте max_connections в разделе Конфигурация PostgreSQL продакшн-инстанса основного проекта, на вкладке Настройки его консоли.
  • Сколько реплик: каждой реплике нужен свой продакшн-сервер. С настройками PostgreSQL по умолчанию основной может питать около девяти реплик, и каждая может удерживать до 20 ГБ изменений на диске основного, пока отстаёт.

Настройки высокой доступности находятся в Настройках проекта, на вкладке Дополнительно, в карточке Высокая доступность. Вам нужно право изменять настройки проекта.

Настройка основного проекта

Откройте проект, который будет работать с базой данных, перейдите в Настройки проекта > Дополнительно и в карточке Высокая доступность установите Роль в значение Основной (приложение + база данных). Нажмите Применить и подтвердите.

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

Продакшн-инстанс должен использовать собственную встроенную базу данных. Проект, продакшн-инстанс которого указывает на внешнюю базу данных, не может быть основным.

Добавление узла приложения

Создайте проект для узла как обычно: тот же репозиторий и ветка по умолчанию, та же версия и редакция и собственный продакшн-сервер. Удалите все его staging- и dev-инстансы: узел приложения работает только в продакшне, а ветки staging и разработки живут в основном проекте.

Затем откройте Настройки проекта > Дополнительно узла, установите Роль в значение Узел приложения (использует базу основного), выберите основной проект в поле Источник базы данных, нажмите Применить и подтвердите. Предлагаются только основные проекты из того же воркспейса с тем же кодом.

Узел запускается не сразу. Сначала сервер основного проекта должен его допустить, это происходит при следующей проверке, обычно в течение пяти минут. До этого карточка показывает "Ожидаем, пока основной проект разрешит этот узел", а узел запускается сам, как только получит разрешение. Через несколько минут после того, как он начнёт отвечать, на него начинают поступать посетители.

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

Реплики и переключение

Реплика это узел приложения, на котором также работает резервная копия базы основного проекта. Основной передаёт ей каждое изменение, поэтому копия обычно отстаёт лишь на несколько секунд. Odoo на реплике обслуживает посетителей как на любом узле приложения, используя базу основного.

Чтобы добавить реплику, подготовьте проект так же, как для узла приложения, установите Роль в значение Реплика (узел приложения + резервная копия базы), выберите основной проект в поле Источник базы данных и нажмите Применить. На основном должен работать PostgreSQL 13 или новее, это вариант по умолчанию начиная с Odoo 15, а реплика должна использовать ту же версию PostgreSQL. При подключении собственная база проекта-реплики заменяется копией; её старые данные откладываются на сервере, а не удаляются. На большой базе первое копирование занимает время.

Карточка Высокая доступность реплики показывает состояние копии:

  • Копируется: идёт первое копирование.
  • Переключается на новый основной: другую реплику сделали основной, и эта копия переключается на неё. Она сохраняет уже имеющиеся данные, поэтому обычно это быстро.
  • Синхронизируется: копия следует за основным.
  • Отстаёт: копия отстала больше чем на несколько сотен МБ или пока перестала следовать за основным.
  • Сломана: основной больше не хранит изменения, нужные копии. Нажмите Пересоздать копию, чтобы получить свежую.

Если сервер основного проекта потерян, откройте карточку Высокая доступность реплики, нажмите Сделать основным и введите имя проекта для подтверждения. База реплики становится базой кластера, реплика становится основным проектом, а все остальные узлы перезапускаются с ней. Сайт сохраняет свой адрес. Старый основной становится узлом приложения: когда его сервер возвращается, он запускается без собственной базы и не получает посетителей, пока не перезапустится таким образом. Изменения, сделанные старым основным после последней синхронизации копии, теряются, поэтому повышайте реплику, только если основной нельзя восстановить. Повышение никогда не происходит автоматически. Остальные реплики сохраняют свою копию и переключаются на новый основной. Если какая-то из них ушла вперёд повышенной реплики, её откатывают до совпадения с ней, и только если это невозможно, она копирует базу заново. Если карточка реплики сообщает, что у другой реплики была более свежая копия, сделайте основной ту: вы потеряете меньше изменений.

Реплика использует настройки PostgreSQL основного проекта. После изменения Конфигурации PostgreSQL продакшн-инстанса основного перезапустите реплики.

Чтение с реплики

В Odoo 18 и новее любой проект кластера может отправлять работу только на чтение на реплику: списки и формы, сгруппированные представления, отчёты и экспорт. Все записи по-прежнему идут в основной, а запрос, которому всё же нужна запись, автоматически повторяется там. Это снимает нагрузку с сервера базы основного.

Откройте Настройки проекта > Дополнительно, выберите реплику в поле Запросы только на чтение в карточке Высокая доступность и нажмите Применить. Реплика может читать и из собственной копии. Проект перезапустится, когда реплика это разрешит, обычно в течение пяти минут.

Данные на реплике могут немного отставать от основного. Когда реплика отстаёт, останавливается или ломается, CICDoo закрывает её для читающих, и Odoo сам переключается на основной без перезапуска. Чтение возвращается на неё примерно в течение получаса после восстановления синхронизации.

Что меняется на узле приложения

  • У его продакшн-инстанса нет собственной базы данных. Её настройки управляются CICDoo и не могут быть изменены в конфигурации Odoo инстанса.
  • Запланированные задачи (cron в Odoo) выполняются только на основном проекте.
  • Резервные копии делаются на основном проекте. Создавайте и восстанавливайте резервные копии базы данных кластера из основного проекта.
  • Push в ветку узла приложения сам по себе ничего не делает. Кластер обновляется из основного проекта.
  • Консоль узла приложения скрывает shell базы данных, резервные копии и настройки PostgreSQL, которые находятся на основном. Реплика сохраняет shell базы, который открывает её копию только для чтения.

Деплой обновлений

Делайте push в ветку основного проекта как обычно. Затем CICDoo обновляет весь кластер по порядку:

  1. Каждый узел приложения останавливается.
  2. Обновляется основной проект, включая обновление модулей, пока никакой другой сервер не использует базу данных.
  3. Каждый узел приложения запускается снова с новым кодом.

Каждый шаг можно отслеживать на вкладке Очередь инстанса, на котором он выполняется. Если обновление основного проекта не удалось, узлы приложения не запускаются снова, а их записи в очереди объясняют причину. Устраните проблему и выполните деплой ещё раз.

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

Выход из кластера

Чтобы убрать узел приложения, верните его Роль в значение Отдельно (своя база данных) и нажмите Применить. Его продакшн-инстанс останавливается, потому что собственная база данных не содержит данных кластера. Восстановите в неё резервную копию, прежде чем запускать его снова.

Основной проект нельзя изменить, пока у него есть узлы приложения. Сначала уберите узлы.

Устранение неполадок

  • Узел всё ждёт разрешения: проверьте, что продакшн-инстанс основного проекта запущен и его сервер в сети. После назначения основным проект должен один раз перезапуститься, прежде чем будет допущен хоть один узел.
  • Узел запускается, но Odoo не поднимается: откройте логи узла. Сообщение о том, что база данных основного проекта не инициализирована, означает, что основной проект ещё не завершил первый запуск.
  • Загрузки или входы не сохраняются при переходе посетителя между узлами: серверы не используют общий filestore. См. раздел "Перед началом" выше.
  • Реплика долго в состоянии Копируется: проверьте, что продакшн-инстанс основного запущен. Копирование начинается, как только основной разрешил реплику, а перезапуск реплики на вкладке Очередь показывает ход копирования или ошибку.

О том, как инстансы соответствуют веткам, см. Ветки и инстансы, а о настройке балансировщика нагрузки на уровне сервера, которая является отдельной функцией, см. Использование балансировщика нагрузки.

Запустите это на своих серверах с CICDoo

Подключите сервер и привяжите репозиторий. Деплои, резервные копии и мониторинг уже настроены, а инженеры Odoo на расстоянии одного сообщения.

Всё ещё не получается? Откройте тикет из приложения или свяжитесь с инженером.