Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022
Saat Anda mengganti nama proyek di Azure DevOps, nama proyek diperbarui di jalur kontrol versi, item kerja, kueri, dan artefak proyek lainnya. Anda dapat mengganti nama satu proyek beberapa kali dan menggunakan nama lama. Setelah Anda mengganti nama proyek, beberapa tindakan mungkin diperlukan dari anggota tim.
Peringatan
Saat Anda mengganti nama proyek, Azure DevOps mengirim pemberitahuan email ke semua anggota proyek jika jumlah pengguna kurang dari 1.000. Untuk proyek dengan lebih dari 1.000 pengguna, hanya Administrator Koleksi Proyek yang menerima pemberitahuan ini.
Mengganti nama proyek dapat mengganggu subjek federasi identitas beban kerja dalam hubungan layanan Azure Resource Manager.
Petunjuk
Anda dapat menggunakan AI untuk membantu tugas ini nanti dalam artikel ini, atau lihat Mengaktifkan bantuan AI dengan Azure DevOps MCP Server untuk memulai.
Prasyarat
| Kategori | Persyaratan |
|---|---|
| Permissions | Anggota grup Administrator Proyek atau perizinan mengganti nama proyek di tingkat proyek diatur ke Izinkan. Untuk informasi lebih lanjut, lihat Mengubah izin tingkat proyek. |
Mengganti nama proyek
Masuk ke proyek Anda (
https://dev.azure.com/{Your_Organization}/{Your_Project}).PilihGambaran Umum> proyek, masukkan nama baru, dan pilih Simpan.
Untuk mengonfirmasi penggantian nama, masukkan nama proyek baru, centang kotak di samping, "Saya memahami konsekuensi mengganti nama proyek ini," lalu pilih Simpan.
Hasil penggantian nama
Setelah penggantian nama selesai:
URL terus berfungsi untuk nama proyek lama dan baru, sehingga tautan yang ada tidak rusak.
Tautan ke item kerja tidak kedaluwarsa karena ID item kerja unik di seluruh organisasi, tidak terbatas pada satu proyek. Nama proyek yang valid dalam URL menyelesaikan item kerja:
https://dev.azure.com/MyOrg/Example1/_workitems/edit/40/— Menampilkan item kerja 40https://dev.azure.com/MyOrg/Example2/_workitems/edit/40/— Menampilkan item kerja 40https://dev.azure.com/MyOrg/Potato/_workitems/edit/40/— Mengembalikan kesalahan 404 (proyek tidak valid)Nama proyek lama menjadi tersedia untuk digunakan kembali.
Tindakan pengguna yang diperlukan untuk bekerja dengan proyek yang diganti namanya
Setiap pengguna dalam tim Anda harus memulai ulang klien mereka dan kemudian menyelesaikan tindakan berikut mana pun yang berlaku:
- Memperbarui remote Git — jika proyek Anda menggunakan repositori Git
- Memperbarui ruang kerja server TFVC — jika proyek Anda menggunakan TFVC dengan ruang kerja server
- Memperbarui ruang kerja lokal TFVC — jika proyek Anda menggunakan TFVC dengan ruang kerja lokal
- Update umpan OData — jika Anda menyambungkan laporan Power BI melalui OData
- Memperbarui tampilan Analitik — jika Anda membuat tampilan Analitik kustom
Memulai ulang klien
Klien yang dibuka menyimpan cache semua nama proyek dalam memori, tetapi cache ini tidak secara otomatis dihapus setelah proyek diganti namanya. Untuk menghapus cache, mulai ulang klien Anda sehingga mengisi nama proyek baru. Jika Anda tidak memulai ulang klien, operasi yang menggunakan nama proyek yang di-cache gagal dengan proyek tidak menemukan pengecualian.
Untuk klien berikut, simpan pekerjaan Anda di masing-masing lalu mulai ulang:
- Visual Studio Team Explorer
- Microsoft Excel, jika tim Anda menggunakan Azure DevOps Office Integration 2019
Memperbarui remote Git
Jika proyek Anda menggunakan Git, perbarui referensi jarak jauh Anda untuk setiap repositori dari proyek yang diganti namanya. Pembaruan ini diperlukan karena URL repositori jarak jauh berisi proyek dan nama repositori. Git menggunakan referensi jarak jauh untuk mengambil dan mendorong perubahan antara repositori lokal Anda dan versi jarak jauh yang disimpan di server. Setiap anggota tim Anda harus memperbarui repositori Git lokal mereka untuk terus terhubung dari komputer dev mereka.
Untuk informasi selengkapnya, lihat Memperbarui remote Git di komputer dev Anda.
Memperbarui ruang kerja server TFVC
Jika proyek Anda menggunakan TFVC dengan ruang kerja server, perbarui ruang kerja ini dengan nama proyek baru. Untuk klien Visual Studio, jalankan operasi 'get' atau 'check-in'. Pemetaan ruang kerja kemudian diperbarui untuk menggunakan nama proyek baru.
Untuk informasi selengkapnya, lihat Perintah ganti nama (TFVC).
Memperbarui ruang kerja lokal TFVC
Jika tim Anda menggunakan TFVC dengan ruang kerja lokal, perbarui ruang kerja ini dengan nama proyek baru. Untuk Visual Studio, jalankan operasi get atau check-in. Pemetaan ruang kerja kemudian diperbarui untuk menggunakan nama proyek baru.
Perbarui klien Anda ke pembaruan atau rilis terbaru, jika memungkinkan. Untuk semua versi Visual Studio lain yang didukung, buat ruang kerja lokal baru yang dipetakan ke nama proyek baru.
Ruang kerja lokal dikelola secara lokal dan bukan di server. Klien lama tanpa logika penggantian nama yang diperbarui tidak dapat memperbarui ruang kerja lokal ke nama proyek baru.
Memperbarui umpan OData
Jika Anda menggunakan umpan OData di Power BI, perbarui URL umpan untuk menggunakan nama proyek baru. Memperbarui URL umpan sangat penting untuk mempertahankan koneksi data dan menghindari kesalahan dalam pelaporan. Untuk informasi selengkapnya, lihat Gambaran umum dari laporan sampel yang menggunakan kueri OData.
Memperbarui tampilan Analitik
Jika Anda membuat tampilan Analytics kustom menggunakan nama proyek lama, perbarui tampilan dengan nama baru. Untuk informasi selengkapnya, lihat Tampilan analitik.
Menggunakan AI untuk mengelola penggantian nama proyek
Petunjuk
Anda dapat menggunakan AI untuk membantu tugas ini nanti dalam artikel ini, atau lihat Mengaktifkan bantuan AI dengan Azure DevOps MCP Server untuk memulai.
Jika Anda menggunakan GitHub Copilot, Azure DevOps MCP Server dapat membantu Anda merencanakan dan menjalankan perubahan nama proyek dan menangani semua tindakan tindak lanjut melalui perintah bahasa alami.
Contoh perintah untuk mengganti nama proyek
| Tugas | Contoh tanggapan |
|---|---|
| Merencanakan penggantian nama dengan analisis dampak | I need to rename my Azure DevOps project from 'ProjectAlpha' to 'Platform-Core'. List everything that breaks, including Git remotes, TFVC workspaces, OData feeds, and service connections, and give me a step-by-step remediation plan |
| Mengomunikasikan penggantian nama ke tim | Draft an announcement for my team explaining that our Azure DevOps project is being renamed, what actions each developer needs to take to update their Git remotes and local workspaces, and a timeline for the change |
| Memperbaiki koneksi layanan yang rusak | After renaming my project, my Azure Resource Manager service connections using workload identity federation stopped working. Walk me through updating the federation subjects to use the new project name |
| Memperbarui remote Git secara massal | Generate a script I can share with my team that detects their current Git remote URLs pointing to the old project name and updates them to use the new project name |
| Memperbarui pelaporan setelah mengganti nama | I renamed my project and now my Power BI dashboards connected through OData show errors. Guide me through updating the Analytics views and OData feed URLs to use the new project name |
| Pulihkan dari penggantian nama yang bermasalah | I renamed a project but some team members can't open their TFVC local workspaces anymore. Help me understand why and walk me through the steps to fix both server and local workspaces |
Petunjuk
Untuk hasil terbaik, gunakan perintah ini dalam mode agen dengan Azure DevOps MCP Server yang terhubung. Sesuaikan perintah dengan nama proyek, ukuran tim, atau sistem kontrol versi spesifik Anda.
Pertanyaan Umum
T: Mengapa upaya saya untuk menggunakan kembali nama proyek gagal karena ruang kerja yang ada?
A: Anda tidak dapat menggunakan kembali nama proyek jika pemetaan ruang kerja masih mengatasinya. Fungsi ini membantu menghindari kasus ambiguitas di mana ruang kerja dapat dipetakan ke dua proyek. Hubungi pengguna yang memiliki pemetaan ini, dan hapus atau perbarui untuk menggunakan nama baru.
Jika komputer pengguna yang berisi ruang kerja tidak lagi tersedia, hapus ruang kerja dengan menjalankan perintah berikut dari prompt perintah pengembang Visual Studio: tf workspace /delete [/collection:TeamProjectCollectionUrl] workspacename[;workspaceowner]
T: Bagaimana cara mengganti nama proyek memengaruhi pengalaman navigasi browser saya?
A: Setelah Anda mengganti nama proyek, browser apa pun dengan proyek yang dibuka mungkin mengalami beberapa kesalahan. Kesalahan ini disebabkan oleh cache yang disimpan oleh browser, yang mencakup nama proyek lama. Refresh untuk membuat kesalahan ini hilang karena cache diisi ulang dengan nama proyek baru.
T: Apakah artefak lain dalam proyek diganti namanya?
A: Ya, semua artefak yang memiliki nama yang sama diganti namanya bersama dengan proyek. Satu-satunya pengecualian adalah untuk tim default dan repositori. Penggantian nama artefak ini dilakukan sebagai upaya terbaik. Misalnya, jika proyek Foo diganti namanya menjadi Bar, tim default Foo tidak akan diganti namanya jika tim bernama Bar sudah ada dalam proyek.