RABBITMQ-PLUGINS(8) System Manager's Manual RABBITMQ-PLUGINS(8)
" vim:ft=nroff:

rabbitmq-plugins — ابزار خط فرمان برای مدیریت پلاگین‌های RabbitMQ

rabbitmq-plugins [-q] [-s] [-l] [-n node] [-t timeout] command [command_options]

rabbitmq-plugins ابزاری در خط فرمان برای مدیریت پلاگین‌های RabbitMQ است. برای مروری بر پلاگین‌های RabbitMQ و نحوه استفاده از آن‌ها به راهنمای پلاگین‌های RabbitMQ مراجعه فرمایید.

rabbitmq-plugins به مدیر سیستم امکان می‌دهد پلاگین‌ها را فعال، غیرفعال و بازبینی کند. این ابزار باید توسط کاربری با دسترسی نوشتن در دایرکتوری پیکربندی RabbitMQ اجرا شود.

پلاگین‌ها می‌توانند به پلاگین‌های دیگر وابسته باشند. rabbitmq-plugins وابستگی‌ها را شناسایی و حل کرده و تمام وابستگی‌ها را فعال یا غیرفعال می‌سازد تا کاربر نیازی به مدیریت صریح آن‌ها نداشته باشد. پلاگین‌های ذکرشده در خط فرمان rabbitmq-plugins به عنوان صریحاً فعال‌شده علامت‌گذاری می‌شوند؛ پلاگین‌های وابسته به عنوان ضمنی فعال‌شده مشخص می‌گردند. پلاگین‌های ضمنی فعال‌شده هنگامی که دیگر نیازی به آن‌ها نباشد، مجدداً به‌طور خودکار غیرفعال می‌شوند.

دستورات enable, disable و set فایل پلاگین‌ها را به‌روزرسانی کرده و سپس تلاش می‌کنند به کارگزار (broker) متصل شوند تا اطمینان حاصل نمایند که تمام پلاگین‌های فعال در حال اجرا هستند. به‌طور پیش‌فرض، اگر امکان اتصال و احراز هویت با گره مقصد وجود نداشته باشد (برای نمونه اگر گره متوقف باشد)، عملیات شکست خواهد خورد. اگر rabbitmq-plugins روی همان میزبانی استفاده شود که گره مقصد روی آن قرار دارد، می‌توان گزینه --offline را مشخص کرد تا rabbitmq-plugins وضعیت پلاگین‌ها را مستقیماً (بدون تماس با گره) حل و به‌روزرسانی کند. چنین تغییراتی تنها در راه‌اندازی بعدی گره اعمال خواهند شد. برای اطلاعات بیشتر، به راهنمای پلاگین‌های RabbitMQ مراجعه نمایید.

node
گره پیش‌فرض "rabbit@target-hostname" است، که در آن target-hostname میزبان محلی است. روی میزبانی با نام "myserver.example.com", نام گره معمولاً "rabbit@myserver" خواهد بود (مگر اینکه متغیر محیطی RABBITMQ_NODENAME بازنویسی شده باشد). خروجی دستور "hostname -s" معمولاً پسوند صحیحی برای استفاده پس از علامت "@" می‌باشد. برای جزئیات پیکربندی گره RabbitMQ به rabbitmq-server(8) مراجعه کنید.
, --quiet
انتخاب حالت خروجی آرام (quiet). در این حالت پیام‌های اطلاعاتی کاهش می‌یابند.
, --silent
انتخاب حالت خروجی بی‌صدا (silent). در این حالت پیام‌های اطلاعاتی کاهش یافته و هدرهای جدول‌ها حذف می‌شوند.
timeout, --timeout timeout
مهلت زمانی عملیات بر حسب ثانیه. تمام دستورات از مهلت زمانی پشتیبانی نمی‌کنند. پیش‌فرض infinity است.
, --longnames
هنگامی که کلاستر برای استفاده از نام‌های کامل گره (FQDN) پیکربندی شده باشد، باید مشخص شود. برای کسب اطلاعات بیشتر، به راهنمای کلاسترینگ RabbitMQ مراجعه کنید.
رمز مشترک (Shared secret) مورد استفاده برای احراز هویت در گره مقصد. ترجیحاً به جای تعیین این گزینه در خط فرمان، از یک فایل محلی یا متغیر محیطی RABBITMQ_ERLANG_COOKIE استفاده نمایید. برای اطلاعات بیشتر به راهنمای ابزارهای CLI در RabbitMQ مراجعه فرمایید.

[-Eemv] [pattern]
نمایش تنها پلاگین‌های صریحاً فعال‌شده.
نمایش تنها پلاگین‌های صریحاً یا ضمناً فعال‌شده.
نمایش تنها نام پلاگین‌ها (حالت مختصر).
نمایش تمام جزئیات پلاگین‌ها (حالت باجزئیات).
pattern
الگویی برای پالایش نام پلاگین‌ها.

فهرست کردن تمام پلاگین‌ها، نسخه‌ها، وابستگی‌ها و توضیحات آن‌ها. هر پلاگین با دو نویسه نشانگر وضعیت درون [ ] پیشوندگذاری می‌شود. نشانگر اول می‌تواند شامل این موارد باشد:

نشان‌دهنده آنکه پلاگین فعال نیست
نشان‌دهنده آنکه پلاگین صریحاً فعال شده است
نشان‌دهنده آنکه پلاگین ضمناً فعال شده است
نشان‌دهنده آنکه پلاگین فعال است اما مفقود بوده و بنابراین قابل استفاده نیست

نشانگر دوم می‌تواند شامل این موارد باشد:

نشان می‌دهد پلاگین در حال اجرا نیست
نشان می‌دهد پلاگین در حال اجرا است

اگر الگوی اختیاری داده شود، تنها پلاگین‌هایی که نام آن‌ها با pattern مطابقت دارد نمایش داده می‌شوند.

برای نمونه، این دستور تمام پلاگین‌ها را هر کدام در یک خط فهرست می‌کند:

rabbitmq-plugins list

این دستور تمام پلاگین‌ها را فهرست می‌کند:

rabbitmq-plugins list -v

این دستور تمام پلاگین‌هایی را که نام آن‌ها حاوی "management" است فهرست می‌نماید:

rabbitmq-plugins list -v management

این دستور تمام پلاگین‌های فعال‌شده RabbitMQ را فهرست می‌کند:

rabbitmq-plugins list -e rabbit
[--offline] [--online] plugin ...
تغییر مستقیم وضعیت پلاگین‌های فعال گره بدون برقراری تماس با گره.
تلقی عدم موفقیت در اتصال به کارگزار در حال اجرا به عنوان خطای مهلک.
plugin
یک یا چند پلاگین برای فعال‌سازی که با فاصله جدا شده‌اند.

فعال‌سازی پلاگین‌های مشخص‌شده و تمام وابستگی‌های آن‌ها.

برای نمونه، این دستور پلاگین‌های "shovel" و "management" و تمام وابستگی‌های آن‌ها را فعال می‌سازد:

rabbitmq-plugins enable rabbitmq_shovel rabbitmq_management
[--offline] [--online] plugin ...
تغییر مستقیم وضعیت پلاگین‌های فعال گره بدون برقراری تماس با گره.
تلقی عدم موفقیت در اتصال به کارگزار در حال اجرا به عنوان خطای مهلک.
plugin
یک یا چند پلاگین برای غیرفعال‌سازی که با فاصله جدا شده‌اند.

غیرفعال کردن پلاگین‌های مشخص‌شده و تمام وابستگی‌های آن‌ها.

برای نمونه، این دستور "rabbitmq_management" و تمام پلاگین‌های وابسته به آن را غیرفعال می‌کند:

rabbitmq-plugins disable rabbitmq_management
[--offline] [--online] [plugin ...]
تغییر مستقیم وضعیت پلاگین‌های فعال گره بدون تماس با گره.
تلقی عدم موفقیت در اتصال به کارگزار در حال اجرا به عنوان خطای مهلک.
plugin
صفر یا چند پلاگین برای فعال‌سازی که با فاصله جدا شده‌اند.

فعال‌سازی پلاگین‌های مشخص‌شده و تمام وابستگی‌های آن‌ها. برخلاف enable, این دستور هرگونه پلاگین فعال موجود را نادیده گرفته و بازنویسی می‌کند. دستور set بدون هیچ آرگومان پلاگینی، دستوری معتبر به معنای "غیرفعال‌سازی تمام پلاگین‌ها" است.

برای نمونه، این دستور پلاگین "management" و وابستگی‌های آن را فعال کرده و مابقی را غیرفعال می‌سازد:

rabbitmq-plugins set rabbitmq_management

rabbitmqctl(8), rabbitmq-diagnostics(8), rabbitmq-server(8), rabbitmq-queues(8), rabbitmq-streams(8), rabbitmq-upgrade(8), rabbitmq-service(8), rabbitmq-env.conf(5)

The RabbitMQ Team <contact-tanzu-data.pdl@broadcom.com>

June 22, 2023 RabbitMQ Server