نام (NAME)

glab-cluster-graph - پرس‌وجوی گراف اشیای کوبرنتیز با استفاده از GitLab Agent برای کوبرنتیز (آزمایشی)

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

glab cluster graph [flags]

توضیحات (DESCRIPTION)

این دستور یک سرور وب را راه‌اندازی می‌کند که نمایی زنده از گراف اشیای کوبرنتیز را در مرورگر نمایش می‌دهد. این ابزار از GitLab Agent for Kubernetes که در کلاستر در حال اجراست استفاده می‌کند. نیازمندی‌ها:

نسخهٔ ۱۸.۱ یا بالاتر از GitLab و GitLab Agent.
حداقل نقش توسعه‌دهنده (Developer) در پروژهٔ ایجنت.
این دستور برای احراز هویت به یک توکن دسترسی شخصی (personal access token) یا توکن دسترسی پروژه (project access token) نیاز دارد. توکن باید دارای محدوده‌های دسترسی read_api و k8s_proxy باشد.

بازخورد خود را در ایشوی ۷۹۰۰ ثبت کنید: ⟨https://gitlab.com/gitlab-org/cli/-/issues/7900⟩.

فیلتر کردن منابع (Resource filtering)

برای فیلتر کردن منابع، فضاهای نام و انتخاب اشیای ریشه، از Common Expression Language (CEL) ⟨https://cel.dev⟩ استفاده کنید.

object_selector_expression: اشیاء را فیلتر می‌کند. عبارت باید یک مقدار بولی (boolean) برگرداند. این متغیرها در دسترس هستند:

obj: شیء کوبرنتیز در حال ارزیابی.
group: گروه شیء.
version: نسخهٔ شیء.
resource: نام منبع شیء، مانند pods برای نوع Pod.
namespace: فضای نام شیء.
name: نام شیء.
labels: برچسب‌های شیء.
annotations: یادداشت‌های (annotations) شیء.

resource_selector_expression: اطلاعات اکتشاف کوبرنتیز را برای گنجاندن یا مستثنی کردن منابع از درخواست نظارت (watch) فیلتر می‌کند. عبارت باید یک مقدار بولی برگرداند. این متغیرها در دسترس هستند:

group: گروه شیء.
version: نسخهٔ شیء.
resource: نام منبع شیء، مانند pods برای نوع Pod.
namespaced: محدودهٔ گروه، نسخه و منبع. می‌تواند bool، true یا false باشد.

برای انتخاب اشیای ریشه، از گزینهٔ --root-expression استفاده کنید. با تنظیم این گزینه، فقط اشیایی نمایش داده می‌شوند که به‌طور مستقیم یا متعدی (transitive) از اشیای ریشه قابل دسترس باشند. این گزینه از همان متغیرهای object_selector_expression استفاده می‌کند و باید یک مقدار بولی برگرداند. مقادیر متعدد با عبارت‌های OR ترکیب می‌شوند؛ اگر هر یک تطابق داشته باشد، شیء به‌عنوان ریشه استفاده می‌شود.

برای اطلاعات بیشتر دربارهٔ استفاده از برگزیننده‌های برچسب ⟨https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors⟩ و برگزیننده‌های فیلد ⟨https://kubernetes.io/docs/concepts/overview/working-with-objects/field-selectors⟩ جهت انتخاب فضاهای نام، مستندات کوبرنتیز را ببینید.

کاربرد پیشرفته (Advanced usage)

علاوه بر روش‌های سطح بالا برای ایجاد پرس‌وجو، این دستور شما را قادر می‌سازد با استفاده از تمامی ویژگی‌های API زیربنایی، پرس‌وجو را بسازید و ارسال کنید. برای درک آنچه امکان‌پذیر است و نحوهٔ انجام آن، سند طراحی فنی را ببینید: ⟨https://gitlab.com/gitlab-org/cluster-integration/gitlab-agent/-/blob/master/doc/graph_api.md⟩

کاربر باید مجوز دسترسی به پروژهٔ ایجنت را داشته باشد. برای اطلاعات بیشتر، بخش اعطای دسترسی کوبرنتیز به کاربران را ببینید: ⟨https://docs.gitlab.com/user/clusters/agent/user_access⟩.

این قابلیت آزمایشی است و برای استفاده در محیط عملیاتی آماده نیست. ممکن است ناپایدار باشد یا در هر زمانی حذف شود. برای اطلاعات بیشتر پیوند زیر را ببینید: https://docs.gitlab.com/policy/development_stages_support

گزینه‌ها (OPTIONS)

-a, --agent=0 شناسهٔ عددی ایجنت برای اتصال به آن.

--apps[=false] نظارت بر deployments، replicasets، daemonsets و statefulsets در گروه apps/v1.

--batch[=false] نظارت بر jobs و cronjobs در گروه batch/v1.

--cluster-rbac[=false] نظارت بر clusterroles و clusterrolebindings در گروه rbac.authorization.k8s.io/v1.

--core[=false] نظارت بر pods، secrets، configmaps و serviceaccounts در گروه core/v1.

--crd[=false] نظارت بر customresourcedefinitions در گروه apiextensions.k8s.io/v1.

--ignore-arc-direction[=false] نادیده گرفتن جهت یال‌ها (arc direction) هنگام ارزیابی اتصال به ریشه. به نسخهٔ ۱۸.۳ یا بالاتر GitLab و ایجنت نیاز دارد.

--listen-addr="localhost:0" نشانی برای گوش دادن.

--listen-net="tcp" شبکه‌ای که باید روی آن به اتصالات ورودی گوش داده شود.

--log-watch-request[=false] ثبت گزارش درخواست نظارت در خروجی استاندارد (stdout). برای اشکال‌زدایی مفید است.

-n, --namespace=[] فضاهای نام برای نظارت. در صورت عدم تعیین، تمام فضاهای نام با اعمال فیلترهای برگزیننده برچسب و فیلد نظارت می‌شوند.

--ns-expression="" عبارت CEL برای انتخاب فضاهای نام. قبل از نظارت بر یک فضای نام و در هنگام هرگونه به‌روزرسانی برای شیء فضای نام ارزیابی می‌شود.

--ns-field-selector="" برگزینندهٔ فیلد برای انتخاب فضاهای نام.

--ns-label-selector="" برگزینندهٔ برچسب برای انتخاب فضاهای نام.

--rbac[=false] نظارت بر roles و rolebindings در گروه rbac.authorization.k8s.io/v1.

-r, --resource=[] منابع برای نظارت. می‌توانید فهرست منابع پشتیبانی‌شده توسط کلاستر خود را با اجرای 'kubectl api-resources' مشاهده کنید.

--root-expression=[] عبارت CEL برای انتخاب اشیای ریشه. به نسخهٔ ۱۸.۳ یا بالاتر GitLab و ایجنت نیاز دارد.

--stdin[=false] خواندن درخواست نظارت از ورودی استاندارد (stdin).

گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)

-h, --help[=false] نمایش راهنما برای این دستور.

-R, --repo="" انتخاب یک مخزن دیگر. می‌توانید از OWNER/REPO یا GROUP/NAMESPACE/REPO استفاده کنید. نشانی کامل URL یا آدرس Git نیز پذیرفته می‌شود.

مثال‌ها (EXAMPLES)

# اجرای پرس‌وجوی پیش‌فرض برای ایجنت ۱۲۳
glab cluster graph -R user/project -a 123
# نمایش منابع متداول از گروه‌های core و RBAC
glab cluster graph -R user/project -a 123 --core --rbac
# نمایش منابع خاص
glab cluster graph -R user/project -a 123 --resource=pods --resource=configmaps
# همانند دستور بالا، اما فشرده‌تر
glab cluster graph -R user/project -a 123 -r={pods,configmaps}
# انتخاب یک فضای نام مشخص
glab cluster graph -R user/project -a 123 -n={my-ns,my-stuff}
# انتخاب فضاهای نام با یک برچسب خاص
glab cluster graph -R user/project -a 123 --ns-label-selector environment=production
# ارسال یک درخواست نظارت سفارشی از یک فایل
glab cluster graph -R user/project -a 123 --stdin < query.json
# نمایش اشیای قابل دسترس از ریشه‌های pod
glab cluster graph -R user/project -a 123 --root-expression "resource ==

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

glab-cluster(1)