Перед началом работы

Выберите способ установки#

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

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

Установщик и инструменты выпуска оператора используют разные имена проектов Compose и оверлеи конфигурации. Не применяйте команду выпуска, скопированную из другого развертывания, к установке, созданной с помощью мастера.

Подготовка доступа к серверу#

Мастер может установить недостающие пакеты и Docker в Ubuntu или Debian с помощью apt и systemd. В других дистрибутивах Linux подготовьте зависимости самостоятельно перед запуском мастера. Серверу требуется локальный Docker Engine с правами суперпользователя. Удаленные контексты Docker и Docker без прав суперпользователя не поддерживаются.

• Сервер Linux с процессором amd64 (Intel / AMD x64) или arm64.
• Корневой доступ через sudo и интерактивный терминал. Выполняйте длительные сборки в tmux или screen, чтобы прерывание SSH не привело к завершению сеанса.
• Исходящий HTTPS-доступ к GitHub, реестрам контейнеров, репозиториям пакетов Linux и Alpine, зависимостям Go и npm, а также к базе данных уязвимостей Trivy.
• Новый каталог для установки ниже /opt или /srv. По умолчанию используется /opt/meetspace.
• Частная подсеть Docker /24, которая не пересекается с маршрутами сервера или другими сетями Docker. Мастер предлагает использовать 172.30.240.0/24.

Подготовьте домен и HTTPS#

Выберите выделенное имя хоста, например meet.example.com. Для интерактивного установщика единственная запись A в DNS должна указывать на публичный IPv4-адрес, назначенный непосредственно сетевому интерфейсу на сервере. Перед использованием этого установщика удалите запись AAAA с именем хоста.

При проверке сети мастер не принимает серверы, находящиеся за NAT, прокси-серверы CDN, сервисы, работающие только по протоколу IPv6, или балансировщики нагрузки. Для таких топологий требуется отдельное развертывание, включающее TURN и маршрутизацию мультимедиа.

Выберите сертификат Let’s Encrypt или уже существующий сертификат. Для Let’s Encrypt подготовьте адрес электронной почты и обеспечьте доступность TCP-порта 80 для выдачи и продления сертификатов. Для существующего сертификата подготовьте файлы fullchain.pem и незашифрованный privkey.pem в абсолютном пути. Сертификат должен соответствовать имени хоста, закрытому ключу, иметь доверенную цепочку сертификатов и оставаться действительным.

Продумайте хранение и обслуживание данных#

Выделите дополнительное место для записей, вложений, временных файлов записи, кэшей сборки и резервных копий. Данные приложения хранятся в PostgreSQL, объектном хранилище, совместимом с S3, и локальном хранилище записей. Копирование только каталога хранилища установки не является полноценной резервной копией.

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

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

Спланируйте первую функциональную проверку#

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

1. Откройте развернутое имя хоста по протоколу HTTPS и убедитесь, что браузер доверяет сертификату.
2. Создайте обычную учетную запись или войдите в нее, затем проверьте рабочее пространство и обмен сообщениями.
3. С согласия участников совершите звонок с двух устройств, в том числе с устройства, подключенного к другой сети.
4. Проверьте микрофон, камеру, возможность демонстрации экрана и функцию TURN. Если будет использоваться запись, проверьте, что запись идет от начала до конца.
5. Сравните конечные точки API и фронтенда с установленным манифестом и сохраните результаты в записи о развертывании.