AWS CodeCommit tidak lagi tersedia untuk pelanggan baru. Pelanggan yang sudah ada AWS CodeCommit dapat terus menggunakan layanan seperti biasa. Pelajari lebih lanjut”
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Bekerja dengan permintaan pull di repositori AWS CodeCommit
Permintaan pull adalah cara utama Anda dan pengguna repositori lainnya dapat meninjau, mengomentari, dan menggabungkan perubahan kode dari satu cabang ke cabang lainnya. Anda dapat menggunakan permintaan pull untuk secara kolaboratif meninjau perubahan kode untuk perubahan kecil atau perbaikan, penambahan fitur utama, atau versi baru dari perangkat lunak yang dirilis. Berikut adalah salah satu alur kerja yang mungkin untuk permintaan pull:
Li Juan, developer yang bekerja di repo bernama MyDemoRepo, ingin mengerjakan fitur baru untuk versi produk yang akan datang. Untuk menjaga pekerjaan terpisah dari kode siap produksi, ini menciptakan cabang terpisah dari cabang default dan menamakannya feature-randomizationfeature
. Dia menulis kode, membuat commit, dan mendorong kode fitur baru ke cabang ini. Dia menginginkan pengguna repositori lain untuk meninjau kode untuk kualitas sebelum dia menggabungkan perubahannya ke cabang default. Untuk melakukan ini, dia membuat permintaan pull. Permintaan pull berisi perbandingan antara cabang kerjanya dan cabang kode di mana dia bermaksud untuk menggabungkan perubahannya (dalam hal ini, cabang default). Dia juga dapat membuat aturan persetujuan yang mengharuskan sejumlah pengguna tertentu untuk menyetujui permintaan pull-nya. Dia bahkan bisa menentukan grup persetujuan pengguna. Pengguna lain meninjau kode dan perubahannya, menambahkan komentar dan saran. Dia mungkin memperbarui cabang kerjanya beberapa kali dengan perubahan kode dalam menanggapi komentar. Perubahannya dimasukkan ke dalam permintaan pull setiap kali dia mengirimnya ke cabang di CodeCommit. Dia mungkin juga menggabungkan perubahan yang telah dibuat di cabang tujuan yang dimaksudkan sementara permintaan pull terbuka, sehingga pengguna dapat yakin mereka meninjau semua perubahan yang diusulkan dalam konteks. Ketika dia dan pengulasnya puas, dan kondisi untuk aturan persetujuan (jika ada) telah puas, dia atau salah satu pengulasnya menggabungkan kode dan menutup permintaan pull.
![Membuat permintaan pull](images/codecommit-pull-request-create.png)
Permintaan pull memerlukan dua cabang: cabang sumber yang berisi kode yang ingin Anda tinjau, dan cabang tujuan, di mana Anda menggabungkan kode yang ditinjau. Cabang sumber berisi commit SETELAH, yang merupakan komit yang berisi perubahan yang ingin Anda gabungkan ke cabang tujuan. Cabang tujuan berisi commit SEBELUM, yang mewakili keadaan kode sebelum cabang permintaan pull digabung ke cabang tujuan. Pilihan strategi penggabungan mempengaruhi rincian bagaimana melakukan digabung antara sumber dan cabang tujuan di konsol CodeCommit. Untuk informasi selengkapnya tentang strategi penggabungan di CodeCommit, lihat Menggabungkan permintaan pull (konsol).
![Sumber dan tujuan cabang untuk permintaan pull, menunjukkan hubungan antara commit sebelum dan sesudah](images/codecommit-pull-request-concepts.png)
Permintaan pull menampilkan perbedaan antara ujung cabang sumber dan commit terbaru pada cabang tujuan ketika permintaan pull dibuat, sehingga pengguna dapat melihat dan mengomentari perubahan. Anda dapat memperbarui permintaan pull dalam menanggapi komentar dengan melakukan dan mengirim perubahan ke cabang sumber.
![Menambahkan komentar pada baris dalam permintaan pull.](images/codecommit-pull-request-comment.png)
Ketika kode Anda telah ditinjau, dan persyaratan aturan persetujuan (jika ada) telah terpenuhi, Anda dapat menutup permintaan pull dengan salah satu dari beberapa cara:
-
Menggabungkan cabang-cabang lokal dan mengirim perubahan Anda. Ini menutup permintaan secara otomatisjika strategi penggabungan cepat-maju digunakan dan tidak ada konflik gabungan.
-
Gunakan konsol AWS CodeCommit untuk menutup permintaan pull tanpa penggabungan, menyelesaikan konflik dalam gabungan, atau, jika tidak ada konflik, menutup dan menggabungkan cabang menggunakan salah satu strategi penggabungan yang tersedia.
-
Gunakan AWS CLI.
Sebelum Anda membuat permintaan pull:
-
Pastikan bahwa Anda telah membuat commit dan mengirim perubahan kode yang ingin Anda tinjau ke cabang (sumber cabang).
-
Mengatur pemberitahuan untuk repositori Anda, sehingga pengguna lain dapat diberitahu tentang permintaan pull dan perubahan untuk itu. (Langkah ini memang opsional, tetapi direkomendasikan.)
-
Buat dan kaitkan templat aturan persetujuan dengan repositori Anda, sehingga aturan persetujuan dibuat secara otomatis untuk permintaan pull untuk membantu memastikan kualitas kode. Untuk informasi selengkapnya, lihat Bekerja dengan templat aturan persetujuan.
Permintaan pull lebih efektif ketika Anda telah mengatur pengguna IAM untuk pengguna repositori Anda di akun Amazon Web Services Anda. Lebih mudah untuk mengidentifikasi pengguna mana yang membuat komentar. Keuntungan lainnya adalah bahwa pengguna IAM dapat menggunakan kredensial Git untuk akses repositori. Untuk informasi selengkapnya, lihat Langkah 1: Konfigurasi awal untuk CodeCommit. Anda dapat menggunakan permintaan pull dengan jenis pengguna lainnya, termasuk pengguna akses gabungan.
Untuk informasi tentang bekerja dengan aspek lain dari repositori Anda di CodeCommit, lihat Bekerja dengan repositori, Bekerja dengan templat aturan persetujuan, Bekerja dengan file, Bekerja dengan commit, Bekerja dengan cabang, dan Bekerja dengan preferensi pengguna.
Topik
- Membuat sebuah pull request
- Buat aturan persetujuan untuk permintaan pull
- Tampilkan permintaan pull dalam repositori AWS CodeCommit
- Meninjau permintaan pull
- Memperbarui sebuah permintaan pull
- Mengedit atau menghapus aturan persetujuan untuk permintaan pull
- Menimpa aturan persetujuan pada sebuah permintaan pull
- Menggabungkan permintaan pull dalam repositori AWS CodeCommit
- Menyelesaikan konflik dalam permintaan pull dalam repositori AWS CodeCommit
- Menutup sebuah pull request dalam sebuah repositori AWS CodeCommit