نام (NAME)

glab-ci-run - ایجاد یک پایپ‌لاین جدید CI/CD.

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

glab ci run [flags]

توضیحات (DESCRIPTION)

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

فلگ‌های متغیر (--variables، --variables-env، --variables-file، --variables-from) را نمی‌توان همراه با --mr استفاده کرد. در صورت استفاده همزمان از هر دو، دستور با خطا مواجه خواهد شد.

با استفاده از فلگ -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) استفاده کرد. برای مشاهده مثال‌ها به مستندات مراجعه کنید.

--mr[=false] اجرای پایپ‌لاین درخواست ادغام (Merge Request) به‌جای پایپ‌لاین شاخه.

--variables=[] ارسال متغیرها به پایپ‌لاین در قالب key:value. نمی‌توان برای پایپ‌لاین‌های درخواست ادغام (MR) استفاده کرد.

--variables-env=[] ارسال متغیرها به پایپ‌لاین در قالب key:value. نمی‌توان برای پایپ‌لاین‌های درخواست ادغام (MR) استفاده کرد.

--variables-file=[] ارسال محتوای فایل به عنوان یک متغیر فایلی به پایپ‌لاین در قالب key:value. نمی‌توان برای پایپ‌لاین‌های درخواست ادغام (MR) استفاده کرد.

-f, --variables-from="" فایل JSON حاوی متغیرها برای اجرای پایپ‌لاین. یک آرایه از هش‌ها مورد انتظار است که هرکدام حداقل شامل 'key' و 'value' باشند. نمی‌توان برای پایپ‌لاین‌های درخواست ادغام (MR) استفاده کرد.

-w, --web[=false] باز کردن پایپ‌لاین در یک مرورگر. از مرورگر پیش‌فرض، یا مرورگر مشخص‌شده در متغیر محیطی BROWSER استفاده می‌کند.

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

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

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

مثال‌ها (EXAMPLES)

glab ci run
glab ci run --variables
glab ci run -b main
glab ci run --web
glab ci run --mr
# تعیین متغیرهای CI
glab ci run -b main --variables-env key1:val1
glab ci run -b main --variables-env key1:val1,key2:val2
glab ci run -b main --variables-env key1:val1 --variables-env key2:val2
glab ci run -b main --variables-file MYKEY:file1 --variables KEY2:some_value
# تعیین ورودی‌های CI
glab ci run -b main --input key1:val1 --input key2:val2
glab ci run -b main --input "replicas:int(3)" --input "debug:bool(false)" --input "regions:array(us-east,eu-west)"
# بارگذاری متغیرها از فایل JSON
# فایل variables.json را با این ساختار ایجاد کنید:
# [
#   {
#     "key": "CI_PIPELINE_SOURCE",
#     "value": "web",
#     "variable_type": "env_var"
#   },
#   {
#     "key": "DEPLOY_ENV",
#     "value": "production"
#   }
# ]
glab ci run -b main --variables-from variables.json

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

glab-ci(1)