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.
# Mengatur kode sumber Anda bekerja dengan cabang di Amazon CodeCatalyst
Dalam Git, cabang adalah pointer atau referensi ke commit. Dalam pengembangan, mereka adalah cara yang nyaman untuk mengatur pekerjaan Anda. Anda dapat menggunakan cabang untuk memisahkan pekerjaan pada versi baru atau berbeda dari file tanpa mempengaruhi pekerjaan di cabang-cabang lain. Anda dapat menggunakan cabang untuk mengembangkan fitur baru, menyimpan versi spesifik proyek Anda, dan banyak lagi. Anda dapat mengonfigurasi aturan untuk cabang di repositori sumber untuk membatasi tindakan tertentu pada cabang ke peran tertentu dalam proyek tersebut.
Repositori sumber di Amazon CodeCatalyst memiliki konten dan cabang default terlepas dari bagaimana Anda membuatnya. Repositori tertaut mungkin tidak memiliki cabang atau konten default, tetapi tidak dapat digunakan CodeCatalyst sampai Anda menginisialisasi dan membuat cabang default. Saat Anda membuat proyek menggunakan cetak biru, CodeCatalyst buat repositori sumber untuk proyek tersebut yang menyertakan file README.md, kode sampel, definisi alur kerja, dan sumber daya lainnya. *Saat Anda membuat repositori sumber tanpa menggunakan cetak biru, file README.md ditambahkan untuk Anda sebagai komit pertama, dan cabang default dibuat untuk Anda.* Cabang default ini diberi nama *main*. Cabang default ini adalah cabang yang digunakan sebagai dasar atau cabang default dalam repositori lokal (repos) ketika pengguna mengkloning repositori.
**catatan**
Anda tidak dapat menghapus cabang default. Cabang pertama yang dibuat untuk repositori sumber adalah cabang default untuk repositori itu. Selain itu, pencarian hanya menampilkan hasil dari cabang default. Anda tidak dapat mencari kode di cabang lain.
Membuat repositori CodeCatalyst juga membuat komit pertama, yang membuat *cabang default* dengan file README.md yang disertakan di dalamnya. Nama cabang default itu adalah *main*. Ini adalah nama cabang default yang digunakan dalam contoh dalam panduan ini.
**Topics**
+ [Membuat cabang](source-create-delete-branch.md)
+ [Mengelola cabang default untuk repositori](source-branches-default-branch.md)
+ [Mengelola tindakan yang diizinkan untuk cabang dengan aturan cabang](source-branches-branch-rules.md)
+ [Perintah Git untuk cabang](source-branches-git.md)
+ [Melihat cabang dan detail](source-branches-view.md)
+ [Menghapus cabang](source-branches-delete.md)
# Membuat cabang
Anda dapat menggunakan CodeCatalyst konsol untuk membuat cabang di CodeCatalyst repositori. Cabang yang Anda buat akan terlihat oleh pengguna lain saat berikutnya mereka menarik perubahan dari repositori.
**Tip**
Anda juga dapat membuat cabang sebagai bagian dari pembuatan Lingkungan Pengembang untuk mengerjakan kode Anda. Untuk informasi selengkapnya, lihat [Membuat Lingkungan Pengembangan](devenvironment-create.md).
Anda juga dapat menggunakan Git untuk membuat cabang. Untuk informasi selengkapnya, lihat [Perintah Git umum untuk cabang](source-branches-git.md#source-branches-git-table).
**Untuk membuat cabang (konsol)**
1. Di CodeCatalyst konsol, arahkan ke proyek tempat repositori sumber Anda berada.
1. Pilih nama repositori dari daftar repositori sumber untuk proyek. Atau, di panel navigasi, pilih **Kode**, lalu pilih **Repositori sumber**.
1. Pilih repositori tempat Anda ingin membuat cabang.
1. Pada halaman ikhtisar repositori, pilih **Lainnya**, lalu pilih **Buat** cabang.
1. Masukkan nama untuk cabang.
1. Pilih cabang untuk membuat cabang, lalu pilih **Buat**.
# Mengelola cabang default untuk repositori
Anda dapat menentukan cabang mana yang akan digunakan sebagai *cabang default* di repositori sumber di Amazon. CodeCatalyst Semua repositori sumber CodeCatalyst memiliki konten dan cabang default terlepas dari bagaimana Anda membuatnya. *Jika Anda menggunakan cetak biru untuk membuat proyek, cabang default di repositori sumber yang dibuat untuk proyek tersebut diberi nama main.* Isi cabang default ditampilkan secara otomatis pada halaman ikhtisar untuk repositori itu.
**penting**
CodeCatalyst tidak mendukung pendeteksian perubahan di cabang default untuk repositori tertaut. Untuk mengubah cabang default untuk repositori tertaut, Anda harus terlebih dahulu memutuskan tautannya CodeCatalyst, mengubah cabang default, dan kemudian menautkannya lagi. Untuk informasi selengkapnya, lihat [Menautkan GitHub repositori, repositori Bitbucket, repositori GitLab proyek, dan proyek Jira di CodeCatalyst](extensions-link.md).
Sebagai praktik terbaik, selalu pastikan Anda memiliki versi ekstensi terbaru sebelum menautkan repositori.
Cabang default diperlakukan sedikit berbeda dari semua cabang lain dalam repositori sumber. Ini memiliki label khusus di sebelah namanya, **Default**. Cabang default adalah cabang yang digunakan sebagai basis atau cabang default di repositori lokal (repo) ketika pengguna mengkloning repositori ke komputer lokal dengan klien Git. Ini juga merupakan default yang digunakan saat membuat alur kerja untuk menyimpan file YAMAL alur kerja, dan untuk menyimpan informasi untuk masalah. Saat menggunakan search in CodeCatalyst, hanya cabang default dari repositori yang dicari. Karena cabang default sangat penting untuk begitu banyak aspek proyek, Anda tidak dapat menghapus cabang jika ditentukan sebagai cabang default. Namun, Anda dapat memilih untuk menggunakan cabang yang berbeda sebagai cabang default. Jika Anda melakukannya, [aturan cabang](source-branches-branch-rules.md) apa pun yang diterapkan ke cabang default sebelumnya akan diterapkan secara otomatis ke cabang yang Anda tentukan sebagai cabang default.
**catatan**
Anda harus memiliki peran administrator Project untuk mengubah cabang default untuk repositori sumber dalam CodeCatalyst proyek. Ini tidak berlaku untuk repositori tertaut.
**Untuk melihat dan mengubah cabang default untuk repositori**
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 pengaturan, termasuk cabang default.
1. Pada halaman ikhtisar repositori, pilih **Lainnya**, lalu pilih **Kelola** pengaturan.
1. Di **cabang Default**, nama cabang yang ditentukan sebagai cabang default ditampilkan bersama dengan label bernama **Default** di sebelah nama. Label yang sama ini muncul di sebelah nama cabang dalam daftar **cabang di Cabang**.
1. Untuk mengubah cabang default, pilih **Edit**.
**catatan**
Anda harus memiliki peran administrator Proyek dalam proyek untuk mengubah cabang default.
1. Pilih nama cabang yang ingin Anda jadikan cabang default dari daftar drop-down lalu pilih **Simpan**.
# Mengelola tindakan yang diizinkan untuk cabang dengan aturan cabang
Saat Anda membuat cabang, tindakan tertentu diizinkan untuk cabang tersebut berdasarkan izin untuk peran tersebut. Anda dapat mengubah tindakan apa yang diizinkan untuk cabang tertentu dengan mengonfigurasi aturan cabang. Aturan cabang didasarkan pada peran yang dimiliki pengguna dalam proyek Anda. Anda dapat memilih untuk membatasi beberapa tindakan yang telah ditentukan sebelumnya, seperti mendorong komit ke cabang, kepada pengguna dengan peran tertentu dalam proyek. Ini dapat membantu Anda melindungi cabang tertentu dalam proyek dengan membatasi peran mana yang diizinkan untuk melakukan tindakan tertentu. Misalnya, jika Anda mengonfigurasi aturan cabang untuk hanya mengizinkan pengguna dengan peran **administrator Project** untuk menggabungkan atau mendorong ke cabang tersebut, pengguna dengan peran lain dalam proyek tidak akan dapat membuat perubahan pada kode di cabang tersebut.
Anda harus mempertimbangkan dengan cermat semua implikasi pembuatan aturan untuk cabang. Misalnya, jika Anda memilih untuk membatasi push ke cabang ke pengguna dengan peran **administrator Project**, pengguna dengan peran **Kontributor** tidak akan dapat membuat atau mengedit alur kerja di cabang tersebut, karena alur kerja YAMAL disimpan di cabang tersebut, dan pengguna tersebut tidak dapat melakukan dan mendorong perubahan ke YAMAL. Sebagai praktik terbaik, uji aturan cabang apa pun setelah Anda membuatnya untuk memastikan bahwa aturan tersebut tidak memiliki dampak yang tidak Anda inginkan. Anda juga dapat menggunakan aturan cabang bersama dengan aturan persetujuan untuk permintaan tarik. Untuk informasi selengkapnya, lihat [Mengelola persyaratan untuk menggabungkan permintaan tarik dengan aturan persetujuan](source-pull-requests-approval-rules.md).
**catatan**
Anda harus memiliki peran administrator Proyek untuk mengelola aturan cabang untuk repositori sumber dalam CodeCatalyst proyek. Anda tidak dapat membuat aturan cabang untuk repositori tertaut.
Anda hanya dapat membuat aturan cabang yang lebih ketat daripada izin default untuk peran tersebut. Anda tidak dapat membuat aturan cabang yang lebih permisif daripada yang diizinkan oleh peran pengguna dalam proyek. Misalnya, Anda tidak dapat membuat aturan cabang yang memungkinkan pengguna dengan peran Reviewer untuk mendorong ke cabang.
Aturan cabang yang diterapkan ke cabang default repositori sumber Anda akan berperilaku sedikit berbeda dari aturan cabang 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, kecuali bahwa ia tidak lagi memiliki perlindungan terhadap penghapusan. Perlindungan itu hanya diterapkan ke cabang default saat ini.
Aturan cabang memiliki dua negara bagian, **Standar** dan **Kustom**. **Standar** menunjukkan bahwa tindakan yang diizinkan di cabang adalah tindakan yang cocok dengan izin untuk peran yang dimiliki pengguna CodeCatalyst untuk tindakan cabang. Untuk mempelajari lebih lanjut tentang peran apa yang memiliki izin, lihat[Memberikan akses dengan peran pengguna](ipa-roles.md). **Kustom** menunjukkan bahwa satu atau beberapa tindakan cabang memiliki tindakan yang memiliki daftar peran tertentu yang diizinkan untuk melakukan tindakan yang berbeda dari izin default yang diberikan oleh roe pengguna dalam proyek.
**catatan**
Jika Anda membuat aturan cabang untuk membatasi satu atau beberapa tindakan untuk cabang, tindakan **Hapus cabang** secara otomatis diatur untuk hanya mengizinkan pengguna dengan peran administrator Project untuk menghapus cabang tersebut.
Tabel berikut mencantumkan tindakan dan pengaturan default untuk peran yang diizinkan untuk melakukan tindakan ini di cabang.
**Tindakan dan peran cabang**
| **Tindakan cabang** | Peran diizinkan untuk melakukan tindakan ini ketika tidak ada aturan cabang yang diterapkan |
| --- | --- |
| Gabungkan ke cabang (ini termasuk menggabungkan permintaan tarik ke cabang) | Administrator proyek, Kontributor |
| Dorong ke cabang | Administrator proyek, Kontributor |
| Hapus cabang | Administrator proyek, Kontributor |
| Hapus cabang (cabang default) | Tidak diizinkan |
Anda tidak dapat menghapus aturan cabang, tetapi Anda dapat memperbaruinya untuk mengizinkan tindakan dari semua peran yang diizinkan untuk melakukan tindakan ini di cabang, yang secara efektif menghapus aturan tersebut.
**catatan**
Anda harus memiliki peran administrator Project untuk mengonfigurasi aturan cabang untuk repositori sumber dalam CodeCatalyst proyek. Ini tidak berlaku untuk repositori tertaut. Repositori tertaut tidak mendukung aturan cabang di. CodeCatalyst
**Untuk melihat dan mengedit aturan cabang untuk repositori**
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 cabang.
1. **Pada halaman ikhtisar repositori, pilih Cabang.**
1. Di kolom **Aturan cabang**, lihat status aturan untuk setiap cabang repositori. **Standar** menunjukkan bahwa aturan untuk tindakan cabang adalah aturan default untuk setiap cabang yang dibuat dalam repositori sumber dan cocok dengan izin yang diberikan untuk peran tersebut dalam proyek. **Kustom** menunjukkan bahwa satu atau beberapa tindakan cabang memiliki aturan yang membatasi satu atau beberapa tindakan yang diizinkan untuk cabang tersebut ke serangkaian peran yang berbeda.
Untuk melihat spesifikasi aturan cabang untuk cabang, pilih kata **Standar** atau **Kustom** di sebelah cabang yang ingin Anda tinjau.
1. Untuk membuat atau mengubah aturan cabang, pilih **Kelola pengaturan**. **Pada halaman pengaturan untuk repositori sumber, dalam **aturan cabang**, pilih Edit.**
1. Di **Cabang**, pilih nama cabang yang ingin Anda konfigurasikan aturannya dari daftar drop-down. Untuk setiap jenis tindakan yang diizinkan, pilih peran yang ingin Anda izinkan untuk melakukan tindakan tersebut dari daftar drop-down, lalu pilih **Simpan**.
# Perintah Git untuk cabang
Anda dapat menggunakan Git untuk membuat, mengelola, dan menghapus cabang di klon repositori sumber yang Anda miliki di komputer Anda (repo lokal Anda) atau di Lingkungan Dev Anda, lalu komit dan dorong perubahan Anda ke repositori CodeCatalyst sumber Anda (repositori jarak jauh). Contoh:
**Perintah Git umum untuk cabang**
| | |
| --- |--- |
| Mendaftar semua cabang di repo lokal dengan tanda bintang (`*`) yang ditampilkan di sebelah cabang Anda saat ini. | `git branch` |
| Menarik informasi tentang semua cabang yang ada di repositori jarak jauh ke repo lokal. | `git fetch` |
| Mendaftar semua cabang di repo lokal dan cabang pelacakan jarak jauh di repo lokal. | `git branch -a` |
| Mendaftar hanya cabang pelacakan jarak jauh di repo lokal. | `git branch -r` |
| Membuat cabang di repo lokal menggunakan nama cabang yang ditentukan. Cabang ini tidak akan muncul di repositori jarak jauh sampai Anda melakukan dan mendorong perubahan. | `git branch branch-name` |
| Membuat cabang di repo lokal menggunakan nama cabang yang ditentukan, dan kemudian beralih ke sana. | `git checkout -b branch-name` |
| Beralih ke cabang lain di repo lokal dengan menggunakan nama cabang yang ditentukan. | `git checkout other-branch-name` |
| Mendorong cabang dari repo lokal ke repositori jarak jauh menggunakan nama panggilan yang ditentukan repo lokal untuk repositori jarak jauh dan nama cabang yang ditentukan. Juga mengatur informasi pelacakan hulu untuk cabang di repo lokal. | `git push -u remote-name branch-name` |
| Menggabungkan perubahan dari cabang lain di repo lokal untuk cabang saat ini di repo lokal. | `git merge from-other-branch-name` |
| Menghapus cabang di repo lokal kecuali cabang tersebut berisi pekerjaan yang belum digabung. | `git branch -d branch-name` |
| Menghapus cabang di repositori jarak jauh menggunakan nama panggilan yang ditentukan yang dimiliki repo lokal untuk repositori jarak jauh dan nama cabang yang ditentukan. (Perhatikan penggunaan titik dua (`:`).) Atau, tentukan `--delete` sebagai bagian dari perintah. | `git push remote-name :branch-name` `git push remote-name --delete branch-name` |
Untuk informasi selengkapnya, lihat dokumentasi Git Anda.
# Melihat cabang dan detail
Anda dapat melihat informasi tentang cabang jarak jauh di Amazon CodeCatalyst, termasuk spesifikasi file, folder, dan komit terbaru untuk cabang tertentu, di CodeCatalyst konsol Amazon. Anda juga dapat menggunakan perintah Git dan sistem operasi lokal Anda untuk melihat informasi ini untuk cabang jarak jauh dan lokal.
**Untuk melihat cabang (konsol)**
1. Di CodeCatalyst konsol, arahkan ke proyek yang berisi repositori sumber tempat Anda ingin melihat cabang. Pilih **Kode**, pilih **repositori sumber**, dan kemudian pilih repositori sumber.
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 cabang.
1. Cabang default repositori ditampilkan. Anda dapat melihat daftar file dan folder di cabang, informasi tentang komit terbaru, dan isi file README.md, jika ada di cabang. Untuk melihat informasi untuk cabang yang berbeda, pilih dari daftar drop-down cabang untuk repositori.
1. Untuk melihat semua cabang untuk repositori, pilih **Lihat** semua. Halaman Cabang menampilkan informasi tentang nama, komit terbaru, dan aturan untuk setiap cabang.
Untuk informasi tentang cara menggunakan Git dan sistem operasi Anda untuk melihat cabang dan detail, lihat [Perintah Git Umum untuk cabang](source-branches-git.md#source-branches-git-table), dokumentasi Git Anda, dan dokumentasi sistem operasi Anda.
# Menghapus cabang
Jika Anda tidak lagi membutuhkan cabang, Anda dapat menghapusnya. Misalnya, jika Anda telah menggabungkan cabang dengan perubahan fitur ke cabang default dan fitur tersebut telah dirilis, Anda mungkin ingin menghapus cabang fitur asli, karena perubahan sudah menjadi bagian dari cabang default. Menjaga jumlah cabang tetap rendah dapat membantu pengguna menemukan cabang yang berisi perubahan yang ingin mereka kerjakan. Saat Anda menghapus cabang, salinan cabang itu tetap berada di klon repositori di komputer lokal sampai pengguna menarik dan menyinkronkan perubahan tersebut.
**Untuk menghapus cabang (konsol)**
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 menghapus cabang.
1. **Pada halaman ikhtisar repositori, pilih pemilih drop-down di sebelah nama cabang, lalu pilih Lihat semua.**
1. Pilih cabang yang ingin Anda hapus lalu pilih **Hapus cabang**.
**catatan**
Anda tidak dapat menghapus cabang default untuk repositori.
1. Sebuah kotak dialog konfirmasi kemudian muncul. Ini menunjukkan repositori, jumlah permintaan tarik terbuka, dan jumlah alur kerja yang terkait dengan cabang.
1. **Untuk mengonfirmasi penghapusan cabang, ketik **hapus** ke dalam kotak teks, lalu pilih Hapus.**
Anda juga dapat menggunakan Git untuk menghapus cabang. Lihat informasi yang lebih lengkap di [Perintah Git umum untuk cabang](source-branches-git.md#source-branches-git-table).