Perintah Workfold (Kontrol Versi Team Foundation)
Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Perintah Team Foundation Version Control (TFVC) workfold
membuat, memodifikasi, atau menampilkan informasi tentang pemetaan antara folder ruang kerja Anda dan folder yang ada di server Azure DevOps untuk TFVC.
Prasyarat
Untuk menggunakan workfold
perintah, Anda harus menjadi pemilik ruang kerja yang ditentukan atau tersirat atau memiliki izin Administer ruang kerja global yang diatur ke Izinkan. Untuk informasi selengkapnya, lihat Izin TFVC default.
Sintaks
tf workfold <local-folder> [/login:<username>,[<password>]]
tf workfold [/workspace:<workspace-name>] [/login:<username>,[<password>]]
tf workfold [/collection:<team-project-collection-url>] [/workspace:<workspace-name>] [/login:<username>,[<password>]]
<server-folder>
tf workfold [/map <server-folder> <local-folder>] [/collection:<team-project-collection-url>]
[/workspace:<workspace-name>][/login:<username>,[<password>]
tf workfold /unmap [/collection:<team-project-collection-url>] [/workspace:<workspace-name>]
[/recursive] (<server-folder>|<local-folder>) [/login:<username>,[<password>]]
tf workfold /cloak
<server-folder> [/workspace:<workspace-name>] [/collection:<team-project-collection-url>] [/login:<username>,[<password>]]
tf workfold /decloak <server-folder>
[/workspace:<workspace-name>] [/collection:<team-project-collection-url>][/login:<username>,[<password>]]
Parameter
Bagian berikut ini menjelaskan argumen dan opsi workfold
perintah.
Argumen
Argumen
Keterangan
<workspace-name>
Menentukan nama ruang kerja tempat perintah beroperasi dengan /workspace
opsi .
<server-folder>
Menentukan nama folder server Azure DevOps.
<local-folder>
Menentukan nama folder lokal.
<team-project-collection-url>
URL kumpulan proyek yang berisi folder yang ingin Anda bandingkan dengan folder server, misalnya, https://myserver:8080/tfs/DefaultCollection/
.
<username>
Menyediakan nilai untuk /login
opsi . Anda dapat menentukan nilai ini sebagai DOMAIN\<username>
atau <username>
.
<password>
Menyediakan nilai untuk /login
opsi .
Opsi
Opsi
Keterangan
/workspace
Menentukan nama ruang kerja yang akan dikerjakan.
/map
Menentukan hubungan antara folder lokal dan folder server Azure DevOps. Secara default, workfold
perintah menggunakan opsi ini, bahkan jika tidak ditentukan, kecuali /unmap
, , /cloak
atau /decloak
ditentukan.
/unmap
Menentukan pemetaan folder mana yang akan dihapus dari ruang kerja.
/cloak
Menentukan bahwa folder harus dikecualikan dari tindakan kontrol versi apa pun yang dibuat di ruang kerja.
/decloak
Mendekloaks folder sehingga folder dapat diambil ke ruang kerja.
/collection
Menentukan koleksi proyek.
/login
Menentukan nama pengguna dan kata sandi untuk mengautentikasi pengguna dengan Azure DevOps.
Keterangan
Anda dapat menggunakan workfold
perintah tf
utilitas baris perintah untuk membuat dan mengedit pemetaan ruang kerja. Pemetaan ruang kerja membuat folder sisi klien tempat semua file dan subfolder di folder server Azure DevOps diambil saat Anda menjalankan tf
get
operasi. Operasi get
tidak berfungsi jika folder sisi klien diselubungi.
Anda juga dapat menggunakan karakter kartubebas tanda bintang (*) untuk memetakan folder Azure DevOps Server dan item langsungnya ke ruang kerja lokal Anda. Pemetaan ini sering disebut sebagai pemetaan folder tunggal.
Untuk informasi selengkapnya tentang cara menggunakan tf
utilitas baris perintah, lihat Menggunakan perintah kontrol versi Team Foundation.
Opsi untuk pemetaan ruang kerja
Pemetaan ruang kerja adalah daftar item aktif dan berjubah. Anda dapat menambahkan item server Azure DevOps ke daftar yang dipetakan di ruang kerja dengan menggunakan /map
opsi . Anda juga dapat mengecualikan item dari ruang kerja secara eksplisit dengan menggunakan opsi ./cloak
Anda hanya dapat menyelubungi item yang memiliki induk yang dipetakan. Cloaking adalah cara yang efektif untuk meningkatkan kecepatan operasi batch get
dan untuk menghemat ruang pada disk.
Gunakan penyelubungan dengan kebijaksanaan. Untuk menghindari masalah kompilasi dan integrasi, Anda hanya boleh menyelubungi item yang Anda ketahui berada di luar cakupan proyek Anda saat ini dan di masa mendatang, seperti gambar dan file dokumentasi eksternal.
Anda dapat menggunakan opsi dan /decloak
untuk menghapus entri yang dipetakan /unmap
dan diselubungkan secara selektif dari pemetaan ruang kerja.
Bagaimana pemetaan ruang kerja diterapkan
Secara default, pemetaan ruang kerja diterapkan secara rekursif. Saat Anda memetakan folder lokal ke folder server Azure DevOps, sistem secara implisit membuat pemetaan antara semua subfolder saat ini dan yang akan datang.
Misalnya, Anda memetakan $/projects ke C:\projects. Selanjutnya, Anda menambahkan proyek yang disebut $/projects/project_one, lalu Anda menjalankan get
perintah di ruang kerja. Dalam skenario ini, TFVC secara otomatis membuat folder kerja lokal bernama project_one di direktori C:\projects .
Contoh berikut menggunakan karakter kartubebas tanda bintang (*) untuk memetakan folder server dan item langsungnya ke ruang kerja lokal Anda:
tf workfold $/projects/MyTeamProject/* C:\MyLocalWorkfold\MyTeamProject
Contoh berikut menggunakan workfold
perintah untuk mengambil alih pemetaan yang dibuat secara otomatis antara $/projects/project_one dan C:\projects\project_one:
tf workfold $/projects/project_one C:\DifferentWorkfold
Pemetaan di bawah cloaks
Pemetaan folder yang tidak terenkloak yang terletak di bawah folder yang diselubungi dalam hierarki kontrol versi dapat dipetakan ke ruang kerja lokal Anda.
Contoh
Contoh berikut menampilkan pemetaan untuk ruang kerja tempat c:\projects berada di:
c:\projects>tf workfold
Contoh berikut menyelubungi folder c:\projects\lib :
c:\projects>tf workfold /cloak c:\projects\lib
Contoh berikut menampilkan pemetaan untuk file lokal word.cs:
c:\projects>tf workfold word.cs
Contoh berikut memetakan folder C:\DifferentWorkfold ke folder server Azure DevOps $/projects/project_one dan mengganti pemetaan ruang kerja sebelumnya untuk folder server $/projects/project_one Azure DevOps:
c:\projects>tf workfold $/projects/project_one C:\DifferentWorkfold