خطوط لوله را با استفاده از API تحریک کنید

برای ایجاد خط لوله برای یک شاخه یا برچسب خاص ، می توانید از یک تماس API به خط لوله API API استفاده کنید.

• یک نشانه ماشه برای ایجاد یک شاخه یا خط لوله برچسب.
• یک نشانه کار CI/CD برای ایجاد خط لوله چند پروژه.

یک نشانه ماشه ایجاد کنید

می توانید با تولید یک نشانه ماشه و استفاده از آن برای تأیید هویت API ، خط لوله ای را برای یک شاخه یا برچسب ایجاد کنید. این نشانه دسترسی و مجوزهای پروژه کاربر را جعل می کند.

• شما باید حداقل نقش نگهدارنده را برای پروژه داشته باشید.

1. On the top bar, select Main menu>پروژه ها را پیدا کنید و پروژه خود را پیدا کنید.
2. On the left sidebar, select Settings>CI/CD.
3. محرک های خط لوله را گسترش دهید.
4. توضیحات را وارد کنید و Add Trigger را انتخاب کنید.
   • می توانید نشانه های کامل را برای همه محرک هایی که ایجاد کرده اید مشاهده و کپی کنید.
   • فقط می توانید 4 کاراکتر اول را برای نشانه های ایجاد شده توسط سایر اعضای پروژه مشاهده کنید.

این یک خطر امنیتی برای صرفه جویی در نشانه ها در متن ساده در پروژه های عمومی است. مهاجمان بالقوه می توانند از یک نشانه ماشه در معرض پرونده . gitlab-ci. yml استفاده کنند تا از کاربر که توکن ایجاد کرده است ، جعل کند. برای بهبود امنیت نشانه های ماشه از متغیرهای نقاب CI/CD استفاده کنید.

خط لوله را تحریک کنید

پس از ایجاد یک توکن ماشه ، می توانید از آن برای ایجاد خطوط لوله با ابزاری که می تواند به API یا یک وب وب دسترسی پیدا کند ، استفاده کنید.

از فر استفاده کنید

از یک دستور CURL MULTILINE استفاده کنید:

از Curl استفاده کنید و از رشته پرس و جو عبور کنید:

• URL با https://gitlab.com یا URL نمونه شما.
• با نشانه ماشه خود
• با یک شاخه یا نام برچسب ، مانند اصلی.
• با شناسه پروژه خود ، مانند 123456. شناسه پروژه در بالای صفحه فرود هر پروژه نمایش داده می شود.

از کار CI/CD استفاده کنید

در هنگام اجرای خط لوله دیگر می توانید از یک کار CI/CD با یک نشانه محرک برای ایجاد خطوط لوله استفاده کنید.

به عنوان مثال ، برای ایجاد خط لوله در شاخه اصلی Project-B هنگامی که یک برچسب در پروژه A ایجاد می شود ، کار زیر را به پرونده A. gitlab-ci. yml Project A اضافه کنید:

• 1234 شناسه پروژه برای Project-B است. شناسه پروژه در بالای صفحه فرود هر پروژه نمایش داده می شود.
• این قوانین باعث می شود که کار هر بار که یک برچسب به Project-A اضافه شود ، کار را اجرا کند.
• MY_TRIGGER_TOKEN یک متغیرهای CIS/CD ماسک شده است که حاوی نشانه ماشه است.

از یک وب وب استفاده کنید

برای ایجاد خط لوله از وب سایت پروژه دیگر ، از URL Webhook مانند موارد زیر برای Push and Tag Events استفاده کنید:

• URL با https://gitlab.com یا URL نمونه شما.
• با شناسه پروژه خود ، مانند 123456. شناسه پروژه در بالای صفحه فرود پروژه نمایش داده می شود.
• با یک شاخه یا نام برچسب ، مانند اصلی. این مقدار برتری نسبت به ref_name در بار Webhook Payload دارد. Ref Payload شعبه ای است که ماشه را در مخزن منبع شلیک کرد. اگر حاوی برش باشد ، باید ref_name را باز کنید.
• با نشانه ماشه خود

از بار وب سایت استفاده کنید

• معرفی شده در Gitlab 13. 9.
• پرچم ویژگی حذف شده در Gitlab 13. 11.

اگر با استفاده از یک وب وب ، خط لوله را ایجاد کنید ، می توانید با متغیر CI/CD از پیش تعریف شده Trigger_Payload به Webhook Payload دسترسی پیدا کنید. Payload به عنوان یک متغیر از نوع پرونده در معرض دید قرار می گیرد ، بنابراین می توانید با CAT $ trigger_payload یا یک دستور مشابه به داده ها دسترسی پیدا کنید.

عبور از متغیرهای CI/CD در تماس API

می توانید هر تعداد متغیرهای CI/CD را در تماس API Trigger منتقل کنید. این متغیرها بالاترین برتری را دارند و همه متغیرها را با همین نام نادیده می گیرند.

پارامتر از متغیرهای فرم است [کلید] = مقدار ، به عنوان مثال:

متغیرهای CI/CD در خطوط لوله تحریک شده در صفحه هر کار نمایش داده می شوند ، اما فقط کاربران با مالک و نقش نگهدارنده می توانند مقادیر را مشاهده کنند.

نشانه ماشه را لغو کنید

1. On the top bar, select Main menu>پروژه ها را پیدا کنید و پروژه خود را پیدا کنید.
2. On the left sidebar, select Settings>CI/CD.
3. محرک های خط لوله را گسترش دهید.
4. در سمت چپ نشانه ماشه می خواهید لغو کنید ، Revoke را انتخاب کنید ().

یک نشانه ماشه ابطال شده نمی تواند به آن اضافه شود.

کارهای CI/CD را پیکربندی کنید تا در خطوط لوله تحریک شده اجرا شود

• از قوانین با متغیر CI/CD از پیش تعریف شده CI_PIPELINE_SOURCE استفاده کنید.
• فقط از کلمات کلیدی استفاده کنید.

علاوه بر این ، متغیر CI_PIPELINE_TRIGGERED از پیش تعریف شده CI/CD در خطوط لوله های تحریک شده با نشانه ماشه تنظیم شده است.

ببینید از کدام توکن ماشه استفاده شده است

با مراجعه به صفحه شغلی واحد ، می توانید ببینید که چه عواملی باعث شده است که شغل کار کند. بخشی از نشانه های ماشه در سمت راست صفحه ، تحت جزئیات کار:

In pipelines triggered with a trigger token, jobs are labeled as triggered in CI/CD>شغل ها .

عیب یابی

404 هنگام ایجاد خط لوله یافت نشد

پاسخ هنگام تحریک خط لوله ممکن است با استفاده از نشانه دسترسی شخصی به جای نشانه ماشه ایجاد شود. یک نشانه ماشه جدید ایجاد کنید و به جای نشانه دسترسی شخصی از آن استفاده کنید.

URL درخواست شده خطای بازگشت: 400 هنگام ایجاد خط لوله

اگر سعی می کنید خط لوله را با استفاده از یک Ref که نام شاخه ای است که وجود ندارد ، ایجاد کنید ، GitLab خطای بازگردانده شده URL درخواست شده را برمی گرداند: 400.

به عنوان مثال ، شما ممکن است به طور تصادفی از Main برای نام شعبه در یک پروژه استفاده کنید که از یک شاخه متفاوت برای شاخه پیش فرض خود استفاده می کند.

کمک و بازخورد

برای رفع خطا یا افزودن بهبودی در درخواست ادغام، این صفحه را ویرایش کنید. برای پیشنهاد بهبود در این صفحه مشکلی ایجاد کنید. نمایش و ارسال نظرات برای بررسی و ارائه بازخورد در مورد این صفحه.

تولید - محصول

اگر چیزی در مورد این ویژگی دوست ندارید، مشکلی ایجاد کنید. با ارسال یک درخواست ویژگی، عملکرد را پیشنهاد دهید. برای کمک به شکل دهی ویژگی های جدید، به First Look بپیوندید.

در دسترس بودن ویژگی و آزمایش محصول

برای مشاهده تمام سطوح و ویژگی های GitLab یا ارتقاء، قیمت ها را مشاهده کنید. GitLab را به صورت رایگان با دسترسی به همه ویژگی ها به مدت 30 روز امتحان کنید.

کمک بگیر

اگر آنچه را که به دنبال آن بودید پیدا نکردید، اسناد را جستجو کنید.

اگر در مورد چیزی خاص کمک می خواهید و می توانید از پشتیبانی انجمن استفاده کنید، در انجمن GitLab پست کنید.

برای مشکلات راه اندازی یا استفاده از این ویژگی (بسته به اشتراک GitLab شما).