.nh
.TH "glab" "1" "Sep 2026" "Auto generated by spf13/cobra" ""

.SH "نام (NAME)"
glab-cluster-agent-bootstrap \- راه‌اندازی اولیه یک ایجنت گیت‌لب برای کوبرنتیز در یک پروژه.


.SH "خلاصه دستور (SYNOPSIS)"
\fBglab cluster agent bootstrap  [flags]\fP


.SH "توضیحات (DESCRIPTION)"
راه‌اندازی اولیه یک ایجنت گیت‌لب برای کوبرنتیز (agentk) در یک پروژه.

.PP
آرگومان نخست باید نام ایجنت باشد.

.PP
این دستور نیازمند آن است که دستورهای \fBkubectl\fR و \fBflux\fR از طریق \fB$PATH\fR\& در دسترس باشند.

.PP
این دستور شامل چندین مرحله توان‌تکرار (idempotent) است:
.IP "  1." 5
ثبت ایجنت در پروژه.
.IP "  2." 5
پیکربندی ایجنت.
.IP "  3." 5
پیکربندی یک محیط همراه با داشبورد برای ایجنت.
.IP "  4." 5
پیکربندی یک محیط همراه با داشبورد برای FluxCD (در صورت وجود \fB--create-flux-environment\fR).
.IP "  5." 5
ایجاد یک توکن برای ایجنت.
.RS
.IP \(bu 2
اگر ایجنت به حداکثر تعداد توکن‌ها رسیده باشد،
توکنی که بیشترین زمان بلااستفاده مانده باطل می‌شود
و یک توکن جدید ایجاد می‌گردد.
.IP \(bu 2
اگر ایجنت به حداکثر تعداد توکن‌ها نرسیده باشد،
یک توکن جدید ایجاد می‌شود.
.RE
.IP "  6." 5
ارسال (Push) سکرت کوبرنتیز شامل توکن به کلاستر.
.IP "  7." 5
ایجاد منابع HelmRepository و HelmRelease مربوط به Flux.
.IP "  8." 5
کامیت و ارسال (Push) منابع Helm فلوکس ایجادشده به مسیر مانیفست.
.IP "  9." 5
آغاز همگام‌سازی (reconciliation) منبع HelmRelease ایجنت گیت‌لب در Flux (مگر با \fB--no-reconcile\fR).


.SH "گزینه‌ها (OPTIONS)"
\fB--commit-author-email\fP="noreply@glab.gitlab.com"
	رایانامه نویسنده کامیت Git برای استفاده. با '--use-api-commit-author' تداخل دارد.

.PP
\fB--commit-author-name\fP="glab"
	نام نویسنده کامیت Git برای استفاده. با '--use-api-commit-author' تداخل دارد.

.PP
\fB--create-environment\fP[=true]
	ایجاد یک محیط برای ایجنت گیت‌لب.

.PP
\fB--create-flux-environment\fP[=true]
	ایجاد یک محیط برای FluxCD. تنها بر ایجاد محیط تأثیر می‌گذارد، نه بر استفاده از خود Flux. ابزار Flux همواره برای فرایند راه‌اندازی اولیه الزامی است.

.PP
\fB--environment-flux-resource-path\fP="helm.toolkit.fluxcd.io/v2beta1/namespaces//helmreleases/"
	مسیر منبع Flux محیط برای ایجنت گیت‌لب.

.PP
\fB--environment-name\fP="/"
	نام محیط برای ایجنت گیت‌لب.

.PP
\fB--environment-namespace\fP=""
	فضای نام کوبرنتیز محیط برای ایجنت گیت‌لب.

.PP
\fB--flux-environment-flux-resource-path\fP="kustomize.toolkit.fluxcd.io/v1/namespaces/flux-system/kustomizations/flux-system"
	مسیر منبع Flux محیط برای FluxCD.

.PP
\fB--flux-environment-name\fP="/"
	نام محیط برای FluxCD.

.PP
\fB--flux-environment-namespace\fP=""
	فضای نام کوبرنتیز محیط برای FluxCD.

.PP
\fB--flux-source-name\fP="flux-system"
	نام منبع Flux.

.PP
\fB--flux-source-namespace\fP="flux-system"
	فضای نام منبع Flux.

.PP
\fB--flux-source-type\fP="git"
	نوع منبع flux-system، مانند Git، OCI یا Helm.

.PP
\fB--gitlab-agent-token-secret-name\fP="gitlab-agent-token"
	نام سکرتی که توکن ایجنت گیت‌لب در آن ذخیره می‌شود. فضای نام این سکرت همان helm-release-target-namespace در نظر گرفته می‌شود.

.PP
\fB--helm-release-filepath\fP="gitlab-agent-helm-release.yaml"
	مسیر فایل در پروژه ایجنت گیت‌لب برای کامیت کردن منبع HelmRelease فلوکس در آن.

.PP
\fB--helm-release-name\fP="gitlab-agent"
	نام مانیفست HelmRelease فلوکس.

.PP
\fB--helm-release-namespace\fP="flux-system"
	فضای نام مانیفست HelmRelease فلوکس.

.PP
\fB--helm-release-target-namespace\fP="gitlab-agent"
	فضای نام استقرار ایجنت گیت‌لب.

.PP
\fB--helm-release-values\fP=[]
	مسیر محلی به فایل‌های values.yaml. چند فایل را می‌توان با کاما جدا کرد یا با تکرار فلگ مشخص نمود.

.PP
\fB--helm-release-values-from\fP=[]
	ارجاع به شیء کوبرنتیز شامل کلید داده‌های values.yaml در قالب '/\&'، که در آن 'kind' باید یکی از موارد (Secret, ConfigMap) باشد. چندین ارجاع را می‌توان با ویرگول جدا کرد یا با تکرار فلگ مشخص نمود.

.PP
\fB--helm-repository-address\fP="https://charts.gitlab.io"
	نشانی HelmRepository.

.PP
\fB--helm-repository-filepath\fP="gitlab-helm-repository.yaml"
	مسیر فایل در پروژه ایجنت گیت‌لب برای کامیت کردن HelmRepository فلوکس در آن.

.PP
\fB--helm-repository-name\fP="gitlab"
	نام مانیفست HelmRepository فلوکس.

.PP
\fB--helm-repository-namespace\fP="flux-system"
	فضای نام مانیفست HelmRepository فلوکس.

.PP
\fB-b\fP, \fB--manifest-branch\fP=""
	شاخه‌ای برای کامیت مانیفست‌های Flux در آن. به‌طور پیش‌فرض، شاخه پیش‌فرض پروژه است.

.PP
\fB-p\fP, \fB--manifest-path\fP=""
	مکان دایرکتوری در مخزن Git برای ذخیره منابع Helm ایجنت گیت‌لب برای کوبرنتیز.

.PP
\fB--no-reconcile\fP[=false]
	آغاز نکردن همگام‌سازی (reconciliation) فلوکس برای منبع Flux ایجنت گیت‌لب برای کوبرنتیز.

.PP
\fB--use-api-commit-author\fP[=false]
	هنگام ایجاد کامیت‌های Git، از کاربر درخواست API احراز هویت شده استفاده شود. با '--commit-author-name' و '--commit-author-email' تداخل دارد.


.SH "گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)"
\fB-h\fP, \fB--help\fP[=false]
	نمایش راهنما برای این دستور.

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


.SH "مثال (EXAMPLE)"
.EX
# راه‌اندازی اولیه "my-agent" در ریشه پروژه Git در پوشه جاری، و راه‌اندازی همگام‌سازی
glab cluster agent bootstrap my-agent

# راه‌اندازی اولیه "my-agent" در "manifests/" از پروژه Git در پوشه جاری، و راه‌اندازی همگام‌سازی
# به‌ویژه هنگامی که از "flux bootstrap gitlab --path manifests/" استفاده شده باشد مفید است.
# اطمینان حاصل کنید که مقدار "--path" از دستور "flux bootstrap gitlab" با
# مقدار "--manifest-path" در دستور "glab cluster agent bootstrap" مطابقت داشته باشد.
glab cluster agent bootstrap my-agent --manifest-path manifests/

# راه‌اندازی اولیه "my-agent" در "manifests/" از پروژه Git در پوشه جاری، بدون راه‌اندازی دستی همگام‌سازی
glab cluster agent bootstrap my-agent --manifest-path manifests/ --no-reconcile

# راه‌اندازی اولیه "my-agent" بدون پیکربندی محیط
glab cluster agent bootstrap my-agent --create-environment=false

# راه‌اندازی اولیه "my-agent" و پیکربندی یک محیط با نام سفارشی و فضای نام کوبرنتیز
glab cluster agent bootstrap my-agent --environment-name production --environment-namespace default

# راه‌اندازی اولیه "my-agent" بدون پیکربندی محیط FluxCD
glab cluster agent bootstrap my-agent --create-flux-environment=false

# راه‌اندازی اولیه "my-agent" و پیکربندی محیط FluxCD با نام سفارشی و فضای نام کوبرنتیز
glab cluster agent bootstrap my-agent --flux-environment-name production-flux --flux-environment-namespace flux-system

# راه‌اندازی اولیه "my-agent" و ارسال مقادیر اضافی GitLab Helm Chart از یک فایل محلی
glab cluster agent bootstrap my-agent --helm-release-values values.yaml

# راه‌اندازی اولیه "my-agent" و ارسال مقادیر اضافی GitLab Helm Chart از یک ConfigMap کوبرنتیز
glab cluster agent bootstrap my-agent --helm-release-values-from ConfigMap/agent-config

# راه‌اندازی اولیه "my-agent" و ایجاد کامیت با کاربر سفارشی
glab cluster agent bootstrap my-agent --commit-author-name="Tanuki" --commit-author-email="tanuki@example.com"

# راه‌اندازی اولیه "my-agent" با کاربر API احراز هویت شده
glab cluster agent bootstrap my-agent --use-api-commit-author
.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBglab-cluster-agent(1)\fP