يمكن تثبيت حزمة OpenReplay على جهاز واحد، و Google Cloud هو مرشح مثالي لذلك.

1. انتقل إلى لوحة تحكم ‘Compute Engine’ واختر ‘VM Instances’ من شريط القائمة الموجود على الجانب الأيسر
2. انقر على ‘Create Instance’
3. اختر ‘region’ و ‘zone’ المفضلين لديك
4. اختر نوع الجهاز. الحد الأدنى من المواصفات هو 2 vCPUs, 8 GB of RAM, 50 GB of storage، وإلا فلن تبدأ خدمات الواجهة الخلفية لـ OpenReplay ببساطة. لذلك، نوصي على الأقل بـ n2-standard-2 (أو ما يعادله — لاحظ أن e2-standard-2 معروف بأنه يسبب مشكلات أثناء النشر)، وهو كافٍ لحجم منخفض/معتدل. إذا كنت تتوقع حركة مرور عالية، فينبغي عليك التوسع انطلاقًا من هنا.
5. غيّر قرص الإقلاع إلى Ubuntu 20.04 LTS أو أحدث، ثم اختر SSD persistent disk كنوع لقرص الإقلاع واضبط الحجم على 50 GB.
6. ضع علامة على كل من ‘Allow HTTP traffic’ و ‘Allow HTTPS traffic’ في Firewall
7. انقر على ‘Create’

بمجرد أن يصبح مثيلك في حالة Running، اتصل به بالضغط على زر SSH، ثم ثبّت 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 لكي يعمل. هذا إلزامي، وإلا فلن يبدأ المتعقب (tracker) في التسجيل ببساطة. وينطبق الأمر نفسه على لوحة التحكم؛ فبدون HTTPS لن تتمكن من إعادة تشغيل جلسات المستخدمين.

أسهل طريقة للتعامل مع SSL في Google Cloud هي إعداد موازن تحميل (Google Load Balancing) وتشغيل OpenReplay خلفه. هناك خيار آخر وهو إنشاء شهادة SSL خاصة بك أو استخدام شهادتك الخاصة وتوجيه نطاقك الفرعي (أي openreplay.mycompany.com) إلى مثيل OpenReplay. المزيد من التفاصيل حول كلا الخيارين أدناه.

الخطوة الأولى هي إضافة مجموعة مثيلات (instance group) ستكون مطلوبة لاحقًا لموازن التحميل:

1. انتقل إلى ‘Compute Engine’ > ‘Instance Groups’
2. ‘Create Instance Group’ واختر New unmanaged instance group
3. اختر ‘Location’ المفضل لديك ثم اختر ‘Network’ واختر مثيل الجهاز الافتراضي الخاص بـ OpenReplay
4. انقر على ‘Create’

حان الوقت الآن لإنشاء موازن التحميل:

1. انتقل إلى ‘Network Services’ > ‘Load Balancing’
2. ‘Create Load Balancer’ واختر HTTP(S) Load Balancing
3. اختر ‘From Internet to my VMs’ ثم انقر على ‘Continue’
4. ابدأ بـ ‘Backend configuration’ وانقر على ‘Backend services’ > ‘Create a backend service’
5. اختر Instance group لـ ‘Backend type’. في ‘Backends’ > ‘New backend’، اختر مجموعة المثيلات التي أنشأتها سابقًا، واضبط المنفذ على 80 ثم اضغط على ‘Done’.
6. مرّر للأسفل إلى ‘Health Check’ و ‘Create a health check’. اختر HTTP لـ ‘Protocol’، واضبط ‘Port’ على 80 ثم غيّر ‘Request path’ إلى /healthz. احتفظ بالقيم الافتراضية الأخرى، ثم اضغط على ‘Save’.
7. انقر على ‘Create’
8. في ‘Frontend configuration’، اختر HTTPS لـ ‘Protocol’ ثم في ‘Certificate’ أنشئ شهادة جديدة (تُدار بواسطة Google) أو استخدم شهادتك الخاصة. اضغط على ‘Done’.
9. راجع ثم انقر على ‘Create’

بمجرد الإنشاء، انتقل إلى Cloud DNS (أو مزود خدمة DNS الخاص بك) وأنشئ A Record يشير إلى موازن التحميل باستخدام عنوان IP الخاص به (يمكن العثور عليه في لوحة تحكم Load Balancing).

وأخيرًا، فعّل use-forwarded-headers عبر إزالة التعليق عن السطر أدناه ضمن قسم ingress-nginx في /var/lib/openreplay/vars.yaml:

ingress-nginx: &ingress-nginx
  controller:
    config:
      use-forwarded-headers: true

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

كبديل لإنشاء موازن تحميل، يمكنك استخدام (أو إنشاء) شهادة SSL الخاصة بك.

1. أولاً، انتقل إلى Cloud DNS (أو مزود خدمة DNS الآخر الخاص بك) وأنشئ A Record. استخدم النطاق الذي قدمته سابقًا أثناء خطوة التثبيت ووجّهه إلى الجهاز الافتراضي باستخدام عنوان IP العام الخاص به (يمكن العثور عليه في لوحة تحكم Compute Engine).

2. إذا كنت ستستخدم شهادتك الخاصة، فأنشئ SSL secret باستخدام الأمر التالي: 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. أخيرًا، أعد تثبيت NGINX الخاص بـ OpenReplay:

openreplay -R

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

إذا واجهت أي مشكلات، انضم إلى Slack الخاص بنا أو تفقّد المنتدى واحصل على المساعدة من مجتمعنا.