Perintah Workfold (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) 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, , /cloakatau /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 tfget 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