درخواست های pull در گیت هاب

درخواست های pull در گیت هاب به شما امکان می‌دهند تغییراتی را که به branch در یک مخزن GitHub اعمال کرده‌اید به دیگران بگویید. هنگامی که یک درخواست pull باز شد، میتوانید تغییرات احتمالی را با همکاران مورد بحث و بررسی قرار دهید و قبل از اینکه تغییرات شما در شاخه پایه ادغام شوند، commit های بعدی را اضافه کنید.

درباره درخواست pull در گیت هاب

می‌توانید در GitHub.com، با دسکتاپ GitHub، در GitHub Codespaces، در GitHub Mobile و هنگام استفاده از GitHub CLI، درخواست‌های pull ایجاد کنید.

پس از راه اندازی یک درخواست پول، یک صفحه بررسی خواهید دید که نمای کلی از تغییرات بین branch شما (شاخه مقایسه) و شاخه پایه مخزن را نشان می دهد. می‌توانید خلاصه‌ای از تغییرات پیشنهادی را اضافه کنید، تغییرات ایجاد شده توسط commit‌ها را مرور کنید، برچسب‌ها، نقاط عطف و تخصیص‌یافته‌ها را اضافه کنید و از مشارکت‌کنندگان یا تیم‌ها نام ببرید. اگر به صورت کلی با ساختار گیت و گیت هاب آشنایی ندارید، توصیه می کنیم تا آموزش git و github را در سایت امیر رسولی مشاهده کنید.

هنگامی که یک درخواست pull ایجاد کردید، می توانید commit ها را از شاخه موضوع خود فشار دهید تا آنها را به درخواست کشش موجود خود اضافه کنید. این commit ها به ترتیب زمانی در درخواست pull شما ظاهر می شوند و تغییرات در تب “Files change” قابل مشاهده خواهند بود.

سایر مشارکت‌کنندگان می‌توانند تغییرات پیشنهادی شما را بررسی کنند، نظرات بررسی را اضافه کنند، در بحث درخواست pull مشارکت کنند و حتی commit هایی را به درخواست pull اضافه کنند. به‌ طور پیش‌ فرض، در مخازن عمومی، هر کاربری می‌تواند نظراتی را ارسال کند که درخواست pull را تایید یا درخواست تغییر کند. صاحبان سازمان و مدیران مخزن می‌توانند افرادی را که می‌توانند درخواست بازبینی تایید کننده یا درخواست تغییرات را ارائه دهند، محدود کنند.

می توانید اطلاعات مربوط به وضعیت استقرار فعلی branch و فعالیت های استقرار گذشته را در برگه “Conversation” مشاهده کنید. پس از اینکه از تغییرات پیشنهادی راضی شدید، می توانید درخواست pull را ادغام کنید. اگر در یک مدل مخزن اشتراکی کار می کنید، یک درخواست pull ایجاد میکنید و شما یا شخص دیگری، تغییرات خود را از شاخه ویژگی خود در شاخه پایه ای که در درخواست کشش خود مشخص کرده اید ادغام می کنید.

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

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

پیش نویس درخواست های pull در گیت هاب

قبل از اینکه پیش نویس درخواست ها در گیت را مورد بررسی قرار دهید، اگر با ساخت پروژه در گیت هاب آشنایی ندارید، میتوانید مقاله مورد نظر را در سایت ما مطالعه کنید. درخواست‌های pull پیش‌نویس در مخازن عمومی با GitHub Free برای سازمان‌ها و طرح‌های صورت‌حساب هر مخزن قدیمی و در مخازن عمومی و خصوصی با تیم GitHub، GitHub Enterprise Server 2.17+ و GitHub Enterprise Cloud در دسترس هستند.

هنگامی که یک درخواست pull ایجاد می کنید، می توانید انتخاب کنید که یک درخواست pull آماده برای بررسی ایجاد کنید، یا یک درخواست pull پیش نویس. درخواست‌های pull پیش‌نویس را نمی‌توان ادغام کرد و از صاحبان کد به‌ طور خودکار درخواست نمی‌ شود که درخواست‌ های pull پیش‌ نویس را بررسی کنند.

هنگامی که آماده دریافت بازخورد در مورد درخواست pull هستید، می توانید پیش نویس درخواست pull را به عنوان آماده برای بررسی علامت بزنید. علامت‌ گذاری یک درخواست pull به‌ عنوان آماده برای بازبینی، از صاحبان کد درخواست بازبینی می‌کند. می‌توانید هر زمان خواستید درخواست pull را به پیش‌نویس تبدیل کنید.

آموزش ایجاد یک درخواست pull

یک درخواست pull برای پیشنهاد و همکاری در تغییرات یک مخزن ایجاد می شود. این تغییرات در یک branch پیشنهاد می‌شوند، که تضمین می‌کند که شاخه پیش‌ فرض فقط شامل کارهای تکمیل‌ شده و تایید شده باشد.

اگر می خواهید یک branch جدید برای درخواست pull خود ایجاد کنید و مجوز نوشتن در مخزن ندارید، می توانید ابتدا مخزن را فورک کنید. هنگام ایجاد درخواست pull در گیت هاب، می‌توانید مشخص کنید که می‌خواهید تغییرات خود را در کدام شاخه ادغام کنید. درخواست های pull  فقط بین دو شعبه متفاوت باز می شود.

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

تغییر محدوده شاخه و مخزن مقصد

به طور پیش‌فرض، درخواست‌های pull بر اساس repository پیش‌فرض مخزن والد است.  اگر مخزن والد پیش‌ فرض درست نیست، می‌توانید هم مخزن والد و هم شاخه را با لیست‌های کشویی تغییر دهید. همچنین می توانید شاخه های سر و پایه خود را با لیست های کشویی تعویض کنید تا تفاوت بین نقاط مرجع ایجاد شود. مراجع در اینجا باید نام شعب در مخزن GitHub شما باشد.

هنگامی که به شاخه ها فکر می کنید، به یاد داشته باشید که شاخه پایه جایی است که باید تغییرات اعمال شود، شاخه سر شامل آنچه می خواهید اعمال شود.

هنگامی که مخزن پایه را تغییر می دهید، اعلان های درخواست pull را نیز تغییر می دهید. هرکسی که بتواند به مخزن پایه فشار وارد کند، یک اعلان ایمیلی دریافت می کند و دفعه بعد که وارد سیستم می شود، درخواست pull جدید را در داشبورد خود می بیند. هنگامی که هر یک از اطلاعات را در محدوده شاخه تغییر می دهید، قسمت های پیش نمایش Commit و Files تغییر یافته به روز میشوند تا محدوده جدید شما را نشان دهند.

ایجاد درخواست pull

1. در GitHub.com، به صفحه اصلی مخزن بروید.
2. در منوی «شاخه»، شاخه ای را انتخاب کنید که شامل commit های شماست.
3. در بالای لیست فایل ها، روی Pull request کلیک کنید.
4. از منوی کشویی شاخه پایه برای انتخاب شاخه ای که می خواهید تغییرات خود را در آن ادغام کنید، استفاده کنید، سپس از منوی کشویی شاخه مقایسه برای انتخاب شاخه موضوعی که تغییرات خود را در آن انجام داده اید، استفاده کنید.
5. یک عنوان و توضیحات برای درخواست pull خود تایپ کنید.
6. برای ایجاد یک درخواست pull که آماده بررسی است، روی ایجاد درخواست pull کلیک کنید. برای ایجاد یک درخواست pull پیش نویس، از منوی کشویی استفاده کنید و Create Draft Pull Request را انتخاب کنید، سپس روی درخواست pull پیش نویس کلیک کنید. برای اطلاعات بیشتر درباره پیش نویس درخواست های pull، به «درباره درخواست های pull» مراجعه کنید.