نام (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)