Bagikan melalui

Perintah kunci (Kontrol Versi Team Foundation)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Kontrol Versi Team Foundation (TFVC) lock kunci perintah atau membuka kunci file atau folder. Perintah menolak atau memulihkan hak pengguna untuk memeriksa item untuk diedit ke ruang kerja yang berbeda atau untuk memeriksa perubahan tertunda pada item dari ruang kerja yang berbeda.

Prasyarat

Untuk menggunakan perintah lock, atur izin Kunci ke Izinkan. Anda memerlukan Membuka kunci perubahan pengguna lain izin diatur ke Izinkan untuk menghapus kunci yang disimpan oleh pengguna lain jika Anda tidak memiliki izin Tulis untuk ruang kerja pengguna tersebut. Untuk informasi selengkapnya, lihat izin TFVC Default.

Sintaksis

tf lock itemspec /lock:(none|checkout|checkin) 
[/workspace:workspacename] [/recursive] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]

Parameter

Argumen

Argumen

Deskripsi

<itemspec>

Mengidentifikasi file atau folder untuk mengunci atau membuka kunci. Untuk informasi selengkapnya tentang cara TFVC mengurai itemspec untuk menentukan item mana yang berada dalam cakupan, lihat Menggunakan opsi untuk memodifikasi bagaimana perintah berfungsi.

Nota

Anda dapat menentukan lebih dari satu argumen itemspec.

<workspacename>

Nilai yang disediakan pengguna untuk opsi /workspace.

<username>

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

<TeamProjectCollectionUrl>

URL koleksi proyek yang berisi file atau folder yang ingin Anda kunci atau buka kuncinya, misalnya http://myserver:8080/tfs/DefaultCollection.

Pilihan

Opsi

Deskripsi

/lock

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

Opsi kunci:

  • None: Menghapus kunci dari item.

  • Checkin: Memungkinkan item untuk dicek keluar dan diedit di semua ruang kerja tetapi mencegah pengguna memeriksa perubahan pada item di luar /workspace yang ditentukan hingga Anda secara eksplisit melepaskan kunci check-in. Jika item yang ditentukan dikunci di ruang kerja lain, operasi penguncian gagal.

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

/workspace

Menentukan nama ruang kerja yang berbeda untuk menerapkan kunci. Secara default, kunci diterapkan di ruang kerja tempat Anda saat ini.

/login

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

/collection

Menentukan koleksi proyek.

Komentar

Anda dapat menggunakan perintah kunci untuk membekukan sementara versi server TFVC item sehingga Anda dapat memeriksa perubahan yang tertunda tanpa harus mengatasi konflik penggabungan apa pun. Jika Anda ingin secara permanen mencegah akses ke item di server TFVC, Anda harus menggunakan perintah izin sebagai gantinya.

Nota

Sebagai kesantunan bagi rekan satu tim Anda, beri tahu mereka ketika Anda menerapkan kunci ke item, menjelaskan mengapa Anda melakukan ini, dan memperkirakan kapan Anda berencana untuk menghapus kunci, jika Anda bisa.

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

Cara mengunci item

Anda dapat mengunci item menggunakan perintah lock atau dengan menentukan opsi lock selama komisi beberapa perintah utilitas baris perintah tf lainnya, termasuk:

Untuk add dan branch, kunci ditempatkan pada namespace tempat item baru akan dibuat. Kunci yang ditempatkan dengan rename berlaku untuk namespace layanan lama dan baru. Untuk informasi selengkapnya, lihat Mengunci dan membuka kunci folder atau file.

Jenis kunci

TFVC menyediakan dua jenis kunci: checkin dan checkout.

Kunci check-in kurang ketat daripada kunci check-out. Saat Anda menerapkan kunci check-in, pengguna dapat terus membuat perubahan lokal pada item di ruang kerja lain. Perubahan tidak dapat diperiksa sampai Anda secara eksplisit menghapus kunci check-in dari ruang kerja.

Kunci cek keluar lebih ketat daripada kunci check-in. Saat Anda menerapkan kunci cek keluar ke file atau folder yang dikontrol versi, pengguna tidak dapat memeriksa item untuk diedit atau cek masuk perubahan yang tertunda sebelumnya. Anda tidak dapat memperoleh kunci cek keluar jika saat ini ada perubahan yang tertunda pada item.

Untuk informasi selengkapnya tentang kapan menerapkan kunci check-out dan kapan menerapkan kunci check-in, lihat Memahami jenis kunci.

Cara kerja penguncian

Jika Anda memiliki file yang dicek keluar saat Anda menguncinya, statusnya dimodifikasi untuk berisi jenis kunci baru. Jika file tidak dicek keluar, penguncian perubahan ditambahkan ke kumpulan perubahan ruang kerja yang tertunda. Tidak seperti perintah checkout, lock tidak secara otomatis membuat file dapat diedit.

Kunci pada folder secara implisit rekursif. Jika Anda mengunci folder, Anda tidak perlu mengunci file yang dikandungnya kecuali Anda ingin menerapkan kunci check-out yang lebih ketat ke file di folder yang memiliki kunci check-in.

Membuka kunci item

Anda dapat membuka kunci item terkunci dengan menggunakan opsi none. TFVC juga membuka kunci item secara otomatis saat Anda memeriksa perubahan yang tertunda di ruang kerja.

Anda dapat menentukan file mana yang dikunci di server TFVC dan oleh siapa file dikunci dengan menggunakan perintah Status .

Contoh

Contoh berikut mencegah pengguna lain memeriksa 314.cs.

c:\projects>tf lock /lock:checkout 314.cs

Contoh berikut mencegah pengguna lain memeriksa perubahan pada 1256.cs tetapi memungkinkan mereka untuk memeriksanya di ruang kerja mereka.

c:\projects>tf lock /lock:checkin 1256.cs

Contoh berikut mencegah pengguna lain tertunda perubahan pada item apa pun di folder $/src di server TFVC.

c:\projects>tf lock /lock:checkout $/src

Contoh berikut membuka kunci dan membuat semua file di folder server $/src TFVC tersedia untuk check-out dan check-in oleh pengguna lain.

c:\projects>tf lock /lock:none $/src