glab(1)                                                                glab(1)



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



خلاصه دستور (SYNOPSIS)
       glab cluster agent bootstrap  [flags]



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


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


       این دستور نیازمند آن است که دستورهای kubectl و flux از طریق $PATH در
       دسترس باشند.


       این دستور شامل چندین مرحله توان‌تکرار (idempotent) است:

         1. ثبت ایجنت در پروژه.

         2. پیکربندی ایجنت.

         3. پیکربندی یک محیط همراه با داشبورد برای ایجنت.

         4. پیکربندی یک محیط همراه با داشبورد برای FluxCD (در صورت وجود
            --create-flux-environment).

         5. ایجاد یک توکن برای ایجنت.

            • اگر ایجنت به حداکثر تعداد توکن‌ها رسیده باشد، توکنی که بیشترین
              زمان بلااستفاده مانده باطل می‌شود و یک توکن جدید ایجاد می‌گردد.

            • اگر ایجنت به حداکثر تعداد توکن‌ها نرسیده باشد، یک توکن جدید ایجاد
              می‌شود.

         6. ارسال (Push) سکرت کوبرنتیز شامل توکن به کلاستر.

         7. ایجاد منابع HelmRepository و HelmRelease مربوط به Flux.

         8. کامیت و ارسال (Push) منابع Helm فلوکس ایجادشده به مسیر مانیفست.

         9. آغاز همگام‌سازی (reconciliation) منبع HelmRelease ایجنت گیت‌لب در
            Flux (مگر با --no-reconcile).



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


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


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


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


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


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


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


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


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


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


       --flux-source-name="flux-system"   نام منبع Flux.


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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


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



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


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



مثال (EXAMPLE)
       # راه‌اندازی اولیه "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



همچنین ببینید (SEE ALSO)
       glab-cluster-agent(1)

Auto generated by spf13/cobra      Sep 2026                            glab(1)