Apa itu permintaan pull?
Kita mulai dengan:
- Meninjau cabang dan kepentingannya untuk menarik permintaan.
- Menentukan apa itu permintaan pull.
- Pelajari cara membuat permintaan pull, meninjau status permintaan pull, dan menggabungkan permintaan pull.
Cabang
Pertama, mari kita tentukan cabang apa itu, mengapa mereka penting bagi pengembang, dan bagaimana mereka terkait dengan permintaan pull.
Cabang adalah ruang kerja terisolasi di mana Anda dapat mengembangkan pekerjaan Anda tanpa memengaruhi orang lain di repositori. Mereka memungkinkan Anda untuk mengembangkan fitur, memperbaiki bug, dan bereksperimen dengan aman dengan ide-ide baru di area yang terkandung di repositori Anda.
Pengembang yang bekerja pada cabang independen adalah konsep umum dalam pengembangan perangkat lunak modern. Dengan memiliki cabang mereka sendiri, pengembang dapat membuat perubahan apa pun, yang disebut penerapan, tanpa khawatir tentang bagaimana penerapan mereka memengaruhi pengembang lain yang bekerja di cabang mereka sendiri.
Menggabungkan cabang
Meskipun setiap pengembang bekerja di cabang terpisah sangat bagus untuk produktivitas individu, ia membuka tantangan baru. Pada titik tertentu, setiap cabang pengembang perlu digabungkan ke dalam cabang umum, seperti main. Ketika skala proyek, mungkin ada banyak penggabungan yang perlu terjadi, dan menjadi semakin penting untuk melacak dan meninjau setiap penggabungan. Perlu melacak beberapa perubahan pada proyek adalah tempat permintaan pull masuk.
Apa itu permintaan pull?
Permintaan pull adalah cara untuk mendokumen perubahan cabang dan mengomunikasikan bahwa perubahan dari cabang pengembang siap untuk digabungkan ke cabang dasar (utama). Permintaan pull memungkinkan pemangku kepentingan untuk meninjau dan mendiskusikan perubahan yang diusulkan untuk memastikan bahwa kualitas kode di cabang dasar tetap setingkat mungkin.
Permintaan pull membandingkan perubahan antara dua cabang:
- Cabang perbandingan adalah cabang pengembang sendiri, yang berisi perubahan spesifik yang mereka buat.
- Cabang dasar , juga disebut sebagai cabang utama , adalah cabang tempat perubahan perlu digabungkan.
Saat memulai permintaan pull, GitHub secara otomatis menampilkan tampilan perbandingan cabang.
Membuat permintaan pull
Sekarang mari kita tinjau cara membuat permintaan pull!
Pada
GitHub.com, navigasikan ke halaman utama repositori.Di menu Cabang, pilih cabang yang berisi komit Anda.
Di atas daftar file, di banner kuning, pilih tombol
Bandingkan & buat pull request untuk membuat pull request untuk cabang terkait.Cuplikan layar kotak teks kuning, menyoroti tombol hijau "Compare & Pull Request". Di menu dropdown cabang dasar , pilih cabang yang ingin Anda gabungkan perubahannya. Kemudian pilih menu dropdown bandingkan cabang untuk memilih cabang tempat Anda membuat perubahan.
Masukkan judul dan deskripsi untuk permintaan pull Anda.
Untuk membuat permintaan pull yang siap ditinjau, pilih tombol Buat Permintaan Pull . Untuk membuat draf permintaan tarik, pilih menu dropdown dan pilih Buat Draf Permintaan Tarik, lalu pilih Draf Permintaan Tarik.
Status permintaan pull
Sekarang mari kita tinjau berbagai status permintaan pull.
Draf permintaan pull - Saat membuat permintaan pull, Anda dapat memilih untuk membuat permintaan pull yang siap untuk ditinjau atau draf permintaan pull. Permintaan pull dengan status draf tidak dapat digabungkan, dan pemilik kode tidak secara otomatis diminta untuk meninjau draf permintaan pull.
Buka permintaan pull - Status terbuka berarti permintaan pull aktif dan belum digabungkan ke cabang dasar. Anda masih dapat melakukan penerapan dan mendiskusikan serta meninjau potensi perubahan dengan kolaborator.
Permintaan pull ditutup - Anda dapat memilih untuk menutup permintaan pull tanpa menggabungkannya ke cabang basis/utama. Opsi ini berguna jika perubahan yang diusulkan di cabang tidak lagi diperlukan, atau jika solusi lain diusulkan di cabang lain.
Permintaan penarikan yang digabungkan - Status permintaan penarikan yang digabungkan berarti bahwa pembaruan dan commit dari cabang perbanding dikombinasikan dengan cabang dasar. Siapa pun yang memiliki akses dorong ke repositori dapat menyelesaikan penggabungan.
Menggabungkan permintaan pull
Di bawah nama repositori Anda, pilih Permintaan pull.
Di daftar Permintaan pull , pilih permintaan pull yang ingin Anda gabungkan.
Gulir ke bawah ke bagian bawah permintaan pull. Bergantung pada opsi penggabungan yang diaktifkan untuk repositori Anda, Anda dapat:
Gabungkan semua commit ke cabang dasar dengan memilih tombol Merge pull request. Jika opsi Gabungkan permintaan pull tidak ditampilkan, pilih menu dropdown penggabungan, pilih opsi Buat penerapan penggabungan , lalu pilih tombol Buat penerapan penggabungan .
Squash dan merge memungkinkan Anda untuk mengambil semua commit Anda dan menggabungkannya menjadi satu commit. Opsi ini membantu menjaga riwayat repositori Anda lebih mudah dibaca dan diatur. Pilih opsi Squash dan gabungkan , lalu pilih tombol Squash dan gabungkan .
Opsi Rebase dan gabungkan memungkinkan Anda membuat penerapan tanpa penerapan penggabungan. Ini mempertahankan riwayat proyek linier. Pilih menu dropdown penggabungan, lalu pilih opsi Rebase dan gabungkan , lalu pilih tombol Rebase dan gabungkan .
Jika diminta, masukkan pesan penerapan, atau terima pesan default.
Jika Anda memiliki lebih dari satu alamat email yang terkait dengan akun Anda di
GitHub.com, pilih menu dropdown alamat email dan pilih alamat email yang akan digunakan sebagai alamat email penulis Git. Hanya alamat email terverifikasi yang muncul di menu dropdown ini. Jika Anda mengaktifkan privasi alamat email, email GitHub tanpa balasan digunakan sebagai alamat email pembuat penerapan default.
Pilih Konfirmasi penggabungan, Konfirmasi squash dan gabungkan, atau Konfirmasi rebase dan gabungkan.
Secara opsional, Anda dapat menghapus cabang perbandingan untuk menyimpan daftar cabang di repositori Anda rapi.
Opsi permintaan penarikan tingkat lanjut
Selain membuat dan menggabungkan permintaan pull, ada beberapa opsi canggih yang membantu tim mempertahankan kode berkualitas tinggi.
Meminta peninjau
Anda dapat meminta kolaborator tertentu untuk meninjau permintaan pull Anda. Hanya kolaborator dengan akses tulis ke repositori yang dapat dipilih sebagai peninjau. Ini membantu memastikan perubahan Anda ditinjau oleh orang yang tepat sebelum menggabungkan.
- Saat membuat atau melihat permintaan pull, temukan bagian Peninjau di bilah sisi kanan.
- Cari dan pilih nama pengguna GitHub kolaborator yang memiliki akses tulis ke repositori.
- Peninjau yang dipilih akan menerima pemberitahuan untuk meninjau permintaan pull Anda.
Tinjauan yang diperlukan dan aturan perlindungan cabang
Beberapa repositori menggunakan aturan perlindungan cabang yang memerlukan permintaan pull untuk memenuhi kondisi tertentu sebelum dapat digabungkan. Persyaratan umum meliputi:
- Setidaknya satu ulasan yang menyetujui dari kolaborator lain.
- Melewati semua pemeriksaan status yang diperlukan, seperti alur kerja integrasi berkelanjutan (CI).
Jika permintaan pull tidak memenuhi persyaratan ini, tombol gabungkan akan dinonaktifkan hingga semua kondisi terpenuhi.
Anda dapat melihat aturan yang diperlukan untuk repositori di bagian bawah halaman permintaan pull, di bawah bagian Gabungkan.
Aturan ini biasanya dikonfigurasi oleh administrator repositori dalam pengaturan perlindungan cabang.
Pemeriksaan status dan integrasi berkelanjutan (CI)
Jika repositori Anda menggunakan GitHub Actions atau sistem CI lainnya, permintaan pull dapat secara otomatis menjalankan pemeriksaan status saat perubahan dilakukan. Contohnya meliputi:
- Menjalankan pengujian unit
- Memeriksa pemformatan kode
- Memverifikasi pemindaian keamanan
Permintaan pull biasanya harus melewati semua pemeriksaan status yang diperlukan sebelum dapat digabungkan ke cabang dasar. Pemeriksaan yang gagal ditampilkan langsung di halaman permintaan pull.
Menyimpan Repositori dengan Stars
Ketika Anda menemukan repositori yang ingin Anda kunjungi kembali nanti, Anda dapat membintanginya di GitHub. Membintangi repositori menyimpannya ke daftar favorit pribadi Anda dan menunjukkan apresiasi Anda kepada pengelola repositori.
Untuk membintangi repositori:
- Navigasi ke halaman repositori di
GitHub.com. - Di sudut kanan atas, pilih tombol ⭐ Bintang .
Anda dapat melihat semua repositori yang telah Anda bintangi dengan memilih gambar profil Anda, lalu Bintang Anda.
Pintasan Papan Ketik
GitHub menawarkan banyak pintasan keyboard untuk membantu Anda bergerak lebih cepat melalui pekerjaan Anda.
Untuk melihat semua pintasan yang tersedia:
- Tekan
?di mana saja di GitHub.com.
Anda akan melihat daftar pintasan untuk menavigasi masalah, permintaan pull, repositori, dan lainnya.
Menggunakan Palet Perintah
Palet Perintah di GitHub membantu Anda dengan cepat melompat ke halaman, menjalankan tindakan umum, atau mencari repositori tanpa melepaskan tangan Anda dari keyboard.
Untuk membuka Palet Perintah:
- Tekan
Ctrl+K(Windows/Linux) atau⌘+K(Mac).
Anda dapat mulai mengetik tindakan seperti "Buat permintaan pull," "Lihat masalah," atau "Beralih cabang" untuk langsung pergi ke tempat yang Anda butuhkan.
Terapkan apa yang telah Anda pelajari
Selanjutnya, Anda menyelesaikan latihan yang mengambil apa yang Anda tinjau dan menerapkannya ke contoh kehidupan nyata.