Этот сайт использует файлы cookies

ИНСТРУКЦИЯ ПО УСТАНОВКЕ ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ

1. Назначение документа

Настоящая инструкция определяет порядок установки и первичного развертывания программного обеспечения.

Установка программного обеспечения выполняется в автоматизированном режиме с использованием системы управления конфигурациями Ansible.

2. Требования к программно-аппаратной среде

Перед началом установки необходимо подготовить серверную инфраструктуру.

Сервер приложений

Минимальная конфигурация:

  • процессор — 4 vCPU;

  • оперативная память — 16 ГБ;

  • дисковое пространство SSD — 70 ГБ;

  • веб-сервер Nginx;

  • среда выполнения PHP.

Сервер базы данных PostgreSQL

Минимальная конфигурация:

  • процессор — 4 vCPU;

  • оперативная память — 16 ГБ;

  • дисковое пространство SSD — 80 ГБ;

  • установленная СУБД PostgreSQL.

Сервер аналитической базы данных ClickHouse

Минимальная конфигурация:

  • процессор — 4 vCPU;

  • оперативная память — 4 ГБ;

  • дисковое пространство SSD — 100 ГБ;

  • установленная СУБД ClickHouse.

Сервер Grafana

Минимальная конфигурация:

  • процессор — 2 CPU;

  • оперативная память — 4 ГБ;

  • дисковое пространство SSD — 55 ГБ.

3. Требования к программному обеспечению

На всех серверах должна быть установлена операционная система семейства Linux.

Рекомендуется использовать актуальные LTS-дистрибутивы с установленными обновлениями безопасности.

На сервере приложений должны быть установлены:

  • Nginx;

  • PHP с необходимыми расширениями;

  • systemd;

  • средства журналирования.

На сервере базы данных должна быть установлена поддерживаемая версия PostgreSQL.

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

4. Требования к сети

Перед началом установки необходимо обеспечить:

  • сетевую связность между всеми серверами;

  • доступ сервера приложений к PostgreSQL;

  • доступ сервера приложений к ClickHouse;

  • при необходимости — доступ Grafana к PostgreSQL;

  • доступ пользователей к серверу приложений по протоколу HTTPS.

Прямой доступ пользователей к серверам баз данных не требуется.

5. Подготовка к установке

Перед запуском установки необходимо:

  • Подготовить серверы согласно требованиям настоящей инструкции.

  • Установить операционные системы.

  • Настроить сетевые параметры.

  • Настроить DNS либо записи hosts.

  • Синхронизировать системное время.

  • Создать учетные записи администраторов.

  • Обновить системные пакеты.

  • Установить Ansible на управляющий сервер.

  • Обеспечить SSH-доступ ко всем серверам.

  • Обеспечить доступ к репозиторию программного обеспечения.

  • Проверить доступ к репозиториям программных зависимостей.

6. Порядок установки

После подготовки инфраструктуры администратор запускает сценарий автоматизированной установки Ansible.

Во время выполнения сценария автоматически выполняются следующие операции:

  • определение типа развертывания;

  • установка системных компонентов;

  • получение исходного кода программного обеспечения;

  • установка необходимых зависимостей;

  • создание конфигурации приложения;

  • настройка параметров окружения;

  • сборка клиентской части;

  • выполнение миграций базы данных PostgreSQL;

  • выполнение миграций базы данных ClickHouse;

  • обновление объектов баз данных;

  • очистка кэша приложения;

  • настройка прав доступа к каталогам и файлам.

По окончании выполнения сценария программное обеспечение автоматически переводится в рабочее состояние.

7. Проверка успешности установки

После завершения установки необходимо убедиться, что:

  • установка завершилась без ошибок;

  • приложение доступно по сетевому адресу;

  • установлено соединение с PostgreSQL;

  • установлено соединение с ClickHouse;

  • миграции баз данных выполнены успешно;

  • журналы работы приложения не содержат критических ошибок.

При успешном выполнении указанных проверок программное обеспечение считается установленным и готовым к эксплуатации.

8. Завершение установки

После успешной проверки рекомендуется выполнить первичный контроль работоспособности программного обеспечения и приступить к его эксплуатации в соответствии с эксплуатационной документацией.