This commit is contained in:
2026-10-20 11:49:12 +03:30
parent 3f72861b64
commit 10978d47a5
35 changed files with 683 additions and 644 deletions

View File

@@ -107,12 +107,23 @@ soundهای استاندارد Asterisk با soundهای آپلودی برنام
- همهٔ فرمان‌های متنی CLI باید از `PlineTools.executeAsteriskCliCommand()` (یا wrapperهای آن مانند `execCoreCommandStringResult()`) عبور کنند؛ مسیر fallback داخلی native از `/usr/sbin/asterisk -x` و Docker از `docker exec <container> /usr/sbin/asterisk -x` استفاده می‌کند.
- مسیر اصلی ابتدا از pool محدود AMI با `CommandAction` استفاده می‌کند. فقط اگر AMI پیش از ارسال فرمان در دسترس نباشد، اجرای محلی CLI مجاز است. اگر ارسال AMI شروع شده و پاسخ نامشخص/timeout باشد، فرمان دوباره از CLI اجرا نمی‌شود تا اجرای تکراری رخ ندهد.
- pool فرمان AMI چهار اتصال دارد؛ اجرای fallback محلی حداکثر دو پردازهٔ هم‌زمان می‌پذیرد و درخواست اضافی را بدون صف‌کردن رد می‌کند.
- pool فرمان AMI چهار اتصال دارد؛ اتصال‌های بیکار پس از ۳۰ ثانیه (قابل تنظیم با `pline.ami-command-idle-timeout-ms`) بسته می‌شوند و هر ۱۰ ثانیه بررسی می‌شوند. اجرای fallback محلی حداکثر دو پردازهٔ هم‌زمان می‌پذیرد و درخواست اضافی را بدون صف‌کردن رد می‌کند.
- اجرای `File_Generator.GenerateFiles()` همگام‌سازی شده تا تولید فایل‌ها و reloadهای ناشی از چند درخواست هم‌زمان روی هم نیفتند.
- API محلی `POST /local-asterisk/command` در `LocalAsteriskCommandController` فقط اتصال مستقیم loopback و token برابر با `pline.local-asterisk-api-token` را می‌پذیرد. هدرهای forwarding باعث رد درخواست می‌شوند؛ برنامه‌های محلی باید مستقیم به پورت 8080 وصل شوند.
- افزودن، حذف و pause/unpause اعضای صف در `QueueLiveInfoController` و افزودن اعضای داینامیک/پاک‌سازی آن‌ها در `QueueGenerator` از همان executor مرکزی CLI استفاده می‌کنند؛ برای این عملیات از `QueueAddAction`، `QueueRemoveAction` و `QueuePauseAction` مستقیم استفاده نشود.
- رفتار صف باید حفظ شود: اعضای داینامیک زمان ساخت با حالت unpaused اضافه می‌شوند؛ endpoint ورود (`/online/.../true`) عضو را در حالت paused ثبت می‌کند؛ حذف و pause/unpause باید همان queue و Local interface قبلی را هدف بگیرند.
- `ManagerGenerator` حساب اصلی `[pline]` را با `allowmultiplelogin = yes` می‌سازد تا اتصال رویدادها و pool فرمان هم‌زمان کار کنند؛ تنظیم AMI کاربران دیگر برنامه مستقل باقی می‌ماند.
### عیب‌یابی reload در Asterisk 22
- در لاگ Asterisk 22.11.0، `The previous reload command didn't finish yet` همراه با `loader.c` دیده شد و AMI رویداد `Reload` با `Module: All` و `Status: 4` برگرداند؛ در مستندات AMI نسخهٔ 22، status 4 یعنی reload از قبل در حال اجرا است. این پیام نشانهٔ اتصال بیکار AMI نیست.
- `reloadConfigurations()` باید فقط یک‌بار `module reload` بفرستد؛ این فرمان خودش Manager را هم reload می‌کند. برای reload مهلت طولانی‌تر از فرمان‌های CLI معمولی در نظر گرفته شود و timeout یا پاسخ «reload already in progress» باید به Apply به‌عنوان خطا برگردد، نه موفقیت.
- مسیر Apply باید نتیجهٔ reload را بررسی کند؛ اگر Asterisk پاسخ نداد یا گفت reload دیگری در حال اجرا است، `hasError` فعال بماند و logها/تأیید تغییرات فقط پس از Apply موفق ثبت شوند. مقدار ناموفق باید به‌صورت نتیجهٔ `false` برگردد، نه exception؛ در startup، timeout reload نباید بالا آمدن برنامه را متوقف کند.
- Backtrace زندهٔ Asterisk 22.11.0 در reload گیرکرده، thread مربوط به `res_pjsip_config_wizard.so` را داخل `ast_sorcery_reload` و `__ast_taskpool_push_wait` نشان داد؛ چند thread دریافت PJSIP نیز در `ast_sip_get_transport_states` منتظر mutex بودند. این الگو با deadlock شناخته‌شدهٔ reload در PJSIP Config Wizard هم‌خوان است؛ بازکردن اتصال idle AMI آن را رفع نمی‌کند. اجرای GDB از میزبان Docker به‌خاطر PID namespace ممکن است هشدار بدهد و نام بعضی frameها را نشان ندهد، ولی مسیرهای نماددار برای تشخیص کافی بودند.
- `SipFileGenerator` در CTI objectهای معمول `transport`, `aor`, `auth`, `endpoint`, `registration`, و `identify` می‌نویسد و `type = wizard` تولید نمی‌کند. برای دورزدن deadlock، `PlineSettingsGenerator` باید `res_pjsip_config_wizard.so` را در `modules.conf` با `noload` خارج کند. این workaround فقط پس از بازتولید `modules.conf` و restart کانتینر Asterisk اعمال می‌شود؛ بعد از بالا آمدن، `module show like res_pjsip_config_wizard` باید نشان دهد ماژول load نیست.
- در Asterisk 22 گزینهٔ `automon` در `[featuremap]` پشتیبانی نمی‌شود؛ پیش‌فرض `p-line/features.json` برای آن نسخه به `automixmon` تغییر کرده است. پس از انتشار این فایل، همگام‌سازی FeatureCodeGenerator مقدار پایه را در دیتابیس و `features.conf` به‌روز می‌کند. خطای `features.conf` باید رفع شود، اما از روی لاگ موجود نمی‌توان آن را علت گیرکردن کل reload دانست.
- اگر `/var/log/asterisk/full` وجود ندارد، `logger show channels` را بررسی کنید. در نمونهٔ بررسی‌شده فقط `messages.log` و Console فعال بودند؛ کانال موقت با `logger add channel /tmp/reload-debug.log notice,warning,error,debug,verbose` لاگ تشخیصی را فراهم کرد.
## ارتباط‌های دیگر Asterisk
- AMI رویدادها، AGI و Live API همچنان ارتباط‌های مخصوص خود را دارند و در Docker برای آن‌ها `docker exec` لازم نیست.