Perintah kunci (Kontrol Versi Team Foundation)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Perintah Team Foundation Version Control (TFVC) lock mengunci 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 lock perintah , Anda harus memiliki izin Kunci yang diatur ke Izinkan. Anda memerlukan izin Buka kunci perubahan pengguna lain yang 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.

Sintaks

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

Parameter

Argumen

Argumen

Keterangan

<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 mengubah cara fungsi perintah.

Catatan

Anda dapat menentukan lebih dari satu itemspec argumen.

<workspacename>

Nilai yang disediakan pengguna untuk opsi tersebut /workspace .

<username>

Menyediakan nilai untuk /login opsi . Anda dapat menentukan username nilai 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.

Opsi

Opsi

Keterangan

/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 yang ditentukan /workspace sampai Anda secara eksplisit merilis kunci check-in. Jika item yang ditentukan dikunci di ruang kerja lain, operasi penguncian gagal.

  • Checkout: Mencegah pengguna masuk 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.

Keterangan

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 mencegah akses ke item secara permanen di server TFVC, Anda harus menggunakan perintah Izin sebagai gantinya.

Catatan

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 tf utilitas baris perintah, lihat Menggunakan perintah kontrol versi Team Foundation.

Cara mengunci item

Anda dapat mengunci item menggunakan lock perintah atau dengan menentukan lock opsi selama komisi beberapa perintah utilitas baris perintah lainnya tf , 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, perubahan kunci ditambahkan ke kumpulan perubahan ruang kerja yang tertunda. checkout Tidak seperti perintah, 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 none opsi . 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 melakukan check out 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 TFVC $/src tersedia untuk check-out dan check-in oleh pengguna lain.

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