Развёртывание на Ubuntu

Пошаговое руководство по развёртыванию OpenReplay на любой машине с Ubuntu.

Развёртывание на Ubuntu

Стек OpenReplay можно установить на одной машине под управлением Ubuntu. Вот как это сделать.

Предварительные требования

Section titled Предварительные требования
  • Операционной системой должна быть Ubuntu Server 22.04 Focal Fossa.
  • Минимальные характеристики машины, на которой запускается OpenReplay, — 2 vCPUs, 8 GB of RAM, 50 GB of storage, на архитектуре x86, иначе серверные сервисы OpenReplay просто не запустятся. Этого должно быть достаточно для низкого/умеренного объёма. Если вы ожидаете высокий трафик, вам следует масштабироваться от этих значений.
  • Публичный IP-адрес, указывающий на вашу машину.

Развёртывание OpenReplay

Section titled Развёртывание OpenReplay
  1. Убедитесь, что ваша машина запущена, затем подключитесь к ней по SSH как root

  2. Установите OpenReplay, указав домен, на котором он будет работать (например, DOMAIN_NAME=openreplay.mycompany.com):

sudo wget https://raw.githubusercontent.com/openreplay/openreplay/main/scripts/helmcharts/openreplay-cli -O /bin/openreplay 
sudo chmod +x /bin/openreplay
openreplay -i DOMAIN_NAME

OpenReplay работает с конфиденциальными данными пользователей и поэтому требует HTTPS для своей работы. Это обязательно, иначе трекер просто не начнёт запись. То же самое касается панели управления: без HTTPS вы не сможете воспроизводить сессии пользователей.

Поэтому вы должны предоставить (или сгенерировать) собственный SSL-сертификат.

  1. Сначала перейдите к вашему провайдеру DNS-услуг, отредактируйте свою DNS-зону и создайте A Record. Используйте домен, который вы ранее указали на этапе установки, и направьте его на машину, используя её публичный IP.

  2. Если вы предоставляете собственный сертификат, создайте SSL-секрет с помощью следующей команды: kubectl create secret tls openreplay-ssl -n app --key="private_key_file.pem" --cert="certificate.crt".

Примечание: Если у вас нет сертификата, сгенерируйте автоматически обновляемый сертификат для вашего поддомена (того, который вы указали во время установки) с помощью Let’s Encrypt. Просто подключитесь к машине OpenReplay, выполните cd /var/lib/openreplay/openreplay/scripts/helmcharts && bash certmanager.sh и следуйте инструкциям.

  1. Если вы хотите включить перенаправление с http на https (рекомендуется), раскомментируйте приведённый ниже блок в разделе ingress-nginx в файле /var/lib/openreplay/vars.yaml:
ingress-nginx: &ingress-nginx
  controller:
    config:
      ssl-redirect: true
      force-ssl-redirect: true

Стоит отметить, что наш ingress-nginx по умолчанию работает на портах 80|443, но при необходимости это легко изменить в vars.yaml:

ingress-nginx: &ingress-nginx
  controller:
    service:
      ports:
        http: 80
        https: 443
  1. Наконец, переустановите OpenReplay NGINX:
openreplay -R

Теперь всё готово, OpenReplay должен быть доступен на вашем поддомене. Вы можете создать учётную запись, посетив страницу /signup (т.е. openreplay.mycompany.com/signup).

Если вы столкнётесь с какими-либо проблемами, подключайтесь к нашему сообществу в Slack и получите помощь от наших разработчиков.