تثبيت وتكوين مشرف على أوبونتو 16.04

• التثبيت والتكوين الأساسي
• بدء خادم المشرف
• مضيفا البرامج
• إدارة البرامج
• عميل خادم الويب
• استنتاج

المشرف هو نظام عميل / خادم يستخدم للتحكم في عدد من عمليات UNIX ، وبشكل أكثر تحديدًا العمليات المتعلقة بمشروع أو عميل. على سبيل المثال ، يمكنك استخدام المشرف لتوليد ومراقبة عدد عشوائي من قوائم انتظار العمال لتطبيق الويب الخاص بك.

مكونات هذا النظام هي:

• المشرف: قطعة الخادم للنظام.
• supervisorctl: واجهة سطر الأوامر المستخدمة للتفاعل مع الخادم.
• خادم الويب: خادم ويب بسيط وواجهة مستخدم ويب مع وظائف أساسية مقارنة بالمشرف .
• واجهة XML-RPC: يخدم نفس خادم HTTP الذي يستخدمه عميل الويب واجهة XML-RPC التي يمكن استخدامها للتحكم في برامج المشرف.

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

التثبيت والتكوين الأساسي

سنقوم بتركيب المشرف من خلال easy_installميزة أدوات إعداد الثعبان.

أولاً ، قم بتحديث قائمة الحزم المحلية الخاصة بك ثم قم بتثبيت python setuptools.

sudo apt-get update && sudo apt-get install python-setuptools

الآن يمكننا تثبيت المشرف.

sudo easy_install supervisor

بمجرد اكتمال التثبيت ، يتعين علينا إنشاء ملف التكوين الخاص بنا. قم بإنشاء مجلد يسمى supervisorبالداخل /etc.

sudo mkdir /etc/supervisor

ثم نفذ ما يلي.

echo_supervisord_conf >  /etc/supervisor/supervisord.conf

إذا لم تقم بتسجيل الدخول مع rootالمستخدم ، فقد تحصل على Permission deniedخطأ (حتى مع sudo). هذا يرجع إلى إعادة التوجيه. للتغلب على هذا ، قم بتسجيل الدخول كجذر.

sudo su

ثم يمكنك تشغيل الأمر مرة أخرى.

echo_supervisord_conf > /etc/supervisor/supervisord.conf

يمكنك الآن ترك الأمر rootللمستخدم exit. و echo_supervisord_confقدمت الأوامر تركيب المشرف لدينا.

التكوين الأساسي

افتح /etc/supervisor/supervisord.confالملف وتحقق من محتوياته. ستلاحظ أن ملف التكوين هذا يتبع INIبناء الجملة ، ويتم تقسيمه حسب الأقسام (يمثله الأقواس كما في [section-name]).

لإضافة برامج يديرها المشرف ، نحتاج فقط إلى إنشاء [program]الأقسام المناسبة . ومع ذلك ، لتجنب العبث مع ملف التكوين الرئيسي في كل مرة نحتاج فيها إلى إضافة (أو تغيير) برنامج ، سنستخدم [include]القسم. ابحث عن هذا القسم ، قم بإلغاء تعليقه ثم قم بتحريره ليبدو كما يلي.

[include]
files=conf.d/*.conf

الآن لكل برنامج نريد إضافته ، سنقوم بإنشاء .iniملف داخل /etc/supervisor/conf.d/الدليل. يتيح إنشاء هذا المجلد.

sudo mkdir /etc/supervisor/conf.d

بدء خادم المشرف

كما أشرنا من قبل ، يتألف المشرف من خادم وعملاء يتصلون به. حتى نتمكن من إدارة البرامج والتحكم فيها ، نحتاج إلى تشغيل الخادم. للقيام بذلك ، سوف نقوم بتسجيل خادم المشرف في systemd، حتى يمكن بدء تشغيل الخادم عند بدء تشغيل النظام.

للقيام بذلك ، قم بإنشاء ملف يسمى supervisord.serviceفي /etc/systemd/systemالدليل.

sudo touch /etc/systemd/system/supervisord.service

أضف المحتويات التالية إلى الملف.

[Unit]
Description=Supervisor daemon
Documentation=http://supervisord.org
After=network.target

[Service]
ExecStart=/usr/local/bin/supervisord -n -c /etc/supervisor/supervisord.conf
ExecStop=/usr/local/bin/supervisorctl $OPTIONS shutdown
ExecReload=/usr/local/bin/supervisorctl $OPTIONS reload
KillMode=process
Restart=on-failure
RestartSec=42s

[Install]
WantedBy=multi-user.target
Alias=supervisord.service

تفعيل خدمة المشرف.

sudo systemctl start supervisord.service

طالما أن ملف الخدمة موجود في /etc/systemd/systemالدليل ، فسيبدأ تشغيله تلقائيًا عند بدء تشغيل النظام.

يمكنك التحقق من حالة الخدمة.

systemctl status supervisord.service

أيضا ، يمكنك التحقق من السجلات.

sudo journalctl -u supervisord.service

مضيفا البرامج

يتم إعطاء البرامج التي يتحكم بها المشرف من قبل [program]أقسام مختلفة في التكوين. لكل برنامج نريد إدارته ، سنقوم بإنشاء ملف تكوين مستقل لإبلاغ المسار القابل للتنفيذ للأوامر ، أي متغيرات بيئية ، وكيفية التنفيذ في حالة إيقاف التشغيل.

أولاً ، لننشئ نصًا بسيطًا يسجل الطابع الزمني. قم بإنشاء ملف يسمى hello_supervisor.sh(في أي مكان ترغب فيه ، سنشير إلى المسار الكامل لهذا البرنامج النصي).

touch hello_supervisor.sh

الآن ، ضع المحتويات التالية فيه

#!/bin/bash
while true
do 
    # Echo current timestamp to stdout
    echo Hello Supervisor: `date`
    # Echo 'error!' to stderr
    echo An error ocurred at `date`! >&2
    sleep 1
done

الآن اجعلها قابلة للتنفيذ

chmod +x hello_supervisor.sh

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

sudo touch /etc/supervisor/conf.d/hello_supervisor.conf

الآن ضع المحتويات التالية في هذا الملف.

[program:hello_supervisor]
command=/home/USER/hello_supervisor.sh
autostart=true
autorestart=true
stderr_logfile=/var/log/hello_supervisor.err.log
stdout_logfile=/var/log/hello_supervisor.out.log

ملاحظة: تأكد من استبدال USERاسم المستخدم الخاص بك.

سنراجع هذا التكوين خطوة بخطوة.

[program:hello_supervisor]
command=/home/USER/hello_supervisor.sh

أولاً ، يبدأ التكوين بتحديد برنامج للاسم hello_supervisor . كما أنه يعلم المسار الكامل للملف التنفيذي ليتم تشغيله.

autostart=true

يوضح هذا السطر أن هذا البرنامج يجب أن يبدأ تلقائيًا عند بدء تشغيل المشرف.

autorestart=true

إذا تم إنهاء البرنامج ، لأي سبب من الأسباب ، يبلغ هذا السطر المشرف بإعادة تشغيل العملية تلقائيًا.

stderr_logfile=/var/log/hello_supervisor.err.log
stdout_logfile=/var/log/hello_supervisor.out.log

تحدد هذه السطور موقع ملف التسجيل لـ stderrو stdout، على التوالي.

إدارة البرامج

الآن بعد أن قمنا بتثبيت وتكوين المشرف ، أصبحنا قادرين على إدارة عملياتنا.

بعد إضافة برنامج جديد ، يجب علينا تشغيل الأمرين التاليين ، لإبلاغ الخادم بإعادة قراءة ملفات التكوين وتطبيق أي تغييرات.

sudo supervisorctl reread
sudo supervisorctl update

الآن تنفيذ supervisorctlالعميل.

sudo supervisorctl

سيتم استقبالك بقائمة المندوبات المسجلة. سترى نعالج دعا hello_supervisorمع RUNNINGالوضع.

hello_supervisor                 RUNNING   pid 6853, uptime 0:22:30
supervisor>

اكتب helpللحصول على قائمة بالأوامر المتاحة.

supervisor> help

default commands (type help <topic>):
=====================================
add    exit      open  reload  restart   start   tail   
avail  fg        pid   remove  shutdown  status  update 
clear  maintail  quit  reread  signal    stop    version

باختصار، نستطيع start، stopو restartالبرامج التي يمر اسم البرنامج كحجة إلى الأمر منها.

supervisor> stop hello_supervisor 
hello_supervisor: stopped
supervisor> start hello_supervisor 
hello_supervisor: started
supervisor> restart hello_supervisor 
hello_supervisor: stopped
hello_supervisor: started
supervisor> 

يمكننا أيضًا إلقاء نظرة على إخراج البرنامج باستخدام tailالأمر.

supervisor> tail hello_supervisor 
Hello Supervisor: Mon Sep 25 19:27:29 UTC 2017
Hello Supervisor: Mon Sep 25 19:27:30 UTC 2017
Hello Supervisor: Mon Sep 25 19:27:31 UTC 2017

ل stderrالإخراج، يمكنك استخدام tailأيضا.

supervisor> tail hello_supervisor stderr
An error ocurred at Mon Sep 25 19:31:12 UTC 2017!
An error ocurred at Mon Sep 25 19:31:13 UTC 2017!
An error ocurred at Mon Sep 25 19:31:14 UTC 2017!

من خلال استدعاء statusالأمر ، يمكنك عرض حالة جميع البرامج المسجلة.

بمجرد الانتهاء ، يمكنك الإقلاع عن التدخين.

supervisor> quit

عميل خادم الويب

للسماح بالوصول إلى خادم الويب المشرف ، افتح ملف تكوين المشرف وحدد [inet_http_server]القسم.

nano /etc/supervisor/supervisord.conf

الآن قم بتحديث تكوين هذا القسم بما يلي.

[inet_http_server]
port=*:9001
username=your_username
password=your_password

استبدال your_usernameو your_passwordمع اعتمادك المطلوب، حفظ التعديلات وخدمة supervisord إعادة التشغيل.

sudo systemctl restart supervisord.service

تذكر أن تسمح TCPبالوصول إلى المنفذ 9001على جدار الحماية الخاص بك ومن ثم الوصول http://{server-ip}:9001من متصفحك. عندما يطلب منك username، قدم لك و password. يمكنك الآن التحكم في عملياتك من الويب.

استنتاج

لقد قمنا بتثبيت أحدث إصدار من المشرف ، وتعلمنا كيفية تكوينه لبدء التشغيل التلقائي للنظام مع systemd كما راجعنا الاستخدام الأساسي لـ supervisorctl. لمزيد من التكوين المتقدم وحالات الاستخدام ، يمكنك الرجوع إلى وثائق المشرف الرسمية .