Mengganti nama proyek di Azure DevOps

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

  1. Masuk ke proyek Anda (https://dev.azure.com/{Your_Organization}/{Your_Project}).

  2. PilihGambaran Umum> proyek, masukkan nama baru, dan pilih Simpan.

    Cuplikan layar memperlihatkan entri nama baru dan tombol simpan yang disorot.

  3. Untuk mengonfirmasi penggantian nama, masukkan nama proyek baru, centang kotak di samping, "Saya memahami konsekuensi mengganti nama proyek ini," lalu pilih Simpan.

    Cuplikan layar memperlihatkan layar konfirmasi nama baru dengan tombol 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 40 https://dev.azure.com/MyOrg/Example2/_workitems/edit/40/ — Menampilkan item kerja 40 https://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:

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:

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.

Cuplikan layar penjelajah kontrol versi, menunjukkan pilihan 'dapatkan versi terbaru'.

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.