نام (NAME)

glab-config - مدیریت تنظیمات glab

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

glab config [flags]

توضیحات (DESCRIPTION)

مدیریت رشته‌های کلید/مقدار.

تنظیمات معتبر فعلی:

• api_host: پیکربندی میزبان برای نقطهٔ پایانی ای‌پی‌آی. پیش‌فرض خود میزبان است. همچنین با نام gitlab_api_host نیز پذیرفته می‌شود. محدودهٔ اثر آن به ازای هر میزبان است؛ آن را با --host تنظیم کنید.
• api_protocol: پروتکل مورد استفاده برای دسترسی به نقطهٔ پایانی API. مقادیر پشتیبانی‌شده: http، https. محدودهٔ اثر به ازای هر میزبان است؛ آن را با --host تنظیم کنید.
• artifact_registry_domains: دامنه‌های رجیستری‌های مصنوعات (Artifact Registries) مرتبط. این مقادیر برای پیکربندی دستیار اعتبارنامهٔ داکر (Docker credential helper) به کار می‌روند. تنها زمانی دامنه‌ای را در اینجا فهرست کنید که واقعاً توسط GitLab Artifact Registry پشتیبانی شود: دستیار اعتبارنامه ابتدا این کلید را امتحان می‌کند و تبادل موفق توکن را همان‌گونه که هست به کار می‌گیرد، بدون هیچ‌گونه بازگشت (fallback) به container_registry_domains. اگر دامنهٔ یک رجیستری کانتینر به اشتباه در اینجا فهرست شود، یک توکن رجیستری مصنوعات دریافت می‌کند که رجیستری آن را رد کرده و دستور docker pull کاملاً با شکست مواجه می‌شود. محدودهٔ اثر به ازای هر میزبان است؛ آن را با --host تنظیم کنید.
• branch_prefix: پیشوند مورد استفاده توسط glab stack هنگام نام‌گذاری شاخه‌های تولیدشده. پیش‌فرض، نام‌کاربری کاربر فعلی است (از os/user.Current)، و در صورت در دسترس نبودن به glab-stack برمی‌گردد.
• browser: مرورگری که glab هنگام باز کردن پیوندها باید اجرا کند. این پیکربندی سراسری را نمی‌توان بر اساس نام میزبان بازنویسی کرد.
• ca_cert: مسیر گواهی CA (با فرمت PEM) که برای اعتبارسنجی گواهی TLS سرور GitLab استفاده می‌شود. برای مرجع‌های صدور گواهی خودامضا یا خصوصی مفید است. محدودهٔ اثر به ازای هر میزبان است؛ آن را با --host تنظیم کنید.
• check_update: به glab اجازه می‌دهد به‌طور خودکار وجود به‌روزرسانی‌ها را بررسی کرده و هنگام موجود بودن به‌روزرسانی‌های جدید به شما اطلاع دهد.
• client_cert: مسیر گواهی کلاینت (PEM) مورد استفاده برای احراز هویت دوجانبهٔ TLS (موسوم به mTLS). محدودهٔ اثر به ازای هر میزبان است؛ آن را با --host تنظیم کنید.
• client_id: شناسهٔ کلاینت (Client ID) برنامهٔ OAuth. هنگام احراز هویت با OAuth در نمونه‌های GitLab خودمیزبان (self-managed) الزامی است. محدودهٔ اثر به ازای هر میزبان است؛ آن را با --host تنظیم کنید.
• client_key: مسیر کلید خصوصی (PEM) منطبق با client_cert. محدودهٔ اثر به ازای هر میزبان است؛ آن را با --host تنظیم کنید.
• container_registry_domains: دامنه‌های رجیستری‌های کانتینر مرتبط. این دامنه‌ها برای پیکربندی دستیار اعتبارنامهٔ داکر به کار می‌روند. محدودهٔ اثر به ازای هر میزبان است؛ آن را با --host تنظیم کنید.
• custom_headers: هدرهای سفارشی HTTP برای افزودن به تمام درخواست‌های HTTP ارسالی توسط glab. هر هدر باید دقیقاً از یکی از موارد value، valueFromEnv یا valueFromCommand استفاده کند. یک دستور باید مقدار کامل هدر را در یک خط چاپ کند. glab آن را یک‌بار برای هر فرآیند اجرا می‌کند. محدودهٔ اثر به ازای هر میزبان است؛ آن را با --host تنظیم کنید.
• debug: خروجی اطلاعات لاگ بیشتر، شامل دستورات زیرین Git، نام‌های مستعار بسط‌یافته و جزئیات خطاهای DNS.
• display_hyperlinks: نمایش یا عدم نمایش ابرپیوندها در خروجی ترمینال. پیش‌فرض true است (برای TTYها فعال است). برای غیرفعال‌سازی روی false قرار دهید. اجبار نمایش ابرپیوندها در محیط‌های غیر TTY با تنظیم FORCE_HYPERLINKS=1 انجام می‌شود.
• duo_cli_auto_download: بارگیری خودکار باینری Duo CLI بدون درخواست تأیید (true/false).
• duo_cli_auto_run: اجرای خودکار GitLab Duo CLI بدون درخواست تأیید (true/false). برای صرف‌نظر کردن از اعلان تأیید، مقدار آن را روی true قرار دهید.
• editor: ویرایشگری که glab هنگام ایجاد ایشوها، درخواست‌های ادغام (merge requests) و غیره باید اجرا کند. این پیکربندی سراسری را نمی‌توان بر اساس نام میزبان بازنویسی کرد. همچنین با نام‌های visual و glab_editor نیز پذیرفته می‌شود.
• git_protocol: پروتکل مورد استفاده هنگام اجرای عملیات Git. مقادیر پشتیبانی‌شده: ssh، https.
• glab_pager: دستور صفحه‌بندی (pager) مورد نظر شما برای استفاده، مانند less -R. نسبت به متغیر محیطی PAGER اولویت دارد. متغیر GLAB_PAGER نسبت به هر دو اولویت دارد.
• glamour_style: تعیین سبک رندرکنندهٔ مارک‌داون مورد نظر شما. گزینه‌های موجود عبارتند از [dark, light, notty]. برای تنظیم یک سبک سفارشی، به https://github.com/charmbracelet/glamour#styles مراجعه کنید.
• host: نام میزبان پیش‌فرض GitLab برای استفاده. همچنین با نام‌های gitlab_host، gitlab_uri و gl_host نیز پذیرفته می‌شود.
• job_token: توکن کار CI مورد استفاده برای احراز هویت با Job-Token. معمولاً در زمان فعال بودن ورود خودکار CI، به‌طور خودکار از CI_JOB_TOKEN پر می‌شود. محدودهٔ اثر به ازای هر میزبان است؛ آن را با --host تنظیم کنید.
• no_prompt: برای غیرفعال کردن اعلان‌ها روی true (1) یا برای فعال‌سازی آن‌ها روی false (0) تنظیم کنید. همچنین با نام prompt_disabled نیز پذیرفته می‌شود.
• notify_skill_updates: نمایش اعلان هنگامی که برای یک مهارت ایجنت نصب‌شده (همراه بسته یا راه دور) به‌روزرسانی در دسترس باشد.
• orbit_local_auto_download: بارگیری خودکار باینری Orbit local CLI بدون درخواست تأیید (true/false).
• orbit_local_auto_run: اجرای خودکار Orbit local CLI بدون درخواست تأیید (true/false). برای صرف‌نظر کردن از اعلان تأیید، روی true تنظیم کنید.
• proxy: پراکسی سفارشی برای این میزبان. در صورت تنظیم، تنظیمات پراکسی متغیرهای محیطی را بازنویسی می‌کند. محدودهٔ اثر به ازای هر میزبان است؛ آن را با --host تنظیم کنید.
• remote_alias: نام git remote که به مخزن GitLab اشاره می‌کند. برای تشخیص اینکه هنگام پیکربندی چند ریموت باید روی کدام یک عملیات انجام شود به کار می‌رود. همچنین با نام‌های git_remote_url_var، git_remote_alias، remote_nickname و git_remote_nickname نیز پذیرفته می‌شود.
• show_whats_new: نمایش یک بنر یک‌باره پس از ارتقا با اشاره به glab whatsnew هنگام شناسایی نسخهٔ جدید.
• skip_tls_verify: صرف‌نظر کردن از اعتبارسنجی گواهی TLS هنگام ارتباط با این میزبان (true/false). مقدار خالی به عنوان false در نظر گرفته می‌شود. تنها برای محیط توسعه استفاده شود؛ در محیط عملیاتی (production) فعال نکنید. محدودهٔ اثر به ازای هر میزبان است؛ آن را با --host تنظیم کنید.
• ssh_host: نام میزبان جایگزین برای عملیات Git از طریق SSH (برای مثال ssh.example.com یا git.example.com). زمانی از این گزینه استفاده کنید که SSH از نام میزبان متفاوتی نسبت به عملیات HTTP/API استفاده می‌کند. تنها بر شبیه‌سازی (cloning) با SSH و عملیات Git تأثیر می‌گذارد. همچنین با نام gitlab_ssh_host نیز پذیرفته می‌شود. محدودهٔ اثر به ازای هر میزبان است؛ آن را با --host تنظیم کنید.
• subfolder: زیرپوشه‌ای که GitLab در آن نصب شده است (برای مثال gitlab برای https://example.com/gitlab). زمانی از این گزینه استفاده کنید که GitLab به جای ریشهٔ دامنه، در یک زیرپوشه میزبانی شده باشد. از مسیرهای تودرتو پشتیبانی می‌کند (برای مثال apps/gitlab برای https://example.com/apps/gitlab). اسلش‌ها به‌طور خودکار حذف می‌شوند، بنابراین مقادیر gitlab، /gitlab و gitlab/ معادل یکدیگرند. تنها بر عملیات HTTP/HTTPS (ای‌پی‌آی و کلون Git) اعمال می‌شود. همچنین با نام gitlab_subfolder نیز پذیرفته می‌شود. محدودهٔ اثر به ازای هر میزبان است؛ آن را با --host تنظیم کنید.
• telemetry: برای غیرفعال‌سازی ارسال داده‌های استفاده به نمونهٔ GitLab خود، مقدار آن را روی false (0) و برای فعال‌سازی روی true (1) قرار دهید. برای اطلاعات بیشتر به https://docs.gitlab.com/administration/settings/usage_statistics مراجعه کنید.
• token: توکن دسترسی GitLab شما. برای دریافت آن، به https://docs.gitlab.com/user/profile/personal_access_tokens مراجعه کنید. همچنین با نام‌های gitlab_token و oauth_token نیز پذیرفته می‌شود. محدودهٔ اثر به ازای هر میزبان است؛ آن را با --host تنظیم کنید.
• use_keyring: ذخیرهٔ اعتبارنامه‌های میزبان در جاکلیدی (keyring) سیستم‌عامل (true/false). به‌طور خودکار توسط glab auth login تنظیم می‌شود، که در صورت در دسترس بودن یک بک‌اند keyring، مقدار پیش‌فرض آن true است. مقدار خالی به عنوان false (ذخیره‌سازی متنی ساده در فایل) در نظر گرفته می‌شود. محدودهٔ اثر به ازای هر میزبان است؛ آن را با --host تنظیم کنید.

محل فایل‌های پیکربندی از مشخصات دایرکتوری پایهٔ XDG پیروی می‌کند. برای مشاهدهٔ ترتیب کامل جستجو و مسیرهای ویژهٔ هر پلتفرم، پیکربندی را ببینید: ⟨https://gitlab.com/gitlab-org/cli#configuration⟩.

گزینه‌ها (OPTIONS)

-g, --global[=false] استفاده از فایل پیکربندی سراسری.

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

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

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

glab(1), glab-config-edit(1), glab-config-get(1), glab-config-path(1), glab-config-set(1)