Menggunakan label untuk mengambil rekam jepret file Anda di Azure Repos

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Label Team Foundation Version Control (TFVC) menyediakan cara bagi Anda untuk mengambil rekam jepret file Anda. Nantinya, Anda dapat merujuk kembali ke rekam jepret tersebut. Dengan menggunakan label, Anda dapat melihat, membangun, atau bahkan mengembalikan sekumpulan besar file ke status saat Anda menerapkan label.

Prasyarat

  • Untuk menerapkan label, Anda harus memiliki izin Label yang diatur ke Izinkan.
  • Untuk menemukan, mencantumkan, atau menampilkan label, Anda harus memiliki izin Baca yang diatur ke Izinkan.
  • Untuk mengubah atau menghapus label, Anda harus memiliki label atau mengatur izin Label Administer ke Izinkan.

Menggunakan label

Dalam banyak proyek perangkat lunak, ketika kode telah mencapai tingkat kualitas dan stabilitas yang wajar, tim membangun dan merilis versi baru produk. Tim perlu menandai versi saat ini dari setiap file. Bahkan ketika file terus berubah, tim masih bisa mendapatkan dan membangun versi baru dari setiap file dalam proyek mereka.

Secara teoritis, Anda dapat merekam ID setiap set perubahan untuk setiap file secara manual. Tapi proses semacam ini tidak praktis. TFVC memudahkan pekerjaan. Terapkan label ke folder, cabang, atau proyek yang berisi file. Anda dapat memberi label nama yang mengikuti konvensi penamaan apa pun yang Anda sukai. Beberapa contoh nama label meliputi: "Sprint 5," "M1," "Beta2," dan "Release Candidate 0."

Setelah menerapkan label, Anda dapat menggunakannya untuk memenuhi syarat operasi seperti membangun, mencabangkan, menggabungkan, membandingkan, dan mendapatkan versi file dan folder tertentu.

Terkadang setelah Anda menerapkan label, Anda memutuskan bahwa Anda perlu mengubahnya. TFVC menyediakan cara bagi Anda untuk menerapkan label ke file tambahan, menghapus label dari file tertentu, dan memodifikasi versi file tertentu yang diterapkan label.

Tip

Menerapkan label memberikan banyak manfaat yang sama seperti membuat cabang, tetapi biasanya dengan biaya dan kompleksitas yang lebih rendah. Tradeoff adalah bahwa untuk database besar, operasi seperti penggabungan mungkin memakan waktu lebih lama dari biasanya saat berjalan terhadap label.

Menerapkan label

Catatan

Saat Anda menggunakan Visual Studio untuk menerapkan label yang sudah ada, operasi akan menghapus label dari semua versi file lalu menerapkan label. Namun, dari prompt perintah, operasi label bersifat aditif. Lihat Perintah label (Kontrol Versi Team Foundation).

  1. Di Visual Studio, pada menu Tampilan, pilih Penjelajah Kontrol Sumber Windows>Lainnya.

  2. Di Penjelajah Kontrol Sumber, klik kanan koleksi, proyek, cabang, folder, atau file yang ingin Anda terapkan labelnya, lalu pilih Terapkan Label Tingkat Lanjut>. Kotak dialog Label Baru muncul.

  3. Dalam kotak Nama , masukkan nama untuk label.

  4. (Opsional) Dalam kotak Komentar , masukkan komentar.

  5. Dalam daftar Versi, Versi Terbaru dipilih secara default. Opsi ini adalah opsi yang paling sering digunakan. Jika Anda memerlukan label untuk menargetkan versi tertentu, pilih salah satu opsi berikut:

    • Changeset: Tentukan jumlah set perubahan dalam kotak Changeset . Atau, pilih elipsis (...) untuk membuka kotak dialog Temukan Set Perubahan . Untuk informasi selengkapnya, lihat Menemukan dan melihat changeset.

    • Tanggal: Tentukan tanggal dalam kotak Tanggal atau pilih tanggal dari kalender pada menu dropdown.

    • Label: Tentukan label yang sudah ada untuk mendasarkan label baru. Masukkan nama label dalam kotak Label , atau pilih elipsis (...) untuk membuka kotak dialog Temukan Label . Untuk informasi selengkapnya, lihat Menemukan, mengedit, dan menghapus label.

    • Versi Ruang Kerja: Buat label untuk versi di ruang kerja Anda.

  6. Saat Anda puas dengan pengaturan Anda, lakukan salah satu langkah berikut:

    • Untuk menerapkan label, pilih Buat.

    • Untuk menerapkan label lalu mengubahnya setelah diterapkan, pilih Buat dan Edit. Tindakan ini menerapkan label lalu menampilkan jendela Label . Untuk informasi selengkapnya tentang menggunakan jendela Label untuk mengedit label, lihat Menggunakan jendela Label untuk bekerja dengan label.

Catatan

Saat Anda menerapkan label yang menggunakan nama yang sudah ada, sistem memperingatkan Anda dan menanyakan apakah Anda ingin melanjutkan. Jika Anda memilih OK untuk melanjutkan, TFVC akan menghapus label tersebut dari item apa pun yang tidak berada di jalur tempat Anda menerapkan label.

Mengganti nama label

Anda tidak dapat mengubah nama label yang sudah ada. Tetapi Anda dapat dengan mudah menerapkan label baru ke file yang sama persis dan versi yang sama dengan yang diterapkan label lain.

  1. Di Penjelajah Kontrol Sumber, klik kanan simpul kumpulan proyek (simpul akar), lalu pilih Terapkan Label Tingkat Lanjut>. Kotak dialog Label Baru muncul.

  2. Dalam kotak Nama , masukkan nama untuk label.

  3. (Opsional) Dalam kotak Komentar , masukkan komentar.

  4. Di Daftar versi , pilih Label. Kotak Label muncul.

  5. Ikuti salah satu langkah berikut ini:

    • Masukkan nama label yang ada.

    • Jika Anda tidak yakin dengan nama label yang ada, pilih tombol telusuri dengan elipsis (...) di samping kotak Label . Kotak dialog Temukan Label muncul. Gunakan opsi dalam kotak dialog Temukan Label untuk memfilter daftar label dan temukan label yang sudah ada yang ingin Anda terapkan label barunya. Untuk informasi selengkapnya, lihat Menemukan, mengedit, dan menghapus label.

  6. Pilih Buat.

  7. (Opsional) Setelah membuat label baru, Anda dapat menghapus label lama. Untuk informasi selengkapnya, lihat Menemukan, mengedit, dan menghapus label.

Mencantumkan, menemukan, menampilkan, mengedit, dan menghapus label

Ada dua cara untuk mencantumkan dan menemukan label: kotak dialog Temukan Label dan tab Label di jendela Riwayat . Setelah menemukan label yang Anda minati, Anda bisa menampilkan, mengedit, atau menghapusnya. Anda juga dapat bekerja dengan file yang diterapkan label.

Menemukan dan bekerja dengan label dengan menggunakan kotak dialog Temukan Label

  1. Di Penjelajah Kontrol Sumber, pada bilah menu, pilih Kontrol Sumber File>Temukan Label Temukan.>> Kotak dialog Temukan Label muncul.

  2. (Opsional) Persingatkan pencarian Anda dengan melakukan satu atau beberapa langkah berikut:

    • Dalam kotak teks Nama , masukkan nama label.

    • Di daftar Proyek, pilih proyek yang berisi label yang ingin Anda temukan.

    • Dalam kotak teks Pemilik , masukkan nama atau alias pemilik label.

  3. Pilih Temukan. Daftar Hasil menampilkan label yang cocok dengan kriteria pencarian yang Anda masukkan.

  4. (Opsional) Lakukan salah satu langkah berikut:

Mencantumkan dan bekerja dengan label yang berlaku untuk item tertentu

Terkadang Anda mungkin tidak yakin dengan nama label, tetapi Anda tahu bahwa label diterapkan ke item tertentu di bawah kontrol versi. Prosedur berikut menjelaskan cara menemukan dan bekerja dengan label dalam situasi ini.

  1. Di Penjelajah Kontrol Sumber, klik kanan item tempat label diterapkan, lalu pilih Tampilkan Riwayat. Jendela Riwayat muncul.

  2. Pilih tab Label untuk menampilkan daftar label yang berlaku untuk item ini.

  3. (Opsional) Lakukan salah satu langkah berikut:

    • Untuk melihat atau mengedit label, klik kanan label, lalu pilih Edit Label. Jendela Label muncul. Untuk informasi tentang cara menggunakan jendela ini, lihat Menggunakan jendela Label untuk bekerja dengan label.

    • Untuk menghapus label, klik kanan label, lalu pilih Hapus Label.

    • Klik kanan label, lalu pilih tindakan lain seperti Dapatkan Versi Ini atau Bandingkan.

Untuk informasi selengkapnya tentang cara menggunakan tab label di jendela Riwayat, lihat Mendapatkan riwayat item.

Mengunduh versi file berlabel ke ruang kerja Anda

Pelabelan set file seperti mengambil rekam jepret tentang bagaimana file tersebut ada pada titik waktu tertentu. Minggu atau bulan setelah Anda mengambil rekam jepret ini, Anda mungkin perlu melihat atau bekerja dengan file seperti yang ada di rekam jepret tersebut. Prosedur berikut menjelaskan cara mengunduh versi berlabel dari sekumpulan file ke ruang kerja Anda.

  1. Di Penjelajah Kontrol Sumber, klik kanan koleksi proyek, proyek, cabang, atau folder yang berisi item yang ingin Anda unduh, lalu pilih Tingkat Lanjut>Dapatkan Versi Tertentu. Kotak dialog Dapatkan muncul.

  2. Dari daftar Tipe, pilih Label, lalu masukkan nama label dalam kotak Label, atau pilih elipsis (...) untuk membuka kotak dialog Temukan Label. Untuk informasi selengkapnya tentang cara menggunakan kotak dialog ini, lihat Menemukan, mengedit, dan menghapus label.

  3. Pilih opsi lain yang sesuai dalam kotak dialog Dapatkan .

  4. Pilih Dapatkan.

Gunakan jendela Label untuk bekerja dengan label

Setelah Anda membuka jendela Label dengan menggunakan salah satu prosedur sebelumnya, Anda siap untuk mulai bekerja dengan label. Di bagian atas jendela, kotak menampilkan komentar, yang dapat Anda edit.

Anda bisa menggunakan jendela Label untuk melakukan tugas berikut:

  • Menambahkan item ke label
  • Menghapus item dari label
  • Mengubah versi file
  • Melakukan tindakan lain pada item

Menambahkan item ke label

  1. Di jendela Label , pilih Tambahkan Item. Kotak dialog Pilih Versi Item muncul.

  2. Dalam kotak dialog Pilih Versi Item, navigasikan ke item yang ingin Anda tambahkan lalu pilih item tersebut.

    Tip

    Anda dapat memilih dan menahan tombol Ctrl atau Shift lalu memilih beberapa item.

  3. (Opsional) Jika Anda memerlukan label untuk menargetkan versi tertentu, dari daftar Versi , pilih versi:

    • Versi Terbaru: Terapkan label ke versi terbaru yang ada di kontrol versi.

    • Changeset: Tentukan jumlah set perubahan dalam kotak Changeset . Atau, pilih elipsis (...) untuk membuka kotak dialog Temukan Set Perubahan . Untuk informasi selengkapnya, lihat Menemukan dan melihat changeset.

    • Tanggal: Tentukan tanggal dalam kotak Tanggal atau pilih tanggal dari kalender pada menu dropdown.

    • Label: Tentukan label yang sudah ada untuk mendasarkan label baru. Masukkan nama label dalam kotak Label , atau pilih elipsis (...) untuk membuka kotak dialog Temukan Label . Untuk informasi selengkapnya, lihat Menemukan, mengedit, dan menghapus label.

    • Versi Ruang Kerja: Buat label untuk versi di ruang kerja Anda.

  4. Pilih OK.

  5. Pilih File>Simpan.

Menghapus item dari label

  1. Di jendela Label, temukan koleksi, proyek, cabang, folder, atau file yang ingin Anda hapus dari label ini.

  2. Klik kanan item dan pilih Hapus dari Label. Label dihapus dari item. Jika item adalah koleksi proyek, proyek, cabang, atau folder, label juga dihapus dari semua item yang ada di dalamnya.

  3. Pilih File>Simpan.

Mengubah versi file

  1. Di jendela Label, temukan file yang ingin Anda ubah.

  2. Klik kanan file dan pilih Ubah Versi Berlabel. Kotak dialog Ubah Versi Berlabel muncul.

  3. Pilih salah satu dari nilai berikut ini:

    • Versi Terbaru: Terapkan label ke versi terbaru yang ada di kontrol versi.

    • Changeset: Tentukan jumlah set perubahan dalam kotak Changeset . Atau, pilih elipsis (...) untuk membuka kotak dialog Temukan Set Perubahan . Untuk informasi selengkapnya, lihat Menemukan dan melihat changeset.

    • Tanggal: Tentukan tanggal dalam kotak Tanggal atau pilih tanggal dari kalender pada menu dropdown.

    • Label: Tentukan label yang sudah ada untuk mendasarkan label baru. Pilih nama label dalam kotak Label , atau pilih elipsis (...) untuk membuka kotak dialog Temukan Label . Untuk informasi selengkapnya, lihat Menemukan, mengedit, dan menghapus label.

    • Versi Ruang Kerja: Buat label untuk versi di ruang kerja Anda.

  4. Pilih File>Simpan.

Melakukan tindakan lain pada item berlabel

Saat Anda mengklik kanan item di jendela Label, Anda juga bisa memilih salah satu perintah berikut:

Bekerja dari prompt perintah

  • labels Gunakan perintah untuk mencantumkan label. Untuk informasi selengkapnya, lihat Perintah label.

  • label Gunakan perintah untuk menerapkan atau menghapus label. Untuk informasi selengkapnya, lihat Perintah label (Kontrol Versi Team Foundation).

    Tip

    Saat Anda menggunakan label perintah untuk menerapkan label, Anda dapat menentukan cakupan selain proyek.

Langkah berikutnya