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-basedi 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. Karena deskripsi Tulis untuk saya dan Buat fitur ringkasan konten 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.

2. Lakukan salah satu hal berikut ini:

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

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

4. Di cabang Tujuan, pilih cabang untuk menggabungkan kode setelah ditinjau.

5. Di cabang Source, pilih cabang yang berisi kode komit.

6. Dalam judul permintaan tarik, masukkan judul yang membantu pengguna lain memahami apa yang perlu ditinjau dan alasannya.

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

8. (Opsional) Dalam Masalah, pilih Masalah tautan, lalu pilih masalah dari daftar atau masukkan ID-nya. Untuk memutuskan tautan masalah, pilih ikon batalkan tautan.

9. (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.

10. (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.

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

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

2. Di panel navigasi, pilih repositori Sumber, lalu pilih repositori yang berisi cabang tempat Anda memiliki perubahan kode untuk ditinjau.

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

4. Pilih Lainnya, lalu pilih Buat permintaan tarik.

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

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

7. (Opsional) Dalam Masalah, pilih Masalah tautan, lalu pilih masalah dari daftar atau masukkan ID-nya. Untuk memutuskan tautan masalah, pilih ikon batalkan tautan.

8. (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.

9. (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.

10. 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. Untuk informasi selengkapnya, lihat Menambahkan pemicu push, pull, atau schedule.