Amazon CodeCatalyst tidak lagi terbuka untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Lihat informasi yang lebih lengkap di [Cara bermigrasi dari CodeCatalyst](migration.md).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Meninjau kode dengan permintaan tarik di Amazon CodeCatalyst
Permintaan tarik adalah cara utama Anda dan anggota proyek lainnya dapat meninjau, mengomentari, dan menggabungkan perubahan kode dari satu cabang ke cabang lainnya. Anda dapat menggunakan permintaan tarik untuk meninjau perubahan kode secara kolaboratif untuk perubahan kecil atau perbaikan, penambahan fitur utama, atau versi baru perangkat lunak yang dirilis. Jika Anda menggunakan masalah untuk melacak pekerjaan pada proyek Anda, Anda dapat menautkan masalah tertentu ke permintaan tarik untuk membantu Anda melacak masalah apa yang sedang ditangani oleh perubahan kode dalam permintaan tarik. Saat Anda membuat, memperbarui, mengomentari, menggabungkan, atau menutup permintaan tarik, email secara otomatis dikirim ke pembuat permintaan tarik serta pengulas wajib atau opsional untuk permintaan tarik.
**Tip**
Anda dapat mengonfigurasi peristiwa permintaan tarik apa yang akan Anda terima email sebagai bagian dari profil Anda. Untuk informasi selengkapnya, lihat [Mengirim pemberitahuan Slack dan email dari CodeCatalyst](notifications-manage.md).
Permintaan tarik memerlukan dua cabang dalam repositori sumber: cabang sumber yang berisi kode yang ingin Anda tinjau, dan cabang tujuan, tempat Anda ingin 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.
**catatan**
Saat Anda membuat permintaan tarik, perbedaan yang ditampilkan adalah perbedaan antara ujung cabang sumber dan ujung cabang tujuan. Setelah Anda membuat permintaan tarik, perbedaan yang ditampilkan adalah antara revisi permintaan tarik yang Anda pilih dan komit yang merupakan ujung cabang tujuan saat Anda membuat permintaan tarik. Untuk informasi selengkapnya tentang perbedaan dan penggabungan basis di Git, lihat [git-merge-base](https://git-scm.com/docs/git-merge-base)di dokumentasi Git.
Sementara permintaan tarik dibuat untuk repositori sumber dan cabang tertentu, Anda dapat membuat, melihat, meninjau, dan menutupnya sebagai bagian dari bekerja dengan proyek Anda. Anda tidak perlu melihat repositori sumber untuk melihat dan bekerja dengan permintaan tarik. Status permintaan tarik diatur ke **Buka** saat Anda membuatnya. **Permintaan tarik tetap terbuka hingga Anda menggabungkannya di CodeCatalyst konsol, yang mengubah status menjadi **Gabungan, atau menutupnya, yang mengubah status menjadi Ditutup**.**
Ketika kode Anda telah ditinjau, Anda dapat mengubah status permintaan tarik dengan salah satu dari beberapa cara:
+ Gabungkan permintaan tarik di CodeCatalyst konsol. Kode di cabang sumber permintaan tarik akan digabungkan ke cabang tujuan. Status pull request akan berubah menjadi **Merged**. Tidak dapat diubah kembali ke **Open**.
+ Gabungkan cabang secara lokal dan dorong perubahan Anda, lalu tutup permintaan tarik di CodeCatalyst konsol.
+ Gunakan CodeCatalyst konsol untuk menutup permintaan tarik tanpa menggabungkan. Ini akan mengubah status menjadi **Closed**, dan itu tidak akan menggabungkan kode dari cabang sumber ke cabang tujuan.
Sebelum Anda membuat permintaan pull:
+ Komit dan dorong perubahan kode yang ingin Anda tinjau ke cabang (cabang sumber).
+ Siapkan notifikasi untuk proyek Anda, sehingga pengguna lain dapat diberi tahu tentang alur kerja apa pun yang berjalan saat Anda membuat permintaan tarik. (Langkah ini opsional tetapi disarankan.)
**Topics**
+ [Membuat permintaan pull](pull-requests-create.md)
+ [Melihat permintaan tarik](pull-requests-view.md)
+ [Mengelola persyaratan untuk menggabungkan permintaan tarik dengan aturan persetujuan](source-pull-requests-approval-rules.md)
+ [Meninjau permintaan pull](pull-requests-review.md)
+ [Memperbarui permintaan penarikan](pull-requests-update.md)
+ [Menggabungkan permintaan penarikan](pull-requests-merge.md)
+ [Menutup permintaan tarik](pull-requests-close.md)
# Membuat permintaan pull
Membuat pull request akan membantu pengguna lain melihat dan meninjau perubahan kode Anda sebelum Anda menggabungkan mereka ke cabang lain. Pertama, Anda harus membuat sebuah cabang untuk perubahan kode Anda. Hal ini disebut sebagai cabang sumber untuk sebuah pull request. Setelah Anda melakukan dan mendorong perubahan ke repositori, Anda dapat membuat permintaan tarik yang membandingkan konten cabang sumber dengan konten cabang tujuan.
Anda dapat membuat permintaan tarik di CodeCatalyst konsol Amazon dari cabang tertentu, dari halaman permintaan tarik, atau dari ikhtisar proyek. Membuat permintaan tarik dari cabang tertentu secara otomatis menyediakan nama repositori dan cabang sumber pada halaman pembuatan permintaan tarik. Saat Anda membuat permintaan tarik, Anda akan secara otomatis menerima email tentang pembaruan apa pun pada permintaan tarik, serta saat permintaan tarik digabungkan atau ditutup.
**catatan**
Saat Anda membuat permintaan tarik, perbedaan yang ditampilkan adalah perbedaan antara ujung cabang sumber dan ujung cabang tujuan. Setelah permintaan tarik dibuat, perbedaan yang ditampilkan adalah antara revisi permintaan tarik yang Anda pilih dan komit yang merupakan ujung cabang tujuan saat Anda membuat permintaan tarik. Untuk informasi selengkapnya tentang perbedaan dan penggabungan basis di Git, lihat [git-merge-base](https://git-scm.com/docs/git-merge-base)di dokumentasi Git.
Anda dapat menggunakan fitur **Tulis deskripsi untuk saya** saat membuat permintaan tarik agar Amazon Q secara otomatis membuat deskripsi perubahan yang terkandung dalam permintaan tarik. Saat Anda memilih opsi ini, Amazon Q menganalisis perbedaan antara cabang sumber yang berisi perubahan kode dan cabang tujuan tempat Anda ingin menggabungkan perubahan ini. Ini kemudian menciptakan ringkasan tentang apa perubahan itu, serta interpretasi terbaiknya tentang maksud dan efek dari perubahan tersebut. Fitur ini hanya tersedia di Wilayah Barat AS (Oregon) untuk permintaan CodeCatalyst tarik. Fitur **Write description for me** tidak tersedia untuk permintaan tarik di repositori tertaut.
**catatan**
**Didukung oleh Amazon Bedrock**: AWS mengimplementasikan deteksi [penyalahgunaan otomatis](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html). Karena fitur **Tuliskan deskripsi untuk saya**, **Buat rangkuman konten**, **Rekomendasikan tugas**, **Gunakan Amazon Q untuk membuat atau menambahkan fitur ke proyek**, dan **Tugaskan masalah ke Amazon Q** dengan Amazon Q Developer Agent untuk pengembangan perangkat lunak dibangun di Amazon Bedrock, pengguna dapat memanfaatkan sepenuhnya kontrol yang diterapkan di Amazon Bedrock untuk menegakkan keselamatan, keamanan, dan penggunaan kecerdasan buatan (AI) yang bertanggung jawab.
**Untuk membuat permintaan tarik**
1. Arahkan ke proyek Anda.
1. Lakukan salah satu tindakan berikut:
+ Di panel navigasi, pilih **Kode**, pilih **Tarik permintaan**, lalu pilih **Buat permintaan tarik**.
+ Pada halaman beranda repositori, pilih **Lainnya**, lalu pilih **Buat permintaan tarik**.
+ Pada halaman proyek, pilih **Buat permintaan tarik**.
1. Di **repositori Sumber**, pastikan bahwa repositori sumber yang ditentukan adalah yang berisi kode yang dikomit. Opsi ini hanya muncul jika Anda tidak membuat permintaan tarik dari halaman utama repositori.
1. Di **cabang Tujuan**, pilih cabang untuk menggabungkan kode setelah ditinjau.
1. Di **cabang Source**, pilih cabang yang berisi kode komit.
1. Dalam **judul permintaan tarik**, masukkan judul yang membantu pengguna lain memahami apa yang perlu ditinjau dan alasannya.
1. (Opsional) Dalam **deskripsi permintaan Tarik**, berikan informasi seperti tautan ke masalah atau deskripsi perubahan Anda.
**Tip**
Anda dapat memilih **Tulis deskripsi agar saya** CodeCatalyst secara otomatis menghasilkan deskripsi tentang perubahan yang terkandung dalam permintaan tarik. Anda dapat membuat perubahan pada deskripsi yang dibuat secara otomatis setelah Anda menambahkannya ke permintaan tarik.
Fungsionalitas ini mengharuskan fitur AI generatif diaktifkan untuk ruang dan tidak tersedia untuk permintaan tarik di repositori tertaut. Untuk informasi selengkapnya, lihat [Mengelola fitur AI generatif](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html).
1. (Opsional) Dalam **Masalah**, pilih **Masalah tautan**, lalu pilih masalah dari daftar atau masukkan ID-nya. Untuk memutuskan tautan masalah, pilih ikon batalkan tautan.
1. (Opsional) Di **Reviewer yang diperlukan**, pilih **Tambahkan pengulas yang diperlukan**. Pilih dari daftar anggota proyek untuk menambahkannya. Pengulas yang diperlukan harus menyetujui perubahan sebelum permintaan tarik dapat digabungkan ke cabang tujuan.
**catatan**
Anda tidak dapat menambahkan pengulas sebagai pengulas yang diperlukan dan pengulas opsional. Anda tidak dapat menambahkan diri Anda sebagai reviewer.
1. (Opsional) Di **pengulas opsional, pilih Tambahkan pengulas** **opsional**. Pilih dari daftar anggota proyek untuk menambahkannya. Peninjau opsional tidak harus menyetujui perubahan sebagai persyaratan sebelum permintaan tarik dapat digabungkan ke cabang tujuan.
1. Tinjau perbedaan antara cabang. Perbedaan yang ditampilkan dalam permintaan tarik adalah perubahan antara revisi di cabang sumber dan basis gabungan, yang merupakan komit kepala cabang tujuan pada saat permintaan tarik dibuat. Jika tidak ada perubahan yang ditampilkan, cabang mungkin identik, atau Anda mungkin telah memilih cabang yang sama untuk sumber dan tujuan.
1. Ketika Anda puas bahwa permintaan tarik berisi kode dan perubahan yang ingin Anda tinjau, pilih **Buat**.
**catatan**
Setelah Anda membuat permintaan tarik, Anda dapat menambahkan komentar. Komentar dapat ditambahkan ke permintaan tarik atau ke baris individual dalam file serta permintaan tarik keseluruhan. Anda dapat menambahkan tautan ke sumber daya, seperti file, dengan menggunakan tanda @ diikuti dengan nama file.
**Untuk membuat permintaan tarik dari cabang**
1. Arahkan ke proyek tempat Anda ingin membuat permintaan tarik.
1. Di panel navigasi, pilih **repositori Sumber, lalu pilih repositori** yang berisi cabang tempat Anda memiliki perubahan kode untuk ditinjau.
1. Pilih panah tarik-turun di sebelah nama cabang default, lalu pilih cabang yang Anda inginkan dari daftar. Untuk melihat semua cabang untuk repositori, pilih **Lihat** semua.
1. Pilih **Lainnya**, lalu pilih **Buat permintaan tarik**.
1. Repositori dan cabang sumber telah dipilih sebelumnya untuk Anda. Di **cabang Tujuan**, pilih cabang tempat Anda akan menggabungkan kode setelah ditinjau. Dalam **judul permintaan Tarik**, masukkan judul yang akan membantu pengguna proyek lain memahami apa yang harus ditinjau dan alasannya. Secara opsional, berikan informasi lebih lanjut dalam **deskripsi permintaan Tarik**, seperti menempelkan tautan ke masalah terkait CodeCatalyst, atau menambahkan deskripsi perubahan yang Anda buat.
**catatan**
Alur kerja yang dikonfigurasi untuk menjalankan acara pembuatan permintaan tarik akan berjalan setelah permintaan tarik dibuat, jika cabang tujuan untuk permintaan tarik cocok dengan salah satu cabang yang ditentukan dalam alur kerja.
1. Tinjau perbedaan antara cabang. Jika tidak ada perubahan yang ditampilkan, cabang mungkin identik, atau Anda mungkin telah memilih cabang yang sama untuk sumber dan tujuan.
1. (Opsional) Dalam **Masalah**, pilih **Masalah tautan**, lalu pilih masalah dari daftar atau masukkan ID-nya. Untuk memutuskan tautan masalah, pilih ikon batalkan tautan.
1. (Opsional) Di **Reviewer yang diperlukan**, pilih **Tambahkan pengulas yang diperlukan**. Pilih dari daftar anggota proyek untuk menambahkannya. Pengulas yang diperlukan harus menyetujui perubahan sebelum permintaan tarik dapat digabungkan ke cabang tujuan.
**catatan**
Anda tidak dapat menambahkan pengulas sebagai wajib dan opsional. Anda tidak dapat menambahkan diri Anda sebagai reviewer.
1. (Opsional) Di **pengulas opsional, pilih Tambahkan pengulas** **opsional**. Pilih dari daftar anggota proyek untuk menambahkannya. Peninjau opsional tidak harus menyetujui perubahan sebelum permintaan tarik dapat digabungkan ke cabang tujuan.
1. Jika Anda puas bahwa permintaan tarik berisi perubahan yang ingin Anda tinjau dan menyertakan pengulas yang diperlukan, pilih **Buat**.
Jika Anda memiliki alur kerja yang dikonfigurasi untuk menjalankan di mana cabang cocok dengan cabang tujuan dalam permintaan tarik, Anda akan melihat informasi tentang alur kerja tersebut berjalan di **Ikhtisar** di area **detail permintaan tarik** setelah permintaan tarik dibuat. Lihat informasi yang lebih lengkap di [Menambahkan pemicu ke alur kerja](workflows-add-trigger-add.md).
# Melihat permintaan tarik
Anda dapat melihat permintaan tarik untuk proyek di CodeCatalyst konsol Amazon. Halaman ringkasan proyek menampilkan semua permintaan tarik terbuka untuk sebuah proyek. Untuk melihat semua permintaan tarik terlepas dari statusnya, navigasikan ke halaman permintaan tarik untuk proyek Anda. Saat melihat permintaan tarik, Anda dapat memilih untuk memiliki ringkasan dari semua komentar yang tersisa pada perubahan permintaan tarik yang dibuat untuk Anda.
**catatan**
**Didukung oleh Amazon Bedrock**: AWS mengimplementasikan deteksi [penyalahgunaan otomatis](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html). Karena fitur **Tuliskan deskripsi untuk saya**, **Buat rangkuman konten**, **Rekomendasikan tugas**, **Gunakan Amazon Q untuk membuat atau menambahkan fitur ke proyek**, dan **Tugaskan masalah ke Amazon Q** dengan Amazon Q Developer Agent untuk pengembangan perangkat lunak dibangun di Amazon Bedrock, pengguna dapat memanfaatkan sepenuhnya kontrol yang diterapkan di Amazon Bedrock untuk menegakkan keselamatan, keamanan, dan penggunaan kecerdasan buatan (AI) yang bertanggung jawab.
**Untuk melihat permintaan tarik terbuka**
1. Arahkan ke proyek tempat Anda ingin melihat permintaan tarik.
1. Pada halaman proyek, permintaan tarik terbuka ditampilkan, termasuk informasi tentang siapa yang membuat permintaan tarik, repositori apa yang berisi cabang untuk permintaan tarik, dan tanggal permintaan tarik dibuat. Anda dapat memfilter tampilan permintaan tarik terbuka berdasarkan repositori sumber.
1. Untuk melihat semua permintaan tarik, pilih **Lihat semua**. Anda dapat menggunakan penyeleksi untuk memilih di antara opsi. Misalnya, untuk melihat semua permintaan tarik, pilih **Status apa pun** dan **Penulis apa pun**.
Atau, di panel navigasi, pilih **Kode**, lalu pilih **Tarik permintaan**, lalu gunakan pemilih untuk mempersempit tampilan Anda.
1. Pada halaman **Permintaan tarik**, Anda dapat mengurutkan permintaan tarik berdasarkan ID, judul, status, dan lainnya. Untuk menyesuaikan informasi apa dan berapa banyak informasi yang ditampilkan di halaman permintaan tarik, pilih ikon roda gigi.
1. Untuk melihat permintaan tarik tertentu, pilih dari daftar.
1. Untuk melihat status alur kerja yang terkait dengan permintaan tarik ini, jika ada, pilih **Ikhtisar** dan tinjau informasi di area **detail permintaan tarik pada permintaan tarik** di bawah **Alur kerja** berjalan.
Proses alur kerja akan terjadi jika alur kerja dikonfigurasi dengan peristiwa pembuatan atau revisi permintaan tarik, dan jika persyaratan cabang tujuan dalam alur kerja cocok dengan cabang tujuan yang ditentukan dalam permintaan tarik. Untuk informasi selengkapnya, lihat [Menambahkan pemicu ke alur kerja](workflows-add-trigger-add.md).
1. Untuk melihat masalah terkait, jika ada, pilih **Ikhtisar** dan tinjau informasi di **detail permintaan Tarik** di bawah **Masalah**. Jika Anda ingin melihat masalah tertaut, pilih ID-nya dari daftar.
1. (Opsional) Untuk membuat ringkasan komentar yang tersisa pada perubahan kode dalam revisi permintaan tarik, pilih **Buat ringkasan konten**. Ringkasan tidak akan menyertakan komentar yang tersisa pada permintaan tarik keseluruhan.
**catatan**
Fungsionalitas ini mengharuskan fitur AI generatif diaktifkan untuk ruang tersebut, tidak tersedia untuk repositori tertaut, dan hanya tersedia di Wilayah AS Barat (Oregon). Untuk informasi selengkapnya, lihat [Mengelola fitur AI generatif](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html).
1. Untuk melihat perubahan kode dalam permintaan tarik, pilih **Perubahan**. Anda dapat dengan cepat melihat berapa banyak file yang memiliki perubahan dalam permintaan tarik, dan file apa dalam permintaan tarik memiliki komentar pada mereka, di **File diubah**. Jumlah komentar yang ditampilkan di sebelah folder menunjukkan jumlah komentar pada file di folder itu. Perluas folder untuk melihat jumlah komentar untuk setiap file di folder. Anda juga dapat melihat komentar yang tersisa pada baris kode tertentu.
**catatan**
Tidak semua perubahan dalam permintaan tarik dapat ditampilkan di konsol. Misalnya, Anda tidak dapat melihat submodul Git di konsol, sehingga Anda tidak dapat melihat perbedaan dalam submodul dalam permintaan tarik. Beberapa perbedaan mungkin terlalu besar untuk ditampilkan. Untuk informasi selengkapnya, lihat [Kuota untuk repositori sumber di CodeCatalyst](source-quotas.md) dan [Melihat fileMelihat riwayat perubahan pada file](source-files-view.md).
1. Untuk melihat laporan kualitas permintaan tarik ini, pilih **Laporan**.
**catatan**
Alur kerja harus dikonfigurasi untuk menghasilkan laporan agar laporan tersebut muncul dalam permintaan tarik Anda. Lihat informasi yang lebih lengkap di [Pengujian dengan alur kerjaPengujian dengan alur kerja](test-workflow-actions.md).
# Mengelola persyaratan untuk menggabungkan permintaan tarik dengan aturan persetujuan
Saat membuat permintaan tarik, Anda dapat memilih untuk menambahkan pengulas wajib atau opsional ke permintaan tarik individual tersebut. Namun, Anda juga dapat membuat persyaratan yang harus dipenuhi oleh semua permintaan tarik saat menggabungkan ke cabang tujuan tertentu. Persyaratan ini disebut aturan persetujuan. Aturan persetujuan dikonfigurasi untuk cabang di repositori. Saat Anda membuat permintaan tarik yang cabang tujuannya memiliki aturan persetujuan yang dikonfigurasi untuknya, persyaratan untuk aturan tersebut harus dipenuhi selain persetujuan dari pengulas yang diperlukan sebelum Anda dapat menggabungkan permintaan tarik ke cabang tersebut. Membuat aturan persetujuan dapat membantu Anda mempertahankan standar kualitas untuk penggabungan ke cabang seperti cabang default Anda.
Aturan persetujuan yang diterapkan ke cabang default repositori sumber Anda akan berperilaku sedikit berbeda dari aturan persetujuan yang diterapkan ke cabang lain. Aturan apa pun yang diterapkan ke cabang default akan diterapkan secara otomatis ke cabang mana pun yang Anda tentukan sebagai cabang default. Cabang yang sebelumnya ditetapkan sebagai cabang default akan tetap mempertahankan aturan yang diterapkan padanya.
Ketika Anda membuat aturan persetujuan, Anda harus mempertimbangkan bagaimana aturan itu akan dipenuhi oleh pengguna proyek Anda baik di masa sekarang maupun di masa depan. Misalnya, jika Anda memiliki enam pengguna dalam proyek Anda, dan Anda membuat aturan persetujuan yang memerlukan lima persetujuan sebelum dapat digabungkan ke cabang tujuan, Anda telah secara efektif membuat aturan yang mengharuskan semua orang kecuali orang yang membuat permintaan tarik untuk menyetujui permintaan tarik tersebut sebelum dapat digabungkan.
**catatan**
Anda harus memiliki peran administrator Proyek untuk membuat dan mengelola aturan persetujuan dalam CodeCatalyst proyek. Anda tidak dapat membuat aturan persetujuan untuk repositori tertaut.
Anda tidak dapat menghapus aturan persetujuan, tetapi Anda dapat memperbaruinya agar tidak memerlukan persetujuan, yang secara efektif menghapus aturan tersebut.
**Untuk melihat dan mengedit aturan persetujuan untuk cabang tujuan untuk permintaan tarik**
1. Arahkan ke proyek tempat repositori Anda berada.
1. Pilih nama repositori dari daftar repositori sumber untuk proyek. Atau, di panel navigasi, pilih **Kode**, lalu pilih **Repositori sumber**.
Pilih repositori tempat Anda ingin melihat aturan persetujuan.
1. **Pada halaman ikhtisar repositori, pilih Cabang.**
1. Di kolom **Aturan persetujuan**, pilih **Lihat** untuk melihat status aturan apa pun untuk setiap cabang repositori.
Dalam **jumlah minimum persetujuan**, jumlah tersebut sesuai dengan jumlah persetujuan yang diperlukan sebelum permintaan tarik dapat digabungkan ke cabang tersebut.
1. Untuk membuat atau mengubah aturan persetujuan, pilih **Kelola pengaturan**. **Pada halaman pengaturan untuk repositori sumber, dalam **aturan Persetujuan**, pilih Edit.**
**catatan**
Anda harus memiliki peran **administrator Project** untuk mengedit aturan persetujuan.
1. Di **Cabang**, pilih nama cabang yang ingin Anda konfigurasikan aturan persetujuan dari daftar drop-down. Dalam **Jumlah persetujuan minimum**, masukkan nomor, lalu pilih **Simpan**.
# Meninjau permintaan pull
Anda dapat menggunakan CodeCatalyst konsol Amazon untuk meninjau dan mengomentari perubahan yang disertakan dalam permintaan tarik secara kolaboratif. Anda dapat menambahkan komentar ke baris kode individual dalam perbedaan antara cabang sumber dan tujuan, atau perbedaan antara revisi permintaan tarik. Anda dapat memilih untuk membuat ringkasan komentar yang tersisa pada perubahan kode dalam permintaan tarik untuk membantu Anda dengan cepat memahami umpan balik yang ditinggalkan oleh pengguna lain. Anda juga dapat memilih untuk membuat Lingkungan Dev untuk bekerja pada kode.
**catatan**
**Didukung oleh Amazon Bedrock**: AWS mengimplementasikan deteksi [penyalahgunaan otomatis](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html). Karena fitur **Tuliskan deskripsi untuk saya**, **Buat rangkuman konten**, **Rekomendasikan tugas**, **Gunakan Amazon Q untuk membuat atau menambahkan fitur ke proyek**, dan **Tugaskan masalah ke Amazon Q** dengan Amazon Q Developer Agent untuk pengembangan perangkat lunak dibangun di Amazon Bedrock, pengguna dapat memanfaatkan sepenuhnya kontrol yang diterapkan di Amazon Bedrock untuk menegakkan keselamatan, keamanan, dan penggunaan kecerdasan buatan (AI) yang bertanggung jawab.
**Tip**
Anda dapat mengonfigurasi peristiwa permintaan tarik apa yang akan Anda terima email sebagai bagian dari profil Anda. Untuk informasi selengkapnya, lihat [Mengirim pemberitahuan Slack dan email dari CodeCatalyst](notifications-manage.md).
Permintaan tarik menunjukkan perbedaan antara revisi permintaan tarik dan komit yang merupakan ujung cabang tujuan saat Anda membuat permintaan tarik. Ini disebut basis penggabungan. Untuk informasi selengkapnya tentang perbedaan dan penggabungan basis di Git, lihat [git-merge-base](https://git-scm.com/docs/git-merge-base)di dokumentasi Git.
**Tip**
Saat bekerja di konsol, terutama jika Anda memiliki permintaan tarik terbuka untuk sementara waktu, pertimbangkan untuk menyegarkan browser Anda untuk memastikan Anda memiliki revisi terbaru yang tersedia untuk permintaan tarik sebelum Anda mulai memeriksanya.
**Untuk meninjau permintaan tarik di CodeCatalyst konsol**
1. Arahkan ke proyek Anda.
1. Arahkan ke pull request dengan melakukan salah satu hal berikut:
+ Jika permintaan tarik tercantum di halaman proyek, pilih dari daftar.
+ Jika permintaan tarik tidak tercantum di halaman proyek, pilih **Lihat semua**. Gunakan filter dan urutkan untuk menemukan permintaan tarik, lalu pilih dari daftar.
+ Di panel navigasi, pilih **Kode**, lalu pilih **Tarik permintaan**.
1. Pilih permintaan tarik yang ingin Anda tinjau dari daftar. Anda dapat memfilter daftar permintaan tarik dengan mengetikkan bagian dari namanya di bilah filter.
1. Dalam **Ikhtisar**, Anda dapat meninjau nama dan judul permintaan tarik. Anda dapat membuat dan melihat komentar yang tersisa pada permintaan tarik itu sendiri. Anda juga dapat melihat detail permintaan tarik, termasuk informasi tentang alur kerja yang berjalan, masalah terkait, pengulas, pembuat permintaan tarik, dan strategi penggabungan yang layak.
**catatan**
Komentar yang tersisa pada baris kode tertentu muncul di **Perubahan**.
1. (Opsional) Untuk menambahkan komentar yang berlaku untuk seluruh permintaan tarik, perluas **Komentar pada permintaan tarik**, lalu pilih **Buat komentar**.
1. (Opsional) Untuk melihat ringkasan semua komentar yang tersisa pada perubahan revisi permintaan tarik ini, pilih **Buat ringkasan komentar**.
**catatan**
Fungsionalitas ini mengharuskan fitur AI generatif diaktifkan untuk ruang dan hanya tersedia di Wilayah AS Barat (Oregon). Untuk informasi selengkapnya, lihat [Mengelola fitur AI generatif](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html).
1. Di **Perubahan**, Anda dapat melihat perbedaan antara cabang tujuan dan revisi terbaru dari permintaan tarik. Jika ada lebih dari satu revisi, Anda dapat mengubah revisi apa yang dibandingkan dalam perbedaan di antara mereka. Untuk informasi lebih lanjut tentang revisi, lihat[Revisi](source-concepts.md#revision-concept).
**Tip**
Anda dapat dengan cepat melihat berapa banyak file yang memiliki perubahan dalam permintaan tarik, dan file apa dalam permintaan tarik memiliki komentar pada mereka, di **File diubah**. Jumlah komentar yang ditampilkan di sebelah folder menunjukkan jumlah komentar pada file di folder itu. Perluas folder untuk melihat jumlah komentar untuk setiap file di folder.
1. Untuk mengubah cara perbedaan ditampilkan, pilih antara **Unified** dan **Split**.
1. Untuk menambahkan komentar ke baris dalam permintaan tarik, buka baris yang ingin Anda komentari. Pilih ikon komentar yang muncul untuk baris itu, masukkan komentar, lalu pilih **Simpan**.
1. Untuk melihat perubahan antara revisi dalam permintaan tarik, atau antara cabang sumber dan tujuan, pilih dari opsi yang tersedia di **Membandingkan**. Komentar pada baris dalam revisi dipertahankan dalam revisi tersebut.
1. Jika Anda telah mengonfigurasi alur kerja untuk menghasilkan laporan cakupan kode pada pemicu permintaan tarik, Anda dapat melihat temuan cakupan baris dan cabang dalam permintaan tarik yang relevan. Untuk menyembunyikan temuan cakupan kode, pilih **Sembunyikan cakupan kode**. Untuk informasi selengkapnya, lihat [Laporan cakupan kode](test-workflow-actions.md#test-code-coverage-reports).
1. Jika Anda ingin membuat perubahan kode pada permintaan tarik, Anda dapat membuat Lingkungan Dev dari permintaan tarik. Pilih **Buat Lingkungan Pengembang**. **Secara opsional tambahkan nama untuk Lingkungan Dev atau edit konfigurasinya dan kemudian pilih Buat.**
1. Di **Laporan**, Anda dapat melihat laporan kualitas dalam permintaan tarik ini. Jika ada lebih dari satu revisi, Anda dapat mengubah revisi apa yang dibandingkan dalam perbedaan di antara mereka. Anda dapat memfilter laporan berdasarkan nama, status, alur kerja, tindakan, dan jenis.
**catatan**
Alur kerja harus dikonfigurasi untuk menghasilkan laporan agar laporan tersebut muncul dalam permintaan tarik Anda. Untuk informasi selengkapnya, lihat [Mengkonfigurasi laporan kualitas dalam suatu tindakan](test-config-action.md).
1. Untuk melihat laporan tertentu, pilih dari daftar. Untuk informasi selengkapnya, lihat [Pengujian dengan alur kerjaPengujian dengan alur kerja](test-workflow-actions.md).
1. **Jika Anda terdaftar sebagai peninjau permintaan tarik ini dan ingin menyetujui perubahan, pastikan Anda melihat revisi terbaru, lalu pilih Menyetujui.**
**catatan**
Semua pengulas yang diperlukan harus menyetujui permintaan tarik sebelum dapat digabungkan.
# Memperbarui permintaan penarikan
Anda dapat mempermudah anggota proyek lain untuk meninjau kode dengan memperbarui permintaan tarik. Anda dapat memperbarui permintaan tarik untuk mengubah pengulasnya, tautannya ke masalah, judul permintaan tarik, atau deskripsinya. Misalnya, Anda mungkin ingin mengubah pengulas yang diperlukan untuk permintaan tarik untuk menghapus seseorang yang pergi berlibur, dan menambahkan orang lain. Anda juga dapat memperbarui permintaan tarik dengan perubahan kode lebih lanjut dengan mendorong komit ke cabang sumber permintaan tarik terbuka. Setiap push ke cabang sumber permintaan tarik di repositori CodeCatalyst sumber membuat revisi. Anggota proyek dapat melihat perbedaan antara revisi dalam permintaan tarik.
**Untuk memperbarui pengulas untuk permintaan tarik**
1. Arahkan ke proyek tempat Anda ingin memperbarui pengulas permintaan tarik.
1. Pada halaman proyek, di bawah **Buka permintaan tarik**, pilih permintaan tarik tempat Anda ingin memperbarui pengulas. Atau, di panel navigasi, pilih **Kode**, pilih **Permintaan tarik**, lalu pilih permintaan tarik yang ingin Anda perbarui.
1. (Opsional) Di **Ikhtisar**, di area **rincian permintaan tarik**, pilih tanda tambah untuk menambahkan pengulas wajib atau opsional. Pilih **X** di sebelah reviewer untuk menghapusnya sebagai peninjau opsional atau wajib.
1. (Opsional) Di **Ringkasan**, di area **Detail permintaan tarik**, pilih **Masalah tautan** untuk menautkan masalah ke permintaan tarik, lalu pilih masalah dari daftar atau masukkan ID-nya. Untuk memutuskan tautan masalah, pilih ikon batalkan tautan di sebelah masalah yang ingin Anda putuskan tautannya.
**Untuk memperbarui file dan kode di cabang sumber permintaan tarik**
1. Untuk memperbarui beberapa file, [buat Lingkungan Dev](devenvironment-create.md), atau kloning repositori dan cabang sumbernya dan gunakan klien Git atau lingkungan pengembangan terintegrasi (IDE) untuk membuat perubahan pada file di cabang sumber. Komit dan dorong perubahan ke cabang sumber di repositori CodeCatalyst sumber untuk memperbarui permintaan tarik secara otomatis dengan perubahan. Untuk informasi selengkapnya, lihat [Mengkloning repositori sumber](source-repositories-clone.md) dan [Memahami perubahan kode sumber dengan komit di Amazon CodeCatalyst](source-commits.md).
1. Untuk memperbarui file individual di cabang sumber, Anda dapat menggunakan klien Git atau IDE seperti yang Anda lakukan untuk beberapa file. Anda juga dapat mengeditnya langsung di CodeCatalyst konsol. Untuk informasi selengkapnya, lihat [Mengedit file](source-files-edit.md).
**Untuk memperbarui judul dan deskripsi permintaan tarik**
1. Arahkan ke proyek tempat Anda ingin memperbarui judul atau deskripsi permintaan tarik.
1. Halaman proyek menampilkan permintaan tarik terbuka, termasuk informasi tentang siapa yang membuat permintaan tarik, repositori apa yang berisi cabang untuk permintaan tarik, dan kapan permintaan tarik dibuat. Anda dapat memfilter tampilan permintaan tarik terbuka berdasarkan repositori sumber. Pilih permintaan tarik yang ingin Anda ubah dari daftar.
1. Untuk melihat semua permintaan tarik, pilih **Lihat semua**. Atau, di panel navigasi, pilih **Kode**, lalu pilih **Tarik permintaan**. Gunakan kotak filter atau fungsi sortir untuk menemukan permintaan tarik yang ingin Anda ubah, lalu pilih.
1. Di **Ikhtisar**, pilih **Edit**.
1. Ubah judul atau deskripsi, lalu pilih **Simpan**.
# Menggabungkan permintaan penarikan
Setelah kode Anda ditinjau dan semua pengulas yang diperlukan telah menyetujuinya, Anda dapat menggabungkan permintaan tarik di CodeCatalyst konsol menggunakan strategi penggabungan yang didukung, seperti fast-forward. Tidak semua strategi gabungan yang didukung di CodeCatalyst konsol tersedia sebagai pilihan untuk semua permintaan tarik. CodeCatalyst mengevaluasi penggabungan dan hanya memungkinkan Anda memilih antara strategi gabungan yang tersedia di konsol dan mampu menggabungkan cabang sumber ke cabang tujuan. Anda juga dapat menggabungkan permintaan tarik dengan strategi gabungan Git pilihan Anda dengan menjalankan **git merge** perintah di komputer lokal Anda atau Lingkungan Pengembang untuk menggabungkan cabang sumber ke cabang tujuan. Anda kemudian dapat mendorong perubahan tersebut di cabang tujuan ke repositori sumber di. CodeCatalyst
**catatan**
Menggabungkan cabang dan mendorong perubahan di Git tidak secara otomatis menutup permintaan tarik.
Jika Anda memiliki peran administrator Project, Anda juga dapat memilih untuk menggabungkan permintaan tarik yang belum memenuhi semua persyaratan untuk persetujuan dan aturan persetujuan.
## Menggabungkan permintaan tarik (konsol)
Anda dapat menggabungkan permintaan tarik di CodeCatalyst konsol jika tidak ada konflik gabungan antara cabang sumber dan tujuan dan jika semua pengulas yang diperlukan telah menyetujui permintaan tarik. Jika ada konflik, atau jika penggabungan tidak dapat diselesaikan, tombol gabungan tidak aktif, dan label **Tidak dapat digabungkan ditampilkan.** Dalam hal ini, Anda harus mendapatkan persetujuan dari pemberi persetujuan yang diperlukan, menyelesaikan konflik secara lokal jika perlu, dan mendorong perubahan tersebut sebelum Anda dapat bergabung. Menggabungkan permintaan tarik akan secara otomatis mengirim email ke pembuat permintaan tarik serta pengulas yang diperlukan atau opsional. Ini tidak akan secara otomatis menutup atau mengubah status masalah apa pun yang terkait dengan permintaan tarik.
**Tip**
Anda dapat mengonfigurasi peristiwa permintaan tarik apa yang akan Anda terima email sebagai bagian dari profil Anda. Untuk informasi selengkapnya, lihat [Mengirim pemberitahuan Slack dan email dari CodeCatalyst](notifications-manage.md).
**Untuk menggabungkan permintaan tarik**
1. Arahkan ke proyek tempat Anda ingin menggabungkan permintaan tarik.
1. Pada halaman proyek, di bawah **Buka permintaan tarik**, pilih permintaan tarik yang ingin Anda gabungkan. Jika Anda tidak melihat permintaan tarik, pilih **Lihat semua permintaan tarik** dan kemudian pilih dari daftar. Atau, di panel navigasi, pilih **Kode**, pilih **Permintaan tarik**, lalu pilih permintaan tarik yang ingin Anda gabungkan. Pilih **Gabungkan**.
1. Pilih dari strategi penggabungan yang tersedia untuk permintaan tarik. **Secara opsional, pilih atau batalkan pilihan untuk menghapus cabang sumber setelah menggabungkan permintaan tarik, lalu pilih Gabung.**
**catatan**
Jika tombol **Gabung** tidak aktif, atau Anda melihat label **Tidak dapat digabungkan**, pengulas wajib belum menyetujui permintaan tarik, atau permintaan tarik tidak dapat digabungkan di konsol. CodeCatalyst Peninjau yang belum menyetujui permintaan tarik ditunjukkan oleh ikon jam di area **Detail permintaan tarik** di **Ikhtisar**. Jika semua pengulas yang diperlukan telah menyetujui permintaan tarik tetapi tombol **Gabung** masih tidak aktif, Anda mungkin memiliki konflik gabungan. Pilih label yang digarisbawahi **Tidak dapat digabungkan** untuk melihat detail selengkapnya tentang mengapa permintaan tarik tidak dapat digabungkan. Anda dapat menyelesaikan konflik gabungan untuk cabang tujuan di Lingkungan Pengembang atau CodeCatalyst konsol lalu menggabungkan permintaan tarik, atau Anda dapat menyelesaikan konflik dan menggabungkan secara lokal, lalu mendorong komit yang berisi penggabungan ke cabang sumber. CodeCatalyst Untuk informasi selengkapnya, lihat [Menggabungkan permintaan tarik (Git)](#pull-requests-merge-git) dan dokumentasi Git Anda.
## Ganti persyaratan penggabungan
Jika Anda memiliki peran **administrator Project**, Anda dapat memilih untuk menggabungkan permintaan tarik yang belum memenuhi semua persyaratan untuk persetujuan dan aturan persetujuan yang diperlukan. Ini disebut sebagai mengesampingkan persyaratan untuk permintaan tarik. Anda dapat memilih untuk melakukan ini jika peninjau yang diperlukan tidak tersedia, atau jika kebutuhan mendesak muncul untuk menggabungkan permintaan tarik tertentu ke cabang yang memiliki aturan persetujuan yang tidak dapat dipenuhi dengan cepat.
**Untuk menggabungkan permintaan tarik**
1. **Dalam permintaan tarik tempat Anda ingin mengganti persyaratan dan menggabungkan, pilih panah tarik-turun di sebelah tombol Gabung.** Pilih **Ganti persyaratan persetujuan**.
1. Dalam **alasan Override**, berikan detail mengapa Anda menggabungkan permintaan tarik ini tanpa memenuhi aturan persetujuan dan persyaratan pengulas yang diperlukan. Meskipun ini opsional, ini sangat disarankan.
1. Secara opsional pilih strategi gabungan, atau terima default. Anda juga dapat memilih untuk memperbarui pesan komit yang dibuat secara otomatis dengan detail selengkapnya.
1. Pilih atau batal pilihan untuk menghapus cabang sumber saat bergabung. Kami menyarankan Anda mempertahankan cabang sumber saat mengganti persyaratan untuk menggabungkan permintaan tarik hingga Anda memiliki kesempatan untuk meninjau keputusan dengan anggota tim lainnya.
1. Pilih **Gabungkan**.
## Menggabungkan permintaan tarik (Git)
Git mendukung banyak opsi untuk menggabungkan dan mengelola cabang. Perintah berikut adalah beberapa opsi yang dapat Anda gunakan. Untuk informasi selengkapnya, lihat dokumentasi yang tersedia di [situs web Git](https://git-scm.com/doc). Setelah Anda menggabungkan dan mendorong perubahan Anda, tutup permintaan tarik secara manual. Untuk informasi selengkapnya, lihat [Menutup permintaan tarik](pull-requests-close.md).
**Perintah Git umum untuk menggabungkan cabang**
| | |
| --- |--- |
| Menggabungkan perubahan dari cabang sumber di repo lokal ke cabang tujuan di repo lokal. | `git checkout destination-branch-name` `git merge source-branch-name` |
| Menggabungkan cabang sumber ke cabang tujuan, menentukan penggabungan maju cepat. Ini menggabungkan cabang dan memindahkan pointer cabang tujuan ke ujung cabang sumber. | `git checkout destination-branch-name` `git merge --ff-only source-branch-name` |
| Menggabungkan cabang sumber ke cabang tujuan, menentukan gabungan squash. Ini menggabungkan semua komit dari cabang sumber menjadi komit gabungan tunggal di cabang tujuan. | `git checkout destination-branch-name` `git merge --squash source-branch-name` |
| Menggabungkan cabang sumber ke cabang tujuan, menentukan penggabungan tiga arah. Ini membuat komit gabungan dan menambahkan komit individu dari cabang sumber ke cabang tujuan. | `git checkout destination-branch-name` `git merge --no-ff source-branch-name` |
| Menghapus cabang sumber di repo lokal. Ini berguna untuk dilakukan sebagai pembersihan untuk repo lokal Anda setelah bergabung ke cabang tujuan dan mendorong perubahan ke repositori sumber. | `git branch -d source-branch-name` |
| Menghapus cabang sumber di repositori jarak jauh (repositori sumber di CodeCatalyst) menggunakan nama panggilan yang ditentukan repo lokal untuk repositori jarak jauh. (Perhatikan penggunaan titik dua (`:`).) Atau, tentukan `--delete` sebagai bagian dari perintah. | `git push remote-name :source-branch-name` `git push remote-name --delete source-branch-name` |
# Menutup permintaan tarik
Anda dapat menandai permintaan tarik sebagai **Ditutup**. Ini tidak menggabungkan permintaan tarik, tetapi dapat membantu Anda menentukan permintaan tarik mana yang memerlukan tindakan dan permintaan tarik mana yang tidak lagi relevan. Sebaiknya tutup permintaan tarik jika Anda tidak lagi berencana untuk menggabungkan perubahan tersebut, atau jika perubahan tersebut digabungkan dengan permintaan tarik lainnya.
Menutup permintaan tarik akan secara otomatis mengirim email ke pembuat permintaan tarik serta pengulas yang diperlukan atau opsional. Ini tidak akan secara otomatis mengubah status masalah apa pun yang terkait dengan permintaan tarik.
**catatan**
Anda tidak dapat membuka kembali permintaan tarik setelah ditutup.
**Untuk menutup permintaan tarik**
1. Arahkan ke proyek tempat Anda ingin menutup permintaan tarik.
1. Pada halaman proyek, permintaan tarik terbuka ditampilkan. Pilih permintaan tarik yang ingin Anda tutup.
1. Pilih **Tutup**.
1. Tinjau informasi, lalu pilih **Tutup permintaan tarik**.