Bagikan melalui

Perintah penggabungan (Kontrol Versi Team Foundation)

  • Artikel

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Perintah menerapkan tf merge perubahan dari satu cabang ke cabang lain di Team Foundation Version Control (TFVC).

Catatan

Hasil perintah ini tidak tercermin di server Azure DevOps hingga Anda melakukan operasi check-in. Untuk informasi selengkapnya, lihat Mengembangkan kode dan mengelola perubahan yang tertunda.

Prasyarat

Untuk menggunakan merge perintah, Anda harus mengatur izin Cek keluar ke Izinkan folder ruang kerja yang berisi destination, dan Anda harus memiliki izin Baca yang diatur ke Izinkan untuk folder ruang kerja yang berisi source. Untuk informasi selengkapnya, lihat Izin TFVC default.

Sintaks

tf merge [/recursive] [/force] [/candidate] [/discard] 
[/version:versionspec] [/lock:none|checkin|checkout] [/preview] 
[/baseless] [/nosummary] [/noimplicitbaseless] [/conservative] [/format:(brief|detailed)] [/noprompt] [/login:username,[password]] source destination

Parameter

Argumen

Argumen

Keterangan

<versionspec>

Menyediakan nilai seperti C2 untuk /version opsi . Untuk informasi selengkapnya tentang cara TFVC mengurai spesifikasi versi untuk menentukan item mana yang berada dalam cakupannya, lihat Menggunakan perintah kontrol versi Team Foundation.

<source>

Menentukan file atau folder untuk bertindak sebagai sumber penggabungan.

<destination>

Menentukan file atau folder untuk bertindak sebagai tujuan penggabungan.

<username>

Menyediakan nilai untuk /login opsi . Anda dapat menentukan username nilai sebagai DOMAIN\username atau username.

Opsi

Opsi

Keterangan

/recursive

Cocok dengan source spesifikasi item di direktori saat ini dan subfolder apa pun.

/force

Mengabaikan riwayat penggabungan dan menggabungkan perubahan yang ditentukan dari sumber ke tujuan, meskipun beberapa atau semua perubahan ini telah digabungkan sebelumnya.

/candidate

Mencetak daftar semua set perubahan di sumber yang belum digabungkan ke tujuan. Daftar harus menyertakan ID set perubahan yang belum digabungkan dan informasi dasar lainnya tentang set perubahan tersebut. Tanda bintang untuk hasil tertentu menunjukkan bahwa tanda bintang digabungkan sebagian, yang berarti beberapa perubahan dalam set perubahan telah digabungkan dan perubahan lain belum digabungkan.

/discard

Tidak melakukan operasi penggabungan, tetapi memperbarui riwayat penggabungan untuk melacak bahwa penggabungan terjadi. Ini membuang set perubahan agar tidak digunakan untuk penggabungan tertentu.

/version

Untuk penggabungan selektif, opsi ini menentukan rentang yang harus digabungkan ke tujuan. Untuk penggabungan catch-up, parameter ini menentukan versi sebelum semua perubahan yang tidak digabungkan harus digabungkan.

Untuk penggabungan selektif, rentang versi menunjukkan titik awal dan akhir dari kumpulan perubahan yang akan digabungkan. Misalnya, jika Anda mencoba menggabungkan versi 4~6, set perubahan 4, 5, dan 6 digabungkan.

/lock

Menentukan jenis kunci atau menghapus kunci dari item. Untuk informasi selengkapnya, lihat Memahami jenis kunci.

Opsi kunci:

  • None: Tidak menempatkan kunci pada item, dan menghapus kunci yang ada dari item.

  • Checkin: Pengguna lain dapat memeriksa item yang ditentukan, tetapi mereka tidak dapat memeriksa revisi ke file terkunci hingga Anda melepaskan kunci dengan melakukan check-in. Jika ada pengguna lain yang telah mengunci salah satu item yang ditentukan, operasi penguncian gagal.

  • Checkout: Mencegah pengguna masuk atau memeriksa salah satu item yang ditentukan hingga Anda secara eksplisit melepaskan kunci. Jika ada pengguna lain yang telah mengunci salah satu item yang ditentukan, atau jika ada perubahan yang tertunda terhadap item apa pun, operasi penguncian gagal.

/preview

Memperlihatkan pratinjau penggabungan.

/baseless

Melakukan penggabungan tanpa versi dasar. Artinya, memungkinkan pengguna untuk menggabungkan file dan folder yang tidak memiliki hubungan penggabungan. Setelah penggabungan tanpa dasar, hubungan penggabungan ada, dan penggabungan di masa mendatang tidak harus tidak berdasar.

Catatan

Penggabungan tanpa dasar tidak dapat menghapus file di target. Anda dapat membawa perubahan tersebut secara manual.

/noimplicitbaseless

Menentukan bahwa TFVC tidak akan melakukan penggabungan tanpa dasar implisit antara dua item yang memiliki nama relatif yang sama dalam dua pohon kontrol versi yang tidak terkait.

/nosummary

Menghilangkan ringkasan konflik, kesalahan, dan peringatan.

/noprompt

Menekan setiap permintaan untuk input dari Anda.

/conservative

Menghasilkan lebih banyak konflik saat Anda menggabungkan satu cabang ke cabang lainnya.

/format

Menentukan format ringkasan konflik penggabungan:

  • Brief (default): Hanya meringkas jumlah total konflik, peringatan, dan kesalahan.
  • Detailed: Meringkas tidak hanya jumlah total konflik, peringatan, dan kesalahan, tetapi juga mencantumkan detail tentang setiap konflik.

Catatan

Opsi ini hanya berlaku ketika output berisi ringkasan konflik. Ringkasan tidak dapat ditampilkan jika /nosummary opsi digunakan atau penggabungan menyebabkan kurang dari 10 konflik, peringatan, dan kesalahan.

/login

Menentukan nama pengguna dan kata sandi untuk mengautentikasi pengguna dengan Azure DevOps.

Keterangan

Anda dapat menggunakan merge perintah tf utilitas baris perintah untuk menerapkan perubahan di cabang sumber yang ada ke cabang target yang ada. Anda dapat menggabungkan revisi individual atau set perubahan lengkap ke cabang target. Anda dapat menggabungkan perubahan dari sumber ke cabang target atau dari tujuan ke cabang sumber.

Perintah ini merge juga memungkinkan Anda mengkueri perubahan di cabang sumber yang belum dimigrasikan ke cabang target. Perintah ini juga memungkinkan Anda menunjukkan bahwa perubahan tertentu tidak akan pernah digabungkan dari sumber ke tujuan dan tidak boleh lagi ditampilkan sebagai kandidat untuk operasi penggabungan.

Untuk informasi selengkapnya tentang cara menggunakan tf utilitas baris perintah, lihat Menggunakan perintah kontrol versi Team Foundation.

Penggabungan tanpa dasar

Gunakan penggabungan tanpa dasar untuk menggabungkan item yang tidak bercabang secara langsung satu sama lain. Untuk melakukan penggabungan tanpa dasar, Anda harus menggunakan tf merge perintah . Ketika Anda melakukan penggabungan tanpa dasar, TFVC tidak memiliki informasi tentang hubungan file di cabang. Dalam penggabungan tanpa dasar, Anda harus melakukan resolusi konflik manual. Setelah Anda melakukan penggabungan tanpa dasar dan menyelesaikan konflik apa pun, TFVC merekam riwayat penggabungan dan membuat hubungan antara folder dan file.

Saat Anda menjalankan tf merge, TFVC melakukan penggabungan tanpa dasar implisit di antara item yang memiliki nama relatif yang sama di dua pohon yang dikontrol versi yang sebelumnya terkait. Misalnya, Anda mungkin ingin menggabungkan cabang $SRC terkait dan $TGT. Kedua cabang berisi file yang tidak terkait yang bernama a.txt. Saat Anda menjalankan tf merge, TFVC membuat hubungan antara dua file a.txt jika kedua file sama, enkripsi yang mematuhi FIPS dinonaktifkan, dan file sumber tidak terkait dengan file lain dalam target.

Jika Anda menjalankan tf merge dengan /noimplicitbaseless set opsi, ketika TFVC mencoba menggabungkan dua cabang, dua file a.txt membuat konflik namespace saat Anda mencoba memeriksa perubahan. Untuk mengatasi konflik, Anda harus mengganti nama salah satu file.

Contoh

Contoh berikut menggabungkan perubahan dari MyFile_beta1 yang belum digabungkan ke dalam MyFile_RTM.

c:\projects>tf merge MyFile_beta1 MyFile_RTM /recursive

Contoh berikut menggabungkan changeset 137 ke dalam branch2.

c:\projects>tf merge /version:C137~C137 branch1 branch2 /recursive

Contoh berikut menggabungkan semua changeset hingga changeset 137 menjadi branch2.

c:\projects>tf merge /version:C137 branch1 branch2 /recursive

Contoh berikut mencetak daftar set perubahan di cabang1 yang belum digabungkan ke dalam cabang2.

c:\projects>tf merge /candidate branch1 branch2 /recursive

Contoh berikut mencetak daftar set perubahan di cabang2 yang belum digabungkan kembali ke cabang1.

c:\projects>tf merge /candidate branch2 branch1 /recursive

Contoh berikut membuang changeset 137 sebagai kandidat untuk menggabungkan ke dalam cabang2.

c:\projects>tf merge /discard /version:C137~C137 branch1 branch2 /recursive

Contoh berikut membuang semua changeset hingga changeset 137 sebagai kandidat untuk menggabungkan ke dalam branch2.

c:\projects>tf merge /discard /version:C137 branch1 branch2 /recursive