Pembatasan dan konvensi penamaan
Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019
Sebagian besar komponen di Azure DevOps harus mengikuti pembatasan penamaan dan konvensi. Pembatasan membantu menjamin pengalaman pengguna yang konsisten dan memberikan kompatibilitas dengan aplikasi lain.
Pembatasan umum termasuk tidak melebihi panjang karakter untuk nama, tidak berisi karakter khusus, dan mempertahankan keunikan nama dalam kumpulan objek.
Penting
Saat menggunakan API, bukan antarmuka pengguna (UI), API memungkinkan Anda untuk secara langsung menentukan nama, yang mencakup karakter yang mungkin dibatasi di UI.
Praktik terbaik:
- Ikuti pembatasan UI untuk menjaga konsistensi dan mencegah masalah yang tidak diinginkan.
- Validasi nama secara terprogram dan tangani karakter khusus apa pun dengan tepat.
Pertimbangan umum
Pembatasan panjang dalam artikel ini diukur dengan jumlah karakter Unicode yang diizinkan. Karakter pengganti terdiri dari dua karakter Unicode, yang dihitung sebagai dua karakter terhadap pembatasan panjang. Untuk informasi selengkapnya, lihat Tentang Unicode dan Set Karakter.
Seperti halnya file sistem operasi lainnya, karakter kontrol ASCII (ASCII 1-31) dan kombinasi pengganti juga tidak diizinkan. Untuk informasi umum tentang pembatasan sistem operasi yang diterapkan ke nama file, lihat Penamaan File, Jalur, dan Namespace.
Catatan
- Untuk batasan jumlah item yang dapat Anda tentukan, lihat Pelacakan kerja, proses, dan batas proyek.
Nama yang dicadangkan sistem
Hindari menggunakan nama yang dipesan sistem, seperti contoh berikut:
- AUX
- COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10
- TIPU
- DefaultCollection
- LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9
- NUL
- PRN
- SERVER, SignalR
- Web atau WEB
Untuk informasi selengkapnya tentang nama yang dipesan, lihat Nama file, jalur, dan namespace layanan.
Azure Artifacts
Paket universal harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| Nama paket | - Harus huruf kecil. - Harus dimulai dan diakhir dengan huruf atau angka. - Hanya boleh berisi huruf, angka, dan tanda hubung nonkonsekutif, garis bawah, atau titik. |
| Versi paket | Harus huruf kecil tanpa metadata build. |
Azure Boards
Anda menggunakan item kerja untuk mengambil informasi guna merencanakan dan melacak proyek pengembangan perangkat lunak Anda. Dengan item kerja, Anda dapat menjelaskan pekerjaan yang akan dilakukan, menetapkan pekerjaan, melacak status, dan mengoordinasikan upaya dalam tim Anda. Berbagai jenis item kerja—seperti cerita pengguna, tugas, bug, dan masalah—lacak berbagai jenis informasi. Untuk informasi selengkapnya, lihat Dokumentasi Azure Boards.
Semua objek pelacakan item kerja dikaitkan dengan satu atau beberapa nama. Sebagian besar memiliki nama tampilan yang ramah, kecuali jenis item kerja dan daftar global, yang terkait dengan nama referensi. Nama yang mudah diingat adalah pengidentifikasi unik yang terlihat pengguna untuk bidang. Menggunakan nama yang mudah diingat memastikan konsistensi di seluruh proyek dan jenis item kerja dalam koleksi proyek. Sistem menggunakan nama referensi secara internal dan Anda tidak dapat mengubahnya setelah ditentukan.
Ada batasan pada beberapa elemen yang terkait dengan item kerja, termasuk nama referensi dan ramah, nama bidang, dan ukuran lampiran.
Jalur area dan perulangan
Dua bidang item kerja, Jalur Area dan Jalur Perulangan, menyediakan hierarki struktur pohon untuk pekerjaan pengelompokan. Jalur area mengelompokkan item kerja menurut area produk, fungsional, atau fitur. Jalur iterasi mengelompokkan item kerja ke dalam sprint, tonggak pencapaian, atau periode waktu untuk mengatasi item kerja tersebut.
Bidang multi-simpul ini menggunakan karakter garis \ miring terbalik untuk menunjukkan hierarki simpul dalam struktur pohon.
Nama yang Anda tetapkan ke simpul anak ke bidang ini harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| Panjang simpul | Tidak boleh berisi lebih dari 255 karakter. |
| Nama yang dicadangkan | - Tidak boleh hanya terdiri dari periode . atau dua periode ...- Tidak boleh berupa nama yang dicadangkan sistem, seperti PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON, atau AUX. Untuk informasi selengkapnya tentang nama yang dipesan, lihat Nama File, Jalur, dan Namespace. |
| Karakter khusus untuk simpul | - Tidak boleh berisi karakter kontrol Unicode. - Tidak boleh berisi salah satu karakter berikut: \ / : * ? " < > | # $ & * +.- Tidak boleh berisi karakter yang dilarang oleh sistem file lokal. Untuk informasi selengkapnya tentang pembatasan karakter Windows, lihat Penamaan File, Jalur, dan Namespace. |
| Panjang jalur | Tidak boleh berisi lebih dari 4.000 karakter Unicode. |
| Kedalaman hierarki jalur | Harus kurang dari 14 tingkat kedalaman. |
Lampiran
File yang dilampirkan ke item kerja harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| Ukuran file | Tidak boleh melebihi ukuran maksimum: - Ukuran maksimum default: 4.096 kilobyte. - Ukuran maksimum absolut: 2 gigabyte. |
| Jenis pembatasan | Pembatasan |
|---|---|
| Ukuran file | Tidak boleh melebihi ukuran maksimum: - Ukuran maksimum default: 4.096 kilobyte. - Ukuran maksimum absolut: 2 gigabyte. Untuk informasi selengkapnya, lihat Mengubah ukuran lampiran maksimum untuk item kerja. |
Nama kolom papan dan swimlane
Papan Anda mengubah backlog Anda menjadi papan nama interaktif, yang menyediakan alur kerja visual. Saat pekerjaan berlangsung dari ide ke penyelesaian, Anda memperbarui item di papan. Setiap kolom mewakili tahap kerja, dan setiap kartu mewakili cerita pengguna (kartu biru) atau bug (kartu merah) pada tahap pekerjaan tersebut.
Sesuaikan papan Anda dengan menambahkan, menghapus, atau mengganti nama kolom dan swimlanes. Kolom mendukung alur kerja di seluruh papan. Swimlanes memungkinkan Anda mengelola kelas pekerjaan yang berbeda sebagai jalur horizontal di papan.
Nama kolom dan swimlane harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| Panjang | Tidak boleh berisi lebih dari 256 karakter Unicode. |
| Keunikan | - Nama kolom tidak boleh sama dengan nama kolom lain di papan. - Nama Swimlane tidak boleh sama dengan nama baju renang lainnya di papan. |
| Karakter khusus | Tidak boleh berisi karakter kontrol Unicode atau karakter pengganti. |
Nama bidang
Setiap jenis item kerja berisi satu atau beberapa bidang item kerja. Bidang ini menentukan informasi yang disimpan untuk item kerja berdasarkan jenis item kerja. Setiap bidang item kerja memiliki nama referensi bidang terkait. Nama referensi bidang secara unik mengidentifikasi setiap bidang dan tidak dapat diubah setelah ditetapkan. Untuk informasi selengkapnya tentang bidang item kerja di luar kotak, lihat Indeks bidang item kerja.
Nama bidang item kerja harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| Panjang | Tidak boleh berisi lebih dari 128 karakter Unicode. |
| Keunikan | - Nama bidang harus berisi setidaknya satu karakter alfabet. - Tidak boleh berisi salah satu karakter berikut: . , ; ' : ~ \ / \ * ? " & % $ ! + = () [] {} <> - |.- Tidak boleh berisi spasi di depan atau di belakang. - Tidak boleh berisi dua atau lebih ruang berturut-turut. |
| Karakter khusus | Harus unik dalam organisasi atau koleksi proyek. Nama bidang item kerja dilingkup ke kumpulan proyek. Jika Anda mengganti nama bidang, Anda mengubahnya untuk semua item kerja dan WIT yang ditentukan dalam semua proyek dalam koleksi. |
Nama referensi bidang dan portabilitas
Bahasa definisi jenis item kerja mencakup konsep nama referensi bidang. Nama referensi bidang dapat membantu Anda untuk port definisi antara koleksi proyek Team Foundation dan juga untuk memungkinkan integrasi non-Microsoft menemukan dan merujuk ke bidang tertentu. Nama-nama ini unik secara global, sama seperti namespace dalam aplikasi .NET Framework unik secara global.
Namespace layanan Sistem hanya digunakan untuk menentukan semua bidang sistem inti yang wajib untuk fungsi sistem Team Foundation. Anda tidak dapat membuat bidang System.X Anda sendiri karena mungkin menghambat fungsionalitas.
Namespace layanan Microsoft digunakan untuk menentukan bidang pelacakan item kerja. Bidang ini didefinisikan dalam definisi jenis item kerja dari templat proses.
Pelanggan dan mitra dapat membuat namespace bidang mereka sendiri untuk jenis item kerja kustom. Untuk deskripsi bidang dan bidang sistem yang ditentukan dalam templat proses default, lihat Indeks bidang item kerja.
Penting
- Nama referensi bidang tidak dapat diganti namanya. Jika misalnya, Anda mengubah nama bidang "Judul" menjadi "Header", nama referensi bidang bidang tersebut tetap sama. Integrasi dan representasi internal bidang harus menggunakan nama referensi bidang alih-alih bergantung pada nama bidang itu sendiri.
- Meskipun Anda dapat membuat bidang Microsoft.X Anda sendiri, kami tidak menyarankan Anda melakukannya, karena mungkin menghambat fungsionalitas atau kemampuan wizard Konfigurasi Fitur agar berhasil memperbarui proyek setelah peningkatan.
Contoh nama referensi bidang
Contoh berikut menunjukkan nama referensi bidang yang valid, di berbagai namespace. Pelanggan dan mitra juga dapat menentukan namespace layanan mereka sendiri untuk mendukung jenis item kerja kustom mereka.
| Contoh namespace sistem | Contoh namespace microsoft | Contoh namespace lainnya |
|---|---|---|
| System.Id, System.Title, System.CreatedBy, System.CreatedDate, System.ChangedBy, System.ChangedDate, System.State, System.Reason | Microsoft.VSTS.Build.FoundIn, Microsoft.VSTS.Common.Activity, Microsoft.VSTS.Common.Discipline, Microsoft.VSTS.Common.Priority, Microsoft.VSTS.CMMI.TaskType, Microsoft.VSTS.TCM.AutomationStatus, Microsoft.VSTS.TCM.TestSuiteType | Perusahaan fiktif, Fabrikam Fiber, mungkin menentukan bidang item kerja kustom berikut: FabrikamFiber.Common.Severity, FabrikamFiber.Common.Phase, FabrikamFiber.RiskManagement.RiskType, FabrikamFiber.RiskManagement.Resolution Perusahaan perangkat lunak fiktif Contoso Corporation mungkin menentukan bidang item kerja berikut: Contoso.Common.BusinessPriority, Contoso.Bug.FoundInPhase, Contoso.Bug.FixInPhase |
Teks bantuan bidang
Sistem menampilkan teks bantuan pada waktu proses untuk membantu pengguna mengetahui apa yang harus dimasukkan ke dalam bidang. Teks bantuan dilingkup ke jenis item kerja tertentu dalam proyek tertentu.
Untuk proses Warisan, Anda menentukan teks bantuan untuk bidang melalui dialog Edit bidang , tab Definisi , Deskripsi. Lihat Menambahkan bidang kustom ke tipe item kerja. Untuk proses XML lokal, Anda menentukan teks bantuan dengan menggunakan HELPTEXT elemen . Lihat Menambahkan atau mengubah bidang untuk pelacakan kerja.
Teks bantuan yang Anda tambahkan harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| Panjang | Tidak boleh berisi lebih dari 255 karakter Unicode. |
Daftar global
Daftar global adalah sekumpulan nilai item daftar yang dapat Anda gunakan secara global di semua koleksi proyek dalam instans Azure DevOps Server lokal. Saat Anda menentukan jenis item kerja, Anda mungkin menemukan bahwa beberapa bidang item kerja berbagi kumpulan nilai yang diizinkan atau disarankan yang sama. Daftar global memungkinkan Anda menentukan nilai-nilai ini satu kali dan membagikannya di beberapa jenis item kerja dan proyek. Untuk detailnya, lihat Menentukan daftar global.
Daftar global, yang ditentukan menggunakan GLOBALLIST elemen berisi satu atau beberapa item daftar, yang ditentukan menggunakan LISTITEM elemen .
LISTITEM nama harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| Panjang | - Tidak boleh berisi lebih dari 254 karakter Unicode. - Tidak boleh kosong. |
| Karakter khusus | - Tidak boleh berisi spasi kosong di depan atau di belakang. - Tidak boleh berisi dua spasi berturut-turut. - Tidak boleh berisi karakter garis miring terbelakang \ . |
| Cakupan | Karena daftar global tersedia di antara semua proyek, daftar tersebut tidak boleh berisi elemen yang ditentukan di tingkat proyek, seperti definisi akun grup khusus proyek. |
Daftar global harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| Jumlah item | Tidak boleh kosong. Daftar global harus berisi setidaknya satu LISTITEM elemen. |
| Keunikan | Tidak boleh kosong. Daftar global harus berisi setidaknya satu LISTITEM elemen. |
Nama referensi jenis tautan dan kategori
Tentukan nama referensi setiap kali Anda menambahkan atau membuat jenis atau kategori tautan. Semua nama referensi dapat memiliki panjang hingga 70 karakter Unicode.
Tentukan nama referensi dengan menggunakan karakter alfanumerik, karakter garis bawah, dan karakter tanda hubung. Setiap nama referensi harus berisi setidaknya satu periode ., tetapi tidak ada titik yang dapat muncul di awal atau akhir nama. Nama referensi tidak boleh dimulai dengan angka atau garis bawah, dan tidak boleh memiliki beberapa tanda hubung berturut-turut, seperti --.
| Jenis pembatasan | Pembatasan |
|---|---|
| Panjang | Tidak boleh berisi lebih dari 70 karakter Unicode. |
| Keunikan | - Tidak boleh identik dengan nama referensi bidang lain dalam koleksi proyek. - Tidak boleh identik dengan nama referensi bidang lain setelah nama-nama tersebut diproses _oleh komputer untuk mengganti semua periode . dengan garis bawah . Misalnya, nama referensi bidang dan My.Field keduanya akan diproses My.*Field* dengan nama yang sama:My__Field |
| Karakter khusus | - Tidak boleh berisi tanda hubung -.- Harus berisi setidaknya satu periode ..- Tidak boleh memulai atau mengakhiri dengan titik ..- Tidak boleh dimulai dengan numberMust tidak dimulai dengan garis bawah _. |
Tag item kerja
Tag item kerja sesuai dengan satu atau dua frasa kata kunci untuk memfilter alat pelacakan kerja seperti backlog, papan, dan kueri atau menentukan kueri. Untuk informasi selengkapnya, lihat Menambahkan tag item kerja untuk mengategorikan dan memfilter daftar dan papan.
Nama tag harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| Panjang | - Tidak boleh berisi lebih dari 400 karakter Unicode. - Tidak boleh null atau kosong. |
| Karakter khusus | - Tidak boleh berisi karakter pemisah: , atau ;.- Tidak boleh berisi karakter kontrol atau format Unicode, seperti umpan baris, pemisah paragraf, pengembalian pengangkutan, atau karakter pengganti lain yang tidak cocok. |
| Cakupan | Karena daftar global tersedia di antara semua proyek, daftar tersebut tidak boleh berisi elemen yang ditentukan di tingkat proyek, seperti definisi akun grup khusus proyek. |
Azure Pipelines
Definisi Azure Pipeline harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| Nama pekerjaan | - Hanya boleh berisi karakter alfanumerik dan '_'.- Tidak boleh dimulai dengan angka. - Harus memiliki nama yang unik. - Tidak boleh berisi kata kunci, misalnya: "penyebaran." |
| Nama Tahapan | - Hanya boleh berisi karakter alfanumerik dan '_'.- Tidak boleh dimulai dengan angka. - Tidak boleh berisi kata kunci, misalnya: "penyebaran." |
| Expressions | Harus dimulai dengan a-Z atau _AND, diikuti oleh a-Z, , 0-9atau _. |
Untuk informasi selengkapnya, lihat dokumentasi Azure Pipelines.
Azure Repos (Git)
Setiap proyek Azure DevOps dapat berisi beberapa repositori Git. Nama yang Anda tetapkan ke repositori Git harus sesuai dengan batasan berikut. Untuk informasi selengkapnya, lihat Dokumentasi Azure Repos Git. Untuk informasi selengkapnya tentang penamaan pembatasan untuk item Git lainnya seperti cabang dan tag, lihat git check-ref-format.
Penting
Meskipun Anda dapat menyertakan spasi dalam nama repositori, kami tidak menyarankan Anda melakukannya.
| Jenis pembatasan | Pembatasan |
|---|---|
| Panjang | Tidak boleh berisi lebih dari 64 karakter Unicode. |
| Keunikan | Tidak boleh identik dengan nama repositori Git lainnya dalam proyek. |
| Karakter khusus | - Tidak boleh berisi karakter kontrol Unicode atau karakter pengganti. - Tidak boleh berisi karakter yang dapat dicetak berikut: \ / : * ? " < > ; # $ * { } , + = [ ] |.- Tidak boleh dimulai dengan garis bawah _.- Tidak boleh memulai atau mengakhiri dengan titik ..- Tidak boleh nama yang dicadangkan sistem. |
Azure Repos (TFVC)
Kontrol versi Team Foundation (TFVC) menyediakan repositori pusat untuk file dan perintah yang diperlukan untuk mengelola file tersebut di seluruh tim. Ini juga menyediakan kebijakan check-in yang dapat disesuaikan, percabangan, penggabungan, rak, dan banyak fitur lainnya. Untuk informasi selengkapnya, lihat dokumentasi Azure Repos TFVC
Jalur kontrol versi harus sesuai dengan batasan berikut. Lihat juga Mengoptimalkan ruang kerja Anda.
| Jenis pembatasan | Pembatasan |
|---|---|
| Panjang jalur folder kontrol sumber server | - Tidak boleh berisi lebih dari 259 karakter Unicode untuk satu folder atau nama file. - Tidak boleh berisi lebih dari 388 karakter Unicode untuk direktori. - Tidak boleh berisi lebih dari 399 karakter Unicode untuk direktori gabungan dan nama file. |
| Panjang jalur folder lokal | - Tidak boleh berisi lebih dari 248 karakter Unicode untuk direktori. - Tidak boleh berisi lebih dari 260 karakter Unicode untuk direktori gabungan dan nama file. |
| Portal web dan pembatasan panjang khusus REST | Tidak boleh berisi lebih dari 215 karakter Unicode untuk nama proyek gabungan, direktori, dan nama file. |
Di portal web dan REST API, operasi tertentu memiliki panjang jalur yang lebih ketat daripada Visual Studio dan klien TF.exe. Operasi ini termasuk Edit, Ganti Nama, dan Hapus, dan terjadi karena portal web/REST menggunakan ruang kerja yang dihasilkan secara acak untuk konkurensi saat menunggu perubahan.
File TFVC
Sistem kontrol versi menyimpan berbagai jenis file. Siapkan kontrol versi Team Foundation di komputer pengembangan Anda menyediakan detail tentang cara menambahkan proyek atau solusi Visual Studio yang ada.
File dan folder yang Anda tambahkan ke kontrol versi Team Foundation harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| File dan folder | - Nama tidak boleh berisi karakter yang dapat dicetak berikut: \ / : * ? " < > ;.- Folder tidak boleh berada di luar direktori yang dipetakan untuk ruang kerja aktif. |
| Nama file | - Tidak boleh dimulai dengan $.- Tidak boleh berisi karakter yang dapat dicetak berikut: \ / : * ? " < > ; |. |
Label TFVC
Dalam kontrol versi Team Foundation (TFVC), label adalah nama yang diterapkan ke serangkaian revisi tertentu. Anda dapat melampirkan label ke sekumpulan file yang tidak terkait dalam kontrol versi, yang memungkinkan Anda mengambil file atau bertindak sebagai grup. Tabel berikut ini menjelaskan batasan yang diletakkan pada nama label.
| Jenis pembatasan | Pembatasan |
|---|---|
| Panjang | Tidak boleh berisi lebih dari 64 karakter Unicode. |
| Karakter khusus | - Tidak dapat diakhir dengan spasi ( ) atau titik ..- Tidak boleh berisi karakter yang dapat dicetak berikut: \ / : * ? " < > ; @ |. |
TFVC Shelvesets
Shelvesets memungkinkan Anda untuk menyisihkan sementara batch perubahan yang tertunda lalu, sebagai opsi, menghapus perubahan yang tertunda dari ruang kerja Anda. Nantinya, Anda dapat memulihkan perubahan di shelveset ke ruang kerja Anda atau memasukkannya ke ruang kerja pengguna lain.
Nama shelveset harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| Panjang | Tidak boleh berisi lebih dari 64 karakter Unicode. |
| Karakter khusus | Tidak boleh berisi karakter yang dapat dicetak berikut: \ / : * ? " < > & ; |. |
Ruang kerja TFVC
Ruang kerja adalah salinan file dan folder sisi klien di kontrol versi Team Foundation (TFVC). Saat membuat beberapa ruang kerja, Anda dapat memiliki versi folder kontrol versi yang sama yang berbeda di komputer klien. Membuat dan bekerja dengan ruang kerja memberikan detail selengkapnya.
Nama ruang kerja harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| Panjang | Tidak boleh berisi lebih dari 64 karakter Unicode. |
| Karakter khusus | - Tidak boleh diakhir dengan spasi ( ).- Tidak boleh berisi karakter yang dapat dicetak berikut: \ / : * ? " < > ; |. |
Nama komputer
Nama komputer tempat Anda menginstal Azure DevOps dikaitkan dengan nama server. Baik sistem operasi maupun Direktori Aktif memberlakukan pembatasan tertentu pada nama komputer seperti yang dijelaskan dalam artikel ini:
Nama Organisasi
Penting
Patuhi panduan berikut saat Anda membuat nama organisasi.
- Hanya gunakan huruf dari alfabet bahasa Inggris
- Memulai nama organisasi Anda dengan huruf atau angka
- Menggunakan huruf, angka, atau tanda hubung setelah karakter awal
- Pastikan organisasi Anda tidak melebihi 50 karakter Unicode
- Diakhir dengan huruf atau angka
Jika Anda menggunakan salah satu karakter yang tidak diizinkan, Anda mendapatkan pesan kesalahan berikut: VS850015: Nama yang ditentukan tidak diizinkan untuk digunakan: {Nama organisasi}.
Templat proses dan proses
Proses menentukan blok penyusun sistem pelacakan item kerja dan subsistem lain yang dapat Anda akses setelah menyambungkan ke proyek.
Catatan
Terminologi: "proses" dan "templat proses" mengacu pada sekumpulan file yang saling bergantung yang digunakan untuk membuat proyek. Untuk informasi selengkapnya, lihat Tentang proses dan templat proses, yang menjelaskan perbedaan di antara tiga proses default yang tersedia untuk Anda.
Proses yang Anda tentukan atau sesuaikan harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| Panjang | Tidak boleh berisi lebih dari 256 karakter Unicode. |
| Keunikan | - Harus unik di seluruh Azure DevOps. - Jika Anda mengunggah templat dengan nama yang sama dengan templat yang ada, templat yang ada akan ditimpa. |
| Memproses ukuran file templat | Tidak boleh melebihi 2 GB (gigabyte). |
Koleksi proyek
Kumpulan proyek mengidentifikasi sekelompok proyek dan sumber daya yang terkait dengan proyek tersebut. Ini menyediakan struktur pengorganisasian yang dapat Anda gunakan untuk menentukan dan mengontrol sekelompok proyek yang ditentukan untuk Azure DevOps Server.
Selain itu, nama koleksi adalah bagian dari string koneksi yang digunakan untuk menghubungkan anggota tim ke proyek. Default yang ditetapkan sesuai dengan DefaultCollection. Mengelola koleksi proyek menyediakan informasi lebih lanjut.
Nama yang Anda tetapkan ke koleksi proyek harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| Panjang | Tidak boleh berisi lebih dari 64 karakter Unicode. |
| Keunikan | - Tidak boleh identik dengan nama koleksi lain dalam penyebaran lokal Anda. - Jika penyebaran Anda menyertakan Produk SharePoint atau SQL Server Reporting Services, penyebaran tersebut tidak bisa identik dengan nama dan jalur lengkap situs SharePoint, server laporan, atau situs web Reporting Services yang sudah ada. |
| Nama yang dicadangkan | Tidak boleh berupa nama yang dicadangkan sistem. |
| Karakter khusus | - Tidak boleh berisi karakter kontrol Unicode atau karakter pengganti. - Tidak boleh berisi karakter yang dapat dicetak berikut: \ / : * ? " < > ; # $ * { } , + = [ ] |. - Tidak boleh mengandung elipsis ... atau periode ..ganda .- Tidak boleh dimulai dengan garis bawah _.- Tidak boleh memulai atau mengakhiri dengan titik .. |
Nama proyek
Proyek membangun repositori untuk kode sumber dan tempat bagi tim untuk merencanakan, melacak kemajuan, dan berkolaborasi. Nama proyek adalah bagian dari string koneksi digunakan untuk menghubungkan anggota tim ke proyek.
Nama yang Anda tetapkan ke proyek yang Anda buat harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| Panjang | Tidak boleh berisi lebih dari 64 karakter Unicode. |
| Keunikan | Tidak boleh identik dengan nama lain dalam koleksi proyek, aplikasi Web SharePoint yang mendukung koleksi, atau instans SQL Server Reporting Services yang mendukung koleksi. |
| Nama cadangan | - Tidak boleh nama yang dicadangkan sistem. - Tidak boleh menjadi salah satu segmen tersembunyi yang digunakan untuk pemfilteran permintaan IIS seperti App_Browsers, App_code, App_Data, App_GlobalResources, App_LocalResources, App_Themes, App_WebResources, bin, atau web.config. |
| Karakter khusus | - Tidak boleh berisi karakter kontrol Unicode atau karakter pengganti. - Tidak boleh berisi karakter yang dapat dicetak berikut: \ / : * ? " < > ; # $ * { } , + = [ ] |. - Tidak boleh dimulai dengan garis bawah _.- Tidak boleh memulai atau mengakhiri dengan titik .. |
Kelompok keamanan
Dengan grup keamanan Azure DevOps, Anda dapat menerapkan hak atau izin tertentu ke sekelompok pengguna.
Grup lokal mungkin terdiri dari akun grup Direktori Aktif, grup keamanan Azure DevOps, akun pengguna Windows, akun grup Windows, atau campuran apa pun dari jenis ini. Untuk informasi selengkapnya, lihat Menambahkan pengguna atau grup Active Directory/ Microsoft Entra ke grup keamanan bawaan.
Kelompok keamanan harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| Panjang nama akun grup keamanan | Tidak boleh berisi lebih dari 256 karakter Unicode. |
| Keunikan | - Akun grup tingkat proyek tidak boleh cocok dengan nama grup lain dalam proyek yang sama. - Akun grup tingkat koleksi tidak boleh cocok dengan nama lain dari akun grup dalam koleksi proyek. |
| Nama grup yang dicadangkan | Tidak boleh dinamai dengan $NAMESPACE pada tingkat proyek atau server. |
| Karakter khusus | - Tidak boleh berisi karakter kontrol Unicode atau karakter pengganti. - Tidak boleh berisi karakter yang dapat dicetak berikut: / \ [ ] : < > + = ; ? * |. - Tidak boleh menyertakan karakter yang tidak dapat dicetak dalam rentang nilai ASCII 1-31. - Tidak boleh berakhir dalam satu titik ..- Tidak boleh menyertakan koma ,. |
Team Foundation Build
Team Foundation Build memungkinkan Anda mengelola semua aspek proses build pada satu komputer. Dengan menggunakan Team Foundation Build, Anda dapat menyinkronkan sumber, mengkompilasi aplikasi, menjalankan pengujian unit terkait, melakukan analisis kode, merilis build di server file, dan menerbitkan laporan build.
Bangun komputer
Team Foundation Build adalah penginstalan terpisah dari tingkat aplikasi Azure DevOps Server, tingkat data, atau klien Visual Studio. Anda dapat memilih komputer terpisah. Jika tidak, Anda dapat menginstal build secara berdampingan di komputer klien atau di server.
Komputer build lokal Anda harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| Ruang disk | Harus berisi ruang yang cukup untuk build (ruang yang tidak mencukupi menyebabkan build yang gagal). |
| Buat direktori | Harus berupa jalur lokal (misalnya, C:\BuildDirectory). |
| Jatuhkan direktori lokasi | Harus berupa jalur UNC (misalnya, \server\share). |
| Hilangkan izin lokasi | Setiap build yang dihasilkan dimasukkan ke direktori baru di folder drop. - Akun Team Foundation Server Service (misalnya, Domain\TFSSERVICE) harus memiliki akses izin Kontrol Penuh ke lokasi drop UNC.- Lokasi drop UNC harus berupa folder bersama. |
| Akun Team Foundation Build Service | Jika Anda mengubah akun Layanan TFS setelah penginstalan awal, Anda harus memastikan bahwa kondisi berikut ini benar: - Akun adalah anggota grup Build Services. - Akun memiliki izin baca/tulis ke folder sementara dan folder sementara ASP.NET. - Akun memiliki izin Kontrol Penuh ke direktori build dan lokasi drop. |
| Masalah firewall | Jika komputer build diaktifkan firewall, pastikan bahwa program, tfsbuildservice, ada dalam daftar pengecualian. |
Jenis build
Jenis build mengonfigurasi kondisi di mana satu solusi atau sekumpulan solusi dalam proyek dibangun. Untuk melakukan build, Anda harus membuat jenis build baru atau menggunakan jenis build yang ada.
Nama jenis build harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| Keunikan | Tidak boleh sama dengan nama jenis build lainnya dalam proyek. |
| Karakter khusus | Tidak boleh berisi karakter yang dapat dicetak berikut: $. |
Membangun kualitas
Kualitas build memungkinkan Anda melampirkan tingkat kualitas atau status penyelesaian ke build yang telah selesai. Team Foundation Build juga memungkinkan Anda membuat nilai baru untuk jenis kualitas build. Lihat Menilai kualitas build yang telah selesai untuk daftar nilai kualitas build default.
Nama kualitas build harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| Panjang | Tidak boleh berisi lebih dari 256 karakter Unicode. |
| Keunikan | Tidak boleh sama dengan nama Kualitas Build lainnya di komputer Team Foundation Build. |
Nama tim
Nama tim mengidentifikasi sekelompok individu atau grup yang secara kolektif bekerja sama sebagai tim dalam proyek. Anggota tim menggunakan nama ini untuk menyambungkan ke tim atau untuk mengkueri anggota yang ditentukan untuk tim.
Nama tim harus sesuai dengan konvensi yang memungkinkan mereka dirender sebagai bagian dari URL yang valid. Setiap nama tim harus unik dalam satu proyek. Namun, tidak ada batasan untuk menggunakan nama tim yang sama dalam proyek yang berbeda dalam koleksi proyek. Untuk informasi selengkapnya, lihat Menambahkan tim lain atau hierarki tim.
Nama tim harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| Panjang | Tidak boleh berisi lebih dari 64 karakter Unicode. |
| Keunikan | Tidak boleh identik dengan nama lain dalam proyek. |
| Nama yang dicadangkan | Tidak boleh berupa nama yang dicadangkan sistem. |
| Karakter khusus | - Tidak boleh berisi karakter kontrol Unicode atau karakter pengganti. - Tidak boleh berisi karakter yang dapat dicetak berikut: \ / : * ? " < > ; # $ * { } , + = [ ] |.- Tidak boleh mengandung elipsis ... atau periode ..ganda .- Tidak boleh dimulai dengan garis bawah _.- Tidak boleh memulai atau mengakhiri dengan titik .. |
Nama akun pengguna
Akun pengguna mengidentifikasi orang yang ditambahkan ke koleksi proyek atau proyek. Akun pengguna mungkin sesuai dengan entri dalam Direktori Aktif, ID Microsoft Entra, grup server Windows.
Akun pengguna yang Anda tambahkan ke organisasi atau koleksi harus sesuai dengan batasan berikut. Untuk menambahkan akun pengguna ke proyek, lihat Menambahkan pengguna ke proyek atau tim.
| Jenis pembatasan | Pembatasan |
|---|---|
| Panjang nama akun | Tidak boleh berisi lebih dari 256 karakter Unicode. |
| Keunikan | Tidak boleh cocok dengan akun pengguna lain yang ditambahkan ke koleksi proyek. |
| Nama grup yang dicadangkan | Tidak boleh dinamai dengan $NAMESPACE pada proyek atau tingkat server. |
| Karakter khusus | - Tidak boleh menyertakan karakter yang dapat dicetak berikut: "/ \ [ ] : < > + = ; ? * |.- Tidak boleh menyertakan karakter yang tidak dapat dicetak dalam rentang nilai ASCII 1-31. - Tidak boleh berakhir dalam tanda periode . atau dolar $.- Tidak boleh menyertakan koma ,.- Tidak boleh menyertakan kategori Unicode berikut: LineSeparator, ParagraphSeparator, Control, Format, OtherNotAssigned. |
Halaman Wiki dan nama file
Setiap halaman wiki sesuai dengan file dalam repositori wiki Git. Nama yang Anda tetapkan ke judul halaman wiki harus sesuai dengan batasan berikut.
| Jenis pembatasan | Pembatasan |
|---|---|
| Nama file | Jalur halaman yang sepenuhnya memenuhi syarat tidak boleh melebihi 235 karakter. |
| Keunikan | Judul halaman peka huruf besar/kecil dan harus unik dalam hierarki wiki. |
| Karakter khusus | - Tidak boleh berisi karakter kontrol Unicode atau karakter pengganti. - Tidak boleh berisi karakter yang dapat dicetak berikut: / \ #.- Tidak boleh memulai atau mengakhiri dengan titik .. |
| Ukuran file | Tidak boleh melebihi maksimum 18 MB. |
| Ukuran file lampiran | Tidak boleh melebihi maksimum 19 MB. |
Karakter khusus dalam judul halaman Wiki
Anda dapat menentukan judul halaman yang berisi satu atau beberapa karakter : < > * ? | -khusus ini . Misalnya, Anda dapat memberi nama file Markdown sebagai "FAQ?" atau "Panduan penyiapan". Karakter memiliki string yang dikodekan URI berikut:
| karakter | String yang dikodekan |
|---|---|
: |
%3A |
< |
%3C |
> |
%3E |
* |
%2A |
? |
%3F |
| |
%7C |
- |
%2D |
" |
22% |