.\" vim:ft=nroff:
.\" This Source Code Form is subject to the terms of the Mozilla Public
.\" License, v. 2.0. If a copy of the MPL was not distributed with this
.\" file, You can obtain one at https://mozilla.org/MPL/2.0/.
.\"
.\" Copyright (c) 2007-2026 Broadcom. All Rights Reserved. The term “Broadcom” refers to Broadcom Inc. and/or its subsidiaries.  All rights reserved.
.\"
.Dd June 22, 2023
.Dt RABBITMQ-QUEUES 8
.Os "RabbitMQ Server"
.Sh "نام (NAME)"
rabbitmq-queues \- ابزارهای مدیریت صف‌های RabbitMQ
.\" ------------------------------------------------------------------
.Sh "خلاصه دستور (SYNOPSIS)"
.\" ------------------------------------------------------------------
.Nm rabbitmq-queues
.Op Fl q
.Op Fl s
.Op Fl l
.Op Fl n Ar node
.Op Fl t Ar timeout
.Ar command
.Op Ar command_options
.\" ------------------------------------------------------------------
.Sh "توضیحات (DESCRIPTION)"
.\" ------------------------------------------------------------------
.Nm rabbitmq-queues
یک ابزار خط فرمان است که دستوراتی را برای مدیریت صف‌ها فراهم می‌کند،
برای مثال افزایش، کاهش یا تعادل مجدد رونوشت‌های انواع صف‌های تکثیرشده.
برای اطلاعات بیشتر، به
.Lk https://www.rabbitmq.com/docs/quorum-queues "راهنمای صف‌های حد نصاب (quorum) در RabbitMQ"
و راهنمای عمومی
.Lk https://www.rabbitmq.com/docs/queues "راهنمای صف‌های RabbitMQ"
جهت کسب اطلاعات بیشتر درباره انواع صف‌ها در RabbitMQ مراجعه کنید.
.
.\" ------------------------------------------------------------------
.Sh "گزینه‌ها (OPTIONS)"
.\" ------------------------------------------------------------------
.Bl -tag -width Ds
.It Fl n Ar node
گره پیش‌فرض
.Qq Pf rabbit@ Ar target-hostname
است، که در آن
.Ar target-hostname
میزبان محلی است.
در میزبانی با نام
.Qq myserver.example.com
نام گره معمولاً
.Qq rabbit@myserver
خواهد بود (مگر اینکه
.Ev RABBITMQ_NODENAME
بازنویسی شده باشد).
خروجی
.Qq hostname -s
معمولاً پسوند صحیح برای استفاده پس از علامت
.Qq @
است.
برای جزئیات پیکربندی یک گره RabbitMQ، به
.Xr rabbitmq-server 8
مراجعه کنید.
.It Fl q , -quiet
حالت خروجی ساکت (بی‌صدا) انتخاب می‌شود.
هنگامی که حالت ساکت فعال است، پیام‌های اطلاع‌رسانی کاهش می‌یابند.
.It Fl s , -silent
حالت خروجی کاملاً خاموش انتخاب می‌شود.
هنگامی که حالت خاموش فعال است، پیام‌های اطلاع‌رسانی کاهش یافته و سرصفحه جدول‌ها نمایش داده نمی‌شوند.
.It Fl t Ar timeout , Fl -timeout Ar timeout
زمان مهلت مجاز عملیات بر حسب ثانیه.
همه دستورات از مهلت زمانی پشتیبانی نمی‌کنند.
مقدار پیش‌فرض
.Cm infinity
است.
.It Fl l , Fl -longnames
هنگامی که خوشه برای استفاده از نام‌های گره طولانی (FQDN) پیکربندی شده است، باید مشخص شود.
برای کسب اطلاعات بیشتر، به
.Lk https://www.rabbitmq.com/docs/clustering "راهنمای خوشه‌بندی RabbitMQ"
مراجعه کنید.
.It Fl -erlang-cookie Ar cookie
راز مشترک (کوکی) مورد استفاده برای احراز هویت در گره مقصد.
ترجیحاً به جای تعیین این گزینه در خط فرمان، از یک فایل محلی یا متغیر محیطی
.Ev RABBITMQ_ERLANG_COOKIE
استفاده کنید.
برای کسب اطلاعات بیشتر، به
.Lk https://www.rabbitmq.com/docs/cli "راهنمای ابزارهای خط فرمان RabbitMQ"
مراجعه کنید.
.El
.\" ------------------------------------------------------------------
.Sh "دستورات (COMMANDS)"
.\" ------------------------------------
.Bl -tag -width Ds
.\" ------------------------------------
.It Cm help
.Pp
راهنمای عمومی و دستورات پشتیبانی‌شده توسط
.Nm rabbitmq-queues
را نمایش می‌دهد.
.El
.Ss "خوشه (Cluster)"
.Bl -tag -width Ds
.\" ------------------------------------
.It Cm grow Ar node Ar selector Fl -vhost-pattern Ar pattern Fl -queue-pattern Ar pattern Fl -errors-only
.Pp
یک رونوشت جدید در گره داده‌شده برای تمام یا نیمی از صف‌های منطبق اضافه می‌کند.
.Pp
مقادیر پشتیبانی‌شده برای
.Ar selector
عبارتند از:
.Bl -tag -width Ds
.It Dv Sy all
تمام صف‌های تکثیرشده را انتخاب می‌کند
.It Dv Sy even
صف‌های تکثیرشده با تعداد زوج از رونوشت‌ها را انتخاب می‌کند
.El
.Pp
مثال:
.Sp
.Dl rabbitmq-queues grow Qo rabbit@newhost Qc Qo all Qc --vhost-pattern Qo a-vhost Qc --queue-pattern Qo .* Qc
.\" ------------------------------------
.It Cm rebalance Ar type Fl -vhost-pattern Ar pattern Fl -queue-pattern Ar pattern
.Pp
رونوشت‌های رهبر صف را در میان گره‌های خوشه متعادل‌سازی مجدد می‌کند.
.Pp
مقادیر پشتیبانی‌شده برای
.Ar type
عبارتند از:
.Bl -tag -width Ds
.It Dv Sy all
همه انواع صف
.It Dv Sy quorum
فقط صف‌های حد نصاب (quorum)
.It Dv Sy classic
فقط صف‌های کلاسیک (classic)
.It Dv Sy stream
فقط جریان‌ها (streams)
.El
.Pp
مثال:
.Sp
.Dl rabbitmq-queues rebalance Qo all Qc --vhost-pattern Qo a-vhost Qc --queue-pattern Qo .* Qc
.\" ------------------------------------
.It Cm shrink Ar node
.Pp
خوشه‌های صف را با حذف تمام اعضا (رونوشت‌ها) در گره داده‌شده کاهش می‌دهد.
.Pp
مثال:
.Sp
.Dl rabbitmq-queues shrink Qo rabbit@decomissioned-node Qc
.\" ------------------------------------
.El
.Ss "تکثیر (Replication)"
.Bl -tag -width Ds
.\" ------------------------------------
.It Cm add_member Ar queue Ar node Fl -vhost Ar virtual-host
.Pp
یک عضو صف (رونوشت) در گره داده‌شده اضافه می‌کند.
.Pp
مثال:
.Sp
.Dl rabbitmq-queues add_member --vhost Qo a-vhost Qc Qo a-queue Qc Qo rabbit@new-node Qc
.\" ------------------------------------
.It Cm delete_member Ar queue Ar node Fl -vhost Ar virtual-host
.Pp
یک عضو صف (رونوشت) در گره داده‌شده را حذف می‌کند.
.Pp
مثال:
.Sp
.Dl rabbitmq-queues delete_member --vhost Qo a-vhost Qc Qo a-queue Qc Qo rabbit@decomissioned-node Qc
.\" ------------------------------------
.El
.Ss "صف‌ها (Queues)"
.Bl -tag -width Ds
.\" ------------------------------------
.It Cm quorum_status Ar queue Fl -vhost Ar virtual-host
.Pp
وضعیت حد نصاب (quorum) یک صف را نمایش می‌دهد.
.Pp
مثال:
.Sp
.Dl rabbitmq-queues quorum_status --vhost Qo a-vhost Qc Qo a-queue Qc
.It Cm peek Ar queue Ar position Fl -vhost Ar virtual-host Fl -timeout
.Pp
جزئیات یک پیام در موقعیت مشخص‌شده در صف را نمایش می‌دهد.
این دستور در حال حاضر فقط توسط صف‌های حد نصاب (quorum) پشتیبانی می‌شود.
.Pp
مثال:
.Sp
.Dl rabbitmq-queues peek --vhost Qo a-vhost Qc Qo a-queue Qc Qo 1 Qc
.It Cm check_if_cluster_has_classic_queue_mirroring_policy
.Pp
بررسی سلامتی که اگر خط‌مشی‌هایی در خوشه وجود داشته باشند که آینه‌سازی صف‌های کلاسیک (classic queue mirroring) را فعال کنند، با یک کد غیر صفر خارج می‌شود.
آینه‌سازی صف‌های کلاسیک از سال ۲۰۲۱ منسوخ شده است و در چرخه توسعه RabbitMQ 4.0 به‌طور کامل حذف شد.
.Pp
مثال:
.Sp
.Dl rabbitmq-queues check_if_cluster_has_classic_queue_mirroring_policy
.It Cm check_if_node_is_quorum_critical
.Pp
بررسی سلامتی که اگر صف‌هایی با حداقل حد نصاب آنلاین وجود داشته باشند (صف‌هایی که در صورت خاموش شدن گره هدف، حد نصاب خود را از دست می‌دهند)، با یک کد غیر صفر خارج می‌شود.
.Pp
مثال:
.Sp
.Dl rabbitmq-queues check_if_node_is_quorum_critical
.El
.\" ------------------------------------------------------------------
.Sh "همچنین ببینید (SEE ALSO)"
.\" ------------------------------------------------------------------
.Xr rabbitmqctl 8 ,
.Xr rabbitmq-diagnostics 8 ,
.Xr rabbitmq-server 8 ,
.Xr rabbitmq-streams 8 ,
.Xr rabbitmq-upgrade 8 ,
.Xr rabbitmq-service 8 ,
.Xr rabbitmq-env.conf 5
.\" ------------------------------------------------------------------
.Sh "نویسنده (AUTHOR)"
.\" ------------------------------------------------------------------
.An The RabbitMQ Team Aq Mt contact-tanzu-data.pdl@broadcom.com