نام (NAME)

glab-ci-run-trig - اجرای یک تریگر پایپ‌لاین CI/CD.

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

glab ci run-trig [flags]

توضیحات (DESCRIPTION)

از --token برای ارائه توکن تریگر پایپ‌لاین استفاده کنید. در صورت حذف آن، متغیر محیطی CI_JOB_TOKEN باید مقداردهی شده باشد.

از --branch برای تعیین یک شاخه یا ارجاع (reference) استفاده کنید. مقدار پیش‌فرض، شاخهٔ فعلی است.

با استفاده از فلگ -i یا --input برای هر ورودی، یک یا چند ورودی پایپ‌لاین را مشخص کنید. هر فلگ ورودی از قالب key:value استفاده می‌کند.

مقادیر دارای نوع داده هستند و در صورتی که نوعی صریحاً مشخص نشده باشد، به‌طور پیش‌فرض از نوع string خواهند بود. برای تعیین نوع، از نحو type(value) استفاده کنید. برای نمونه، key:string(value) رشتهٔ value را به‌عنوان ورودی ارسال می‌کند.

انواع معتبر عبارتند از:

• string: یک مقدار رشته‌ای. این نوع پیش‌فرض است. برای نمونه، key:string(value).
• int: یک مقدار عدد صحیح. برای نمونه، key:int(42).
• float: یک مقدار ممیز شناور (اعشاری). برای نمونه، key:float(3.14).
• bool: یک مقدار بولی (منطقی). برای نمونه، key:bool(true).
• array: آرایه‌ای از رشته‌ها. برای نمونه، key:array(foo,bar).

یک آرایه از رشته‌ها را می‌توان با یک ویرگول پایانی مشخص کرد. برای نمونه، key:array(foo,bar,) آرایهٔ [foo, bar] را ارسال می‌کند. مقدار array() یک آرایهٔ خالی را مشخص می‌کند. برای ارسال آرایه‌ای با یک رشتهٔ خالی، از array(,) استفاده کنید.

آرگومان‌های مقداری که حاوی پرانتز هستند باید با استفاده از علامت نقل‌قول (کوتیشن) برای شل اسکیپ شوند. برای نمونه، --input key:array(foo,bar) باید به‌صورت --input 'key:array(foo,bar)' نوشته شود.

گزینه‌ها (OPTIONS)

-b, --branch="" ایجاد پایپ‌لاین روی شاخه یا ارجاع (reference).

-i, --input=[] ارسال ورودی‌ها به پایپ‌لاین در قالب 'key:value'. نمی‌توان برای پایپ‌لاین‌های Merge Request استفاده کرد. برای مشاهده مثال‌ها به مستندات مراجعه کنید.

-t, --token="" توکن تریگر پایپ‌لاین. فقط در صورتی می‌تواند حذف شود که متغیر محیطی 'CI_JOB_TOKEN' تنظیم شده باشد.

--variables=[] ارسال متغیرها به پایپ‌لاین در قالب key:value. چندین متغیر را می‌توان با کاما از هم جدا کرد یا با تکرار فلگ مشخص نمود.

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

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

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

مثال‌ها (EXAMPLES)

glab ci run-trig -t xxxx
glab ci run-trig -t xxxx -b main
# تعیین متغیرهای CI
glab ci run-trig -t xxxx -b main --variables key1:val1
glab ci run-trig -t xxxx -b main --variables key1:val1,key2:val2
glab ci run-trig -t xxxx -b main --variables key1:val1 --variables key2:val2
# تعیین ورودی‌های CI
glab ci run-trig -t xxxx -b main --input key1:val1 --input key2:val2
glab ci run-trig -t xxxx -b main --input "replicas:int(3)" --input "debug:bool(false)" --input "regions:array(us-east,eu-west)"

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

glab-ci(1)