پیکربندی محرک های برنامه

ماشه برنامه اجازه می دهد تا برنامه ای را برای اجرای خودکار ساخت و ساز در یک پیکربندی معین تعیین کنید. محرک های برنامه چندگانه را می توان به یک پیکربندی ساخت و ساز اضافه کرد.

بخش برنامه Builds از تنظیمات پروژه فعلی زمان ساخت پیکربندی شده را نشان می دهد.

ایجاد شرایط

در این بخش پارامترهای ماشه برنامه مانند زمان بندی و قوانین VCS شرح داده شده است.

تاریخ و زمان

می توانید یک ساخت مکرر را برنامه ریزی کرده یا تاریخ و زمان خاصی را برای آن تعیین کنید.

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

TeamCity از کوارتز برای کار با عبارات Cron استفاده می کند. این مثالها را ببینید یا استفاده از ابزار cronmaker را برای تولید عبارات بر اساس قالب کرون کوارتز در نظر بگیرید.

VCS تغییر می کند

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

اگر گزینه "نمایش از وابستگی های عکس فوری" در تنظیمات کنترل نسخه پیکربندی ساخت فعال شود ، یک ماشه برنامه نیز تغییرات را از تنظیمات وابستگی در نظر می گیرد).

VCS قوانین را ایجاد می کند

اگر هیچ قانون ماشه مشخص نشده باشد ، ساختاری بر روی هرگونه تغییر تشخیص داده شده برای پیکربندی ساخت ایجاد می شود. شما می توانید با تغییر تنظیمات ریشه VCS و مشخص کردن قوانین پرداخت ، چه تغییراتی را کنترل کنید.

برای محدود کردن تغییراتی که باعث ایجاد ساخت می شود ، از قوانین محرک VCS استفاده کنید. می توانید این قوانین را به صورت دستی در قسمت متن (یک در هر خط) اضافه کنید ، یا از گزینه Add New Rule برای تولید آنها استفاده کنید.

هر قانون اتر "شامل" (با +) یا "مستثنی" (شروع می شود -) است.

نحو عمومی

نحو کلی برای یک قانون واحد:

+|-[: [کاربر = vcs_useame ؛] [root = vcs_root_id ؛] [نظر = vcs_comment_regexp]]: ant_lay_wildcard

در اینجا ، نماد لوله |نمایانگر OR ، مانند عبارات منظم است: از + برای استفاده ، یا - برای حذف استفاده کنید.

• ANT_LIKE_WILDCARD: یک کارت وحشی برای مطابقت با مسیر پرونده تغییر یافته. فقط الگوهای * و ** پشتیبانی می شوند ،؟الگوی پشتیبانی نمی شود. مسیرهای پرونده در این قاعده می توانند نسبی باشند (با / یا ) برای مطابقت با مسیرهای حاصل از عامل یا مطلق (شروع شده با /) برای مطابقت با مسیرهای VCS نسبت به ریشه VCS. برای هر پرونده در یک تغییر ، خاص ترین قانون یافت می شود (قانون مطابق با طولانی ترین مسیر پرونده). در صورت وجود حداقل یک پرونده با "شامل" قانون "یا پرونده ای که دارای قوانین مطابق با" حذف "باشد ، ساخت و ساز ایجاد می شود.
• VCS_USERNAME: در صورت مشخص شدن ، این قانون را فقط به تغییرات ایجاد شده توسط کاربر با نام کاربری مربوطه VCS محدود می کند.
• VCS_ROOT_ID: در صورت مشخص شدن ، این قانون را فقط به تغییرات از ریشه VCS مربوطه محدود می کند.
• VCS_COMMENT_REGEXP: در صورت مشخص شدن ، این قانون را فقط به تغییراتی که حاوی متن مشخص شده در نظر VCS است محدود می کند. برای تطبیق متن در یک نظر از الگوی بیان منظم جاوا استفاده کنید (مثالهای زیر را ببینید). اگر متن اظهار نظر حاوی بخش متن همسان باشد ، این قانون مطابقت دارد. برای مطابقت با کل متن ، شخصیت های خاص ^ و $ را درج کنید.

هنگام تعیین قوانین ، توجه داشته باشید که به محض ورود به هر قانون + ، TeamCity پیش فرض ضمنی را از "شامل همه" برای "حذف همه" تغییر می دهد. برای درج همه پرونده ها ، از +:. قانون.

همچنین ، قوانین با توجه به ویژگی مسیر طبقه بندی می شوند. اگر یک قانون ورود صریح برای /برخی /مسیر و قانون محرومیت دارید -: کاربر = Some_user :. برای همه مسیرها ، متعهد به/برخی/مسیر از Some_user گنجانده خواهد شد مگر اینکه یک قانون محرومیت خاص برای این کاربر و این مسیر به طور هم زمان اضافه کنید ، مانند:: کاربر = some_user:/some/path/**

مثالها را تحریک کنید

شامل همه پرونده ها

تمام پرونده های . html را از ایجاد ساخت و ساز خارج می کند.

مستثنی ساخته شده توسط پرونده های . xml که توسط کاربر TechWriter VCS به فهرست متفرقه/DOC ریشه VCS با نام SVN داخلی (همانطور که در تنظیمات VCS تعریف شده است) ایجاد می شود. توجه داشته باشید که مسیر مطلق است (با /) شروع می شود ، بنابراین مسیر پرونده از ریشه VCS مطابقت دارد.

جلوگیری از ساخت و ساز با به روزرسانی در فهرست LIB منابع ساخت (همانطور که در عامل ظاهر می شود). توجه داشته باشید که مسیر نسبی است ، بنابراین تمام پرونده های قرار داده شده در فهرست (با پردازش قوانین پرداخت ریشه VCS) باعث ایجاد ساخت نمی شوند.

در صورتی که بررسی تغییرات شامل کلمه جزئی در نظر باشد ، از ایجاد ساخت و ساز جلوگیری می کند.

اگر این اظهار نظر فقط از کلمه OOPS باشد (مطابق با اصول بیان منظم جاوا ^ و $ در الگوی برای شروع و پایان رشته) نیست.

اگر این نظر حاوی کلمه کلیدی #teamcity باشد ، ساخت را ایجاد می کند.

اگر این نظر شامل کلمات کلیدی #TeamCity و #Major باشد ، ساخت و ساز را ایجاد می کند. در اینجا ، (؟) یک الگوی dotall است که شخصیت را می سازد. با هر کاراکتر ، از جمله یک ترمینال خط مطابقت داشته باشید و امکان بررسی نظرات چند لایه را فراهم می کند.

به عنوان مثال ، نظر زیر باعث ایجاد ساخت می شود:

#teamcity خط اول #Major خط دوم

ایجاد تغییرات

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

• آخرین ساخت تمام شده
• آخرین ساخت موفق
• آخرین ساخت پین
• آخرین ساخت تمام شده با یک برچسب ساخت مشخص

اگر ماشه ساخت جدیدی را تشخیص دهد که ویژگی منتخب را در پیکربندی تماشا شده برآورده کند ، در پیکربندی خود یک ساخت جدید ایجاد می کند.

این ماشه فقط به طور منظم (نه شخصی یا تاریخ) در شاخه پیش فرض ساخته می شود.

اگر ساخت و ساز تحریک شده از طریق یک عکس فوری یا وابستگی به مصنوعات بستگی به ساخت و ساز دارد ، گزینه "تبلیغات تبلیغاتی" را انتخاب کنید تا TeamCity بتواند به طور خودکار ساخت و ساز شناسایی شده را به ساخت محرک ترویج کند. در غیر این صورت ، ساخت به طور معمول آغاز می شود و هیچ ارتباطی با ساخت شناسایی شده نخواهد داشت.

گزینه های اضافی

پرداخت تمیز را اجرا کنید

قبل از گزینه ساخت ، تمام پرونده ها را در فهرست Checkout Directory فعال کنید تا TeamCity را مجبور به تمیز کردن تمام پرونده های موجود در فهرست Checkout قبل از اجرای ساخت کنید. این گزینه همچنین می تواند برای وابستگی های عکس فوری اعمال شود. در این حالت ، تمام ساختهای زنجیره ساخت و ساز مجبور به استفاده از پرداخت تمیز می شوند. این گزینه همچنین امکان بازسازی کلیه وابستگی ها را فراهم می کند (مگر اینکه وابستگی های سفارشی از طریق گفتگوی ساخت سفارشی یا یک ماشه برنامه ایجاد ایجاد شود).

ساخت همه عوامل فعال و سازگار

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

• ساخت و ساز برای اهداف نگهداری عامل را اجرا کنید (به عنوان مثال ، می توانید پیکربندی ایجاد کنید تا بررسی کنید که آیا نمایندگان پس از بروزرسانی/به روزرسانی محیط به درستی عمل می کنند)
• ساخت و ساز را روی سیستم عامل های مختلف اجرا کنید (به عنوان مثال ، می توانید پیکربندی را تنظیم کرده و تعدادی از عوامل سازگار سازگار را با محیط های مختلف نصب شده برای آن مشخص کنید)

تنظیمات بهینه سازی صف را بسازید

به طور پیش فرض ، TeamCity صف ساخت را بهینه می کند: ساخت و ساز در حال حاضر می تواند با ساخت و ساز در حال حاضر آغاز شده یا ساخت و سازهای اخیر جایگزین شود. شما می توانید این رفتار پیش فرض را با چک کردن جعبه مربوطه غیرفعال کنید.

فیلتر شاخه

به طور پیش فرض ، یک ماشه برنامه برای همه شاخه ها کار می کند.

قوانین ماشه و فیلتر شاخه ترکیب شده است

قوانین ماشه و فیلتر شاخه با هم ترکیب می شوند و به این معنی که ساخت فقط در صورت رضایت هر دو شرط انجام می شود.

به عنوان مثال ، اگر متن نظر را در قسمت Trigger Rules مشخص کنید و مشخصات شعبه را ارائه دهید ، ساخت فقط در صورتی انجام می شود که یک متعهد دارای متن مشخص باشد و همچنین در شاخه ای باشد که با فیلتر شاخه مطابقت داشته باشد.

ایجاد سفارشی سازی

برگه ساخت و ساز سفارشی سازی تنظیمات یک ماشه اجازه می دهد تا پیکربندی پارامترهای سفارشی ساخت و سازها که توسط این ماشه آغاز شده است. به طور مشابه با گفتگوی Run Custom Build ، به شما امکان می دهد تا مقادیر پارامترهای ساخت را نادیده بگیرید و انتخاب کنید که آیا دایرکتوری پرداخت قبل از ساخت تمیز می شود.

در این برگه ، می توانید مقدار هر پارامتر مورد استفاده در پیکربندی ساخت فعلی را سفارشی کنید. یا ، می توانید یک پارامتر جدید اضافه کنید ، و فقط در ساختهای شروع شده توسط این ماشه در دسترس خواهد بود. اگر ساخت فعلی دارای وابستگی های عکس فوری به سایر ساختمانها باشد ، می توان از چنین پارامتری نیز برای نادیده گرفتن خاصیت خاصی از پیکربندی ساخت وابستگی استفاده کرد: از معکوس استفاده کنید. syntax برای این کار.

اگر آن را با شرایط اجرای مرحله ساخت ، این قابلیت مؤثرتر شود. شما فقط باید یک شرط مبتنی بر پارامتر را به یک مرحله اضافه کنید و سپس دو محرک را پیکربندی کنید: یکی با این مرحله (در صورت رضایت از شرط) و دیگری-بدون آن-ساخت. یک مورد استفاده محبوب این است که تعداد محدودی از تست ها را در ساختهای منظم انجام دهید اما مجموعه ای کامل از تست ها در یک ساخت شبانه ، هنگامی که بار سرور کمترین است.

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

TeamCity اجازه می دهد تا کارهای مشابه را به روش های مختلفی حل کنید و در برخی موارد هنوز هم ترجیح داده می شود تنظیمات ساختاری مختلف ایجاد شود. به عنوان مثال ، اگر اجرای سفارشی بسیار زیادی در همان پیکربندی وجود داشته باشد ، ممکن است پیش بینی مدت زمان دقیق هر ساخت برای TeamCity سخت تر باشد. اگر نیاز به ایجاد ساخت و ساز با پارامترهای مختلف مختلف دارید ، پیشنهاد می کنیم یک الگوی پیکربندی ساخت ایجاد کنید و از آن به عنوان طرح برای چندین پیکربندی استفاده کنید که هر کدام پارامترهای خاص خود را دارند.