النشر على 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، وإلا فإن خدمات الواجهة الخلفية لـ 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 ثم اتباع الخطوات.

  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 واحصل على المساعدة من مطورينا.