استفاده از Supervisord برای مدیریت سرویس – دیپلوی و DevOps با پایتون

در دنیای توسعه و استقرار برنامه‌های پایتون، مدیریت سرویس‌ها و اطمینان از اجرای مداوم آن‌ها یکی از چالش‌های مهم است. وقتی برنامه‌های پایتون به صورت سرویس در یک سرور اجرا می‌شوند، نیاز به یک سیستم مدیریت فرآیند (Process Management System) داریم که بتواند به طور خودکار سرویس‌ها را راه‌اندازی، نظارت و در صورت بروز خطا، آن‌ها را مجدداً راه‌اندازی کند. Supervisord یکی از محبوب‌ترین و قدرتمندترین ابزارها برای این منظور است. این مقاله به بررسی جامع Supervisord، نحوه نصب، پیکربندی و استفاده از آن برای مدیریت سرویس‌های پایتون می‌پردازد.

Supervisord چیست؟

Supervisord یک سیستم مدیریت فرآیند کلاینت/سرور است که به شما امکان می‌دهد فرآیندهای مختلف را به عنوان سرویس مدیریت کنید. این ابزار به طور خاص برای مدیریت برنامه‌هایی که به صورت طولانی‌مدت اجرا می‌شوند (مانند وب‌سرورها، صف‌های پیام، و غیره) طراحی شده است. Supervisord می‌تواند فرآیندها را به طور خودکار راه‌اندازی کند، آن‌ها را نظارت کند و در صورت خرابی، آن‌ها را مجدداً راه‌اندازی کند. همچنین، Supervisord امکانات مختلفی برای مدیریت و نظارت بر سرویس‌ها از طریق رابط کاربری وب، خط فرمان و API ارائه می‌دهد.

نصب Supervisord

نصب Supervisord بسیار ساده است و بسته به سیستم‌عامل شما متفاوت خواهد بود. در اینجا روش نصب Supervisord در سیستم‌عامل‌های رایج آورده شده است:

• Debian/Ubuntu: sudo apt update && sudo apt install supervisor
• CentOS/RHEL: sudo yum install supervisor
• macOS (با استفاده از Homebrew): brew install supervisor
• Python (با استفاده از pip): pip install supervisor (این روش برای محیط‌های مجازی پایتون توصیه می‌شود)

پیکربندی Supervisord

فایل پیکربندی اصلی Supervisord معمولاً در مسیر /etc/supervisor/supervisord.conf قرار دارد. این فایل شامل تنظیمات کلی Supervisord و همچنین تعریف سرویس‌ها است. برای تعریف یک سرویس جدید، باید یک فایل پیکربندی جداگانه برای آن ایجاد کنید. این فایل‌ها معمولاً در دایرکتوری /etc/supervisor/conf.d/ قرار می‌گیرند.

ساختار یک فایل پیکربندی سرویس به صورت زیر است:

[program:my_python_app]
command=/usr/bin/python /path/to/your/app.py
directory=/path/to/your/app/directory
user=your_user
autostart=true
autorestart=true
stderr_logfile=/var/log/my_python_app.err.log
stdout_logfile=/var/log/my_python_app.out.log

توضیح پارامترها:

• program: نام برنامه (سرویس).
• command: دستوری که برای اجرای برنامه استفاده می‌شود.
• directory: دایرکتوری که برنامه در آن قرار دارد.
• user: کاربری که برنامه با آن اجرا می‌شود.
• autostart: مشخص می‌کند که آیا برنامه باید به طور خودکار پس از راه‌اندازی Supervisord شروع شود یا خیر.
• autorestart: مشخص می‌کند که آیا برنامه باید در صورت خرابی به طور خودکار مجدداً راه‌اندازی شود یا خیر.
• stderr_logfile: مسیر فایل لاگ برای خطاهای برنامه.
• stdout_logfile: مسیر فایل لاگ برای خروجی برنامه.

نکته: مسیرهای فایل‌ها و نام کاربری را با توجه به تنظیمات سیستم خود تغییر دهید.

مدیریت سرویس‌ها با Supervisord

پس از پیکربندی سرویس‌ها، می‌توانید آن‌ها را با استفاده از دستورات Supervisord مدیریت کنید. در اینجا برخی از دستورات رایج آورده شده است:

• راه‌اندازی Supervisord: sudo supervisorctl start all
• توقف Supervisord: sudo supervisorctl stop all
• راه‌اندازی یک سرویس خاص: sudo supervisorctl start my_python_app
• توقف یک سرویس خاص: sudo supervisorctl stop my_python_app
• وضعیت یک سرویس خاص: sudo supervisorctl status my_python_app
• بازخوانی فایل‌های پیکربندی: sudo supervisorctl reread
• اعمال تغییرات پیکربندی: sudo supervisorctl update

رابط کاربری وب Supervisord

Supervisord یک رابط کاربری وب ساده نیز ارائه می‌دهد که به شما امکان می‌دهد سرویس‌ها را به صورت گرافیکی مدیریت کنید. برای فعال کردن رابط کاربری وب، باید تنظیمات مربوطه را در فایل supervisord.conf انجام دهید. به طور معمول، رابط کاربری وب بر روی پورت 9000 در دسترس است. برای دسترسی به رابط کاربری وب، آدرس http://your_server_ip:9000 را در مرورگر خود وارد کنید.

نظارت بر سرویس‌ها با Supervisord

Supervisord به طور مداوم سرویس‌ها را نظارت می‌کند و در صورت بروز خطا، آن‌ها را مجدداً راه‌اندازی می‌کند. همچنین، می‌توانید از فایل‌های لاگ برای بررسی وضعیت سرویس‌ها و شناسایی مشکلات استفاده کنید. فایل‌های لاگ به طور خودکار توسط Supervisord ایجاد می‌شوند و شامل اطلاعات مفیدی در مورد عملکرد سرویس‌ها هستند.

استفاده از Supervisord در محیط‌های مجازی پایتون

هنگام استفاده از Supervisord در محیط‌های مجازی پایتون، مهم است که مسیرهای فایل‌ها و دستورات را به درستی تنظیم کنید. به عنوان مثال، اگر برنامه پایتون شما در یک محیط مجازی با نام venv قرار دارد، باید دستور command را به صورت زیر تنظیم کنید:

command=/path/to/venv/bin/python /path/to/your/app.py

همچنین، مطمئن شوید که کاربر مورد استفاده برای اجرای برنامه دسترسی لازم به فایل‌ها و دایرکتوری‌های محیط مجازی را دارد.

سناریوهای پیشرفته

Supervisord امکانات پیشرفته‌تری نیز ارائه می‌دهد که می‌توانید از آن‌ها برای مدیریت سرویس‌های پیچیده‌تر استفاده کنید. برخی از این امکانات عبارتند از:

• گروه‌بندی سرویس‌ها: می‌توانید سرویس‌ها را در گروه‌های مختلف سازماندهی کنید و سپس عملیات را بر روی کل گروه اعمال کنید.
• تنظیم محدودیت‌های منابع: می‌توانید محدودیت‌هایی برای استفاده از CPU و حافظه برای هر سرویس تنظیم کنید.
• استفاده از Event Listeners: می‌توانید از Event Listeners برای اجرای اسکریپت‌های سفارشی در هنگام وقوع رویدادهای خاص (مانند راه‌اندازی، توقف، یا خرابی سرویس) استفاده کنید.
• یکپارچه‌سازی با سیستم‌های مانیتورینگ: می‌توانید Supervisord را با سیستم‌های مانیتورینگ مانند Nagios یا Zabbix یکپارچه کنید تا نظارت دقیق‌تری بر سرویس‌ها داشته باشید.

نتیجه‌گیری

Supervisord یک ابزار قدرتمند و انعطاف‌پذیر برای مدیریت سرویس‌های پایتون است. با استفاده از Supervisord، می‌توانید اطمینان حاصل کنید که برنامه‌های پایتون شما به طور مداوم و قابل اعتماد اجرا می‌شوند. این ابزار به ویژه برای استقرار برنامه‌های پایتون در محیط‌های تولید بسیار مفید است. با یادگیری نحوه نصب، پیکربندی و استفاده از Supervisord، می‌توانید فرآیند دیپلوی و DevOps برنامه‌های پایتون خود را به طور قابل توجهی بهبود بخشید.