نام (NAME)

rabbitmq-queues - ابزارهای مدیریت صف‌های RabbitMQ

خلاصه دستور (SYNOPSIS)

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

توضیحات (DESCRIPTION)

rabbitmq-queues یک ابزار خط فرمان است که دستوراتی را برای مدیریت صف‌ها فراهم می‌کند، برای مثال افزایش، کاهش یا تعادل مجدد رونوشت‌های انواع صف‌های تکثیرشده. برای اطلاعات بیشتر، به راهنمای صف‌های حد نصاب (quorum) در RabbitMQ و راهنمای عمومی راهنمای صف‌های RabbitMQ جهت کسب اطلاعات بیشتر درباره انواع صف‌ها در RabbitMQ مراجعه کنید.

گزینه‌ها (OPTIONS)

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

دستورات (COMMANDS)

help: راهنمای عمومی و دستورات پشتیبانی‌شده توسط rabbitmq-queues را نمایش می‌دهد.

خوشه (Cluster)

grow node selector --vhost-pattern pattern --queue-pattern pattern --errors-only

یک رونوشت جدید در گره داده‌شده برای تمام یا نیمی از صف‌های منطبق اضافه می‌کند.

مقادیر پشتیبانی‌شده برای selector عبارتند از:

all: تمام صف‌های تکثیرشده را انتخاب می‌کند
even: صف‌های تکثیرشده با تعداد زوج از رونوشت‌ها را انتخاب می‌کند

مثال:

rabbitmq-queues grow
      "rabbit@newhost" "all" --vhost-pattern
      "a-vhost" --queue-pattern ".*"

rebalance type --vhost-pattern pattern --queue-pattern pattern

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

مقادیر پشتیبانی‌شده برای type عبارتند از:

all: همه انواع صف
quorum: فقط صف‌های حد نصاب (quorum)
classic: فقط صف‌های کلاسیک (classic)
stream: فقط جریان‌ها (streams)

مثال:

rabbitmq-queues rebalance
      "all" --vhost-pattern "a-vhost" --queue-pattern
      ".*"

shrink node

خوشه‌های صف را با حذف تمام اعضا (رونوشت‌ها) در گره داده‌شده کاهش می‌دهد.

مثال:

rabbitmq-queues shrink
      "rabbit@decomissioned-node"

تکثیر (Replication)

add_member queue node --vhost virtual-host

یک عضو صف (رونوشت) در گره داده‌شده اضافه می‌کند.

مثال:

rabbitmq-queues add_member
      --vhost "a-vhost" "a-queue"
      "rabbit@new-node"

delete_member queue node --vhost virtual-host

یک عضو صف (رونوشت) در گره داده‌شده را حذف می‌کند.

مثال:

rabbitmq-queues delete_member
      --vhost "a-vhost" "a-queue"
      "rabbit@decomissioned-node"

صف‌ها (Queues)

quorum_status queue --vhost virtual-host

وضعیت حد نصاب (quorum) یک صف را نمایش می‌دهد.

مثال:

rabbitmq-queues quorum_status
      --vhost "a-vhost" "a-queue"

peek queue position --vhost virtual-host --timeout

جزئیات یک پیام در موقعیت مشخص‌شده در صف را نمایش می‌دهد. این دستور در حال حاضر فقط توسط صف‌های حد نصاب (quorum) پشتیبانی می‌شود.

مثال:

rabbitmq-queues peek --vhost
      "a-vhost" "a-queue" "1"

check_if_cluster_has_classic_queue_mirroring_policy

بررسی سلامتی که اگر خط‌مشی‌هایی در خوشه وجود داشته باشند که آینه‌سازی صف‌های کلاسیک (classic queue mirroring) را فعال کنند، با یک کد غیر صفر خارج می‌شود. آینه‌سازی صف‌های کلاسیک از سال ۲۰۲۱ منسوخ شده است و در چرخه توسعه RabbitMQ 4.0 به‌طور کامل حذف شد.

مثال:

rabbitmq-queues
      check_if_cluster_has_classic_queue_mirroring_policy

check_if_node_is_quorum_critical

بررسی سلامتی که اگر صف‌هایی با حداقل حد نصاب آنلاین وجود داشته باشند (صف‌هایی که در صورت خاموش شدن گره هدف، حد نصاب خود را از دست می‌دهند)، با یک کد غیر صفر خارج می‌شود.

مثال:

rabbitmq-queues
      check_if_node_is_quorum_critical

همچنین ببینید (SEE ALSO)

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

نویسنده (AUTHOR)

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