يثبت

البرنامج النصي لإعداد Redash مع Docker على Linux

يعد هذا إعدادًا مرجعيًا لـ Redash على خادم Linux واحد.

ويستخدم Docker وDocker Compose للنشر والإدارة.

هذا هو نفس الإعداد الذي نستخدمه لصورنا الرسمية (لـ AWS وGoogle Cloud) ويمكن استخدامه كمرجع إذا كنت تريد إعداد Redash يدويًا في بيئة مختلفة (نظام تشغيل مختلف أو موقع نشر مختلف).

• setup.sh هو البرنامج النصي الذي يقوم بتثبيت كل شيء وإنشاء الدلائل.
• compose.yaml هو إعداد Docker Compose الذي نستخدمه.
• packer.json هو تكوين Packer الذي نستخدمه لإنشاء الصور السحابية.

تم اختباره

• ألما لينكس 8.x و9.x
• سينتوس ستريم 9.x
• ديبيان 12.x
• فيدورا 38 و 39 و 40
• أوراكل لينكس 9.x
• ريد هات إنتربرايز لينكس 8.x و9.x
• روكي لينكس 8.x و9.x
• أوبونتو LTS 20.04 و22.04

كيفية استخدام هذا

يجب تشغيل هذا البرنامج النصي كمستخدم root على نظام Linux مدعوم (حسب القائمة أعلاه):

 # ./setup.sh

عند التشغيل، سيقوم البرنامج النصي بتثبيت الحزم المطلوبة (معظمها Docker) ثم يقوم بتثبيت Redash، وهو جاهز لتهيئته والبدء في استخدامه.

نصيحة

إذا لم تكن تستخدم نظام Linux مدعومًا، فيمكنك تثبيت "docker" و"docker compose" يدويًا،
ثم قم بتشغيل البرنامج النصي لبدء عملية تثبيت Redash.

مهم

في المرة الأولى التي تقوم فيها بتحميل واجهة ويب Redash الخاصة بك، قد يستغرق الأمر بعض الوقت للظهور، حيث يتم تجميع كود Python الخاص بالخلفية. وفي الزيارات اللاحقة، من المفترض أن يتم تحميل الصفحات بشكل أسرع بكثير (على الفور تقريبًا).

المعلمات الاختيارية

يحتوي برنامج الإعداد على ثلاث معلمات اختيارية، --dont-start و --preview و --overwrite .

يمكن استخدامها بشكل مستقل عن بعضها البعض، أو مع بعضها البعض في أي مجموعة.

--معاينة

عند إعطاء المعلمة --preview ، سيقوم البرنامج النصي للإعداد بتثبيت أحدث صورة preview من Docker Hub بدلاً من استخدام الإصدار الرسمي الأخير.

 # ./setup.sh --preview

--الكتابة

حذر

لا تستخدم هذه المعلمة إذا كنت تريد الاحتفاظ بتثبيت Redash الموجود لديك! سيتم الكتابة فوقه.

عندما يتم إعطاء خيار --overwrite ، سيقوم البرنامج النصي للإعداد بحذف ملف بيئة Redash الموجود ( /opt/redash/env ) وقاعدة بيانات Redash، ثم يقوم بإعداد تثبيت Redash جديد (فارغ).

 # ./setup.sh --overwrite

--لا تبدأ

عند تحديد هذا الخيار، سيقوم البرنامج النصي للإعداد بتثبيت Redash دون تشغيله بعد ذلك.

يعد هذا مفيدًا للأشخاص الذين يرغبون في تخصيص أو تعديل تثبيت Redash الخاص بهم قبل أن يبدأ لأول مرة.

 # ./setup.sh --dont-start

التعليمات

هل يمكنني استخدام هذا في الإنتاج؟

لعمليات النشر على نطاق صغير - نعم. لكن بالنسبة لعمليات النشر الأكبر، نوصي على الأقل بتقسيم قاعدة البيانات (وربما Redis) إلى خادم خاص بها (ويفضل أن تكون خدمة مُدارة مثل RDS) وإعداد خادمين على الأقل لـ Redash للتكرار. ستحتاج أيضًا إلى تعديل عدد العاملين بناءً على أنماط الاستخدام الخاصة بك.

كيف يمكنني الترقية إلى الإصدارات الأحدث من Redash؟

راجع دليل الترقية.

كيف يمكنني استخدام setup.sh على نظام تشغيل مختلف؟

ستحتاج إلى إنشاء وظيفة تثبيت عامل إرساء تناسب نظام التشغيل لديك، وربما وظائف أخرى أيضًا.

لا ينبغي أن تكون وظائف install_docker_*() في setup.sh صعبة للغاية للتكيف مع توزيعات Linux الأخرى.

كيف يمكنني إزالة Redash إذا لم أعد بحاجة إليه؟

1. أوقف حاويات Redash وأزل الصور باستخدام docker compose -f /opt/redash/compose.yaml down --volumes --rmi all .

2. قم بإزالة الأسطر التالية من ~/.profile و ~/.bashrc إذا كانت موجودة.

    export COMPOSE_PROJECT_NAME=redash
   export COMPOSE_FILE=/opt/redash/compose.yaml
   

3. احذف مجلد Redash باستخدام sudo rm -fr /opt/redash