يمكن تثبيت حزمة OpenReplay على جهاز واحد يعمل بنظام Ubuntu. إليك كيفية القيام بذلك.

• يجب أن يكون نظام التشغيل Ubuntu Server 20.04 Focal Fossa.
• الحد الأدنى لمواصفات الجهاز الذي يشغّل OpenReplay هو 2 vCPUs, 8 GB of RAM, 50 GB of storage، وإلا فإن خدمات الواجهة الخلفية لـ OpenReplay لن تبدأ ببساطة. يجب أن يكون هذا كافيًا لحجم منخفض/معتدل. إذا كنت تتوقع حركة مرور عالية، فيجب أن تتوسّع بدءًا من هنا.
• عنوان IP عام يشير إلى جهازك.

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 واتباع الخطوات.

3. إذا كنت ترغب في تمكين إعادة التوجيه من 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

4. أخيرًا، أعد تثبيت OpenReplay NGINX:

openreplay -R

أنت جاهز الآن، يجب أن يكون OpenReplay متاحًا على نطاقك الفرعي. يمكنك إنشاء حساب بزيارة صفحة /signup (أي openreplay.mycompany.com/signup).

إذا واجهت أي مشكلات، تواصل مع مجتمعنا على Slack واحصل على المساعدة من مطوّرينا.