Apa itu permintaan pull?

Selesai

Kita mulai dengan:

  • Meninjau cabang dan kepentingannya untuk menarik permintaan.
  • Menentukan apa itu permintaan pull.
  • Pembelajaran tentang 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.

Agar kedua cabang digabungkan, mereka harus berbeda satu sama lain:

  • 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.

Penggunaan perbandingan yang paling umum adalah membandingkan cabang, seperti saat Anda memulai permintaan pull baru. Anda selalu dibawa ke tampilan perbandingan cabang saat memulai permintaan pull baru.

Membuat permintaan pull

Sekarang mari kita tinjau cara membuat permintaan pull!

  1. Pada GitHub.com, navigasikan ke halaman utama repositori.

  2. Di menu Cabang , pilih cabang yang berisi penerapan Anda.

    Screenshot of creating a new branch and naming it.

  3. Di atas daftar file, di banner kuning, pilih tombol Bandingkan &tarik permintaan untuk membuat permintaan pull untuk cabang terkait.

    Screenshot of a yellow text box, highlighting the green compare and pull request button.

  4. Di menu dropdown cabang dasar, pilih cabang yang ingin Anda gabungkan perubahannya. Kemudian pilih menu dropdown bandingkan cabang untuk memilih cabang topik tempat Anda membuat perubahan.

  5. Masukkan judul dan deskripsi untuk permintaan pull Anda.

  6. Untuk membuat permintaan pull yang siap ditinjau, pilih tombol Buat Permintaan Pull. Untuk membuat permintaan tarik draf, pilih menu dropdown dan pilih Buat Permintaan Tarik Draf, lalu pilih Draf Permintaan Pull.

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 tarik tertutup - Anda dapat memilih untuk menutup permintaan pull tanpa menggabungkannya ke cabang dasar/utama. Opsi ini dapat berguna jika perubahan yang diusulkan di cabang tidak lagi diperlukan, atau jika solusi lain diusulkan di cabang lain.

  • Permintaan pull gabungan - Status permintaan pull gabungan berarti bahwa pembaruan dan penerapan dari cabang perbandingan dikombinasikan dengan cabang dasar. Siapa pun yang memiliki akses dorong ke repositori dapat menyelesaikan penggabungan.

Menggabungkan permintaan pull

  1. Di bawah nama repositori Anda, pilih Permintaan pull.

    Screenshot of the top navigation bar of a repo with the Pull request tab highlighted.

  2. Di daftar Permintaan pull, pilih permintaan pull yang ingin Anda gabungkan.

  3. Gulir ke bawah ke bagian bawah permintaan pull. Bergantung pada opsi penggabungan yang diaktifkan untuk repositori Anda, Anda dapat:

    • Gabungkan semua penerapan ke cabang dasar dengan memilih tombol Gabungkan permintaan pull. Jika opsi Gabungkan permintaan pull tidak ditampilkan, pilih menu dropdown penggabungan, pilih opsi Buat penerapan penggabungan, lalu pilih tombol Buat penerapan penggabungan.

      Screenshot of the dropdown menu of the green merge pull request button with the Create a merge commit selected.

    • Squash dan merge memungkinkan Anda untuk mengambil semua penerapan Anda dan menggabungkannya menjadi satu. Opsi ini dapat membantu Anda 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. Opsi ini memungkinkan Anda melewati penggabungan dengan mempertahankan riwayat proyek linier. Pilih menu dropdown penggabungan, lalu pilih opsi Rebase dan gabungkan , lalu pilih tombol Rebase dan gabungkan .

  4. Jika diminta, masukkan pesan penerapan, atau terima pesan default.

  5. 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, maka email GitHub tanpa balasan adalah alamat email pembuat penerapan default.

    Screenshot of a commit change with a description box and the drop-down menu of the email to select as the author of the commit.

  6. Pilih Konfirmasi penggabungan, Konfirmasi squash dan gabungkan, atau Konfirmasi rebase dan gabungkan.

  7. Secara opsional, Anda dapat menghapus cabang perbandingan untuk menyimpan daftar cabang di repositori Anda rapi.

Selanjutnya, Anda menyelesaikan latihan yang mengambil apa yang Anda tinjau dan menerapkannya ke contoh kehidupan nyata.