Menghapus proyek

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Jika proyek menjadi usang, Anda dapat menghapusnya dari organisasi atau koleksi Anda di Azure DevOps. Jika Anda bermigrasi dari Azure DevOps Server lokal ke Azure DevOps Services, Anda mungkin juga perlu menghapus proyek. Menghapus proyek yang tidak digunakan dapat meningkatkan navigasi dengan membatasinya hanya pada proyek yang saat ini sedang digunakan.

Perhatian

  • Proyek yang dihapus secara lunak dari portal web akan dihapus secara permanen jika tidak dipulihkan dalam waktu 28 hari.
  • Dalam kasus yang jarang terjadi, proses penghapusan kami mungkin memakan waktu hingga 70 hari karena percobaan ulang backend dan kebutuhan untuk menghapus data dari beberapa sumber.
    • Untuk menentukan apakah proyek yang dihapus sementara telah dihapus secara permanen, periksa untuk melihat apakah proyek tersebut Recently deleted projects muncul dalam daftar di halaman Gambaran Umum di bawah Pengaturan Organisasi. Jika proyek tidak muncul, proyek telah dihapus secara permanen dan tidak dapat dipulihkan.
  • Proyek yang dihapus secara permanen dari Konsol Administrasi Azure DevOps lokal tidak dapat dipulihkan. Untuk informasi selengkapnya, lihat Memulihkan proyek dan Menyimpan data proyek.

Petunjuk

Anda dapat menggunakan AI untuk membantu Anda dalam tugas ini nanti dalam artikel ini, atau lihat Mengaktifkan dukungan AI dengan Azure DevOps MCP Server untuk memulai.

Prasyarat

Kategori Persyaratan
Permissions - Anggota grup Administrator Koleksi Proyek. Pemilik organisasi adalah anggota grup ini secara otomatis.
- Hapus pengaturan izin proyek tim ke Izinkan. Untuk informasi lebih lanjut, lihat Melihat izin tingkat proyek.
Fakultatif Simpan data proyek sebelum menghapus proyek jika Anda ingin mengakses data proyek tanpa memulihkannya.
Kategori Persyaratan
Permissions Hapus pengaturan izin proyek tim untuk Mengizinkan. Untuk informasi selengkapnya, lihat Menampilkan izin.
Fakultatif Simpan data proyek, karena menghapus proyek menghasilkan kehilangan data yang tidak dapat diubah.

Menyimpan data proyek

Gunakan prosedur berikut untuk menyimpan data yang paling dipedulikan pengguna, seperti kode sumber, data build, dan item kerja. Prosedur ini bersifat opsional dan sesuatu yang mungkin Anda pertimbangkan sebelum menghapus proyek.

  • Kode sumber dan templat build kustom: Unduh file Anda sebagai file zip. Pilih Tindakan repositori untuk repositori, file, atau folder dan pilih Unduh sebagai Zip. Atau, pilih Unduh untuk mengunduh semua file di folder yang saat ini dipilih, atau file yang saat ini dipilih.

    Cuplikan layar Mengunduh kode.

    Proses ini tidak menyimpan riwayat perubahan atau tautan apa pun ke artefak lain. Jika Anda menggunakan Git, kloning repositori Anda untuk mempertahankan riwayat proyek lengkap dan semua cabang.

  • Membangun data: Untuk menyimpan log dan data di folder build drop Anda, lihat Melihat hasil build.

  • Data pelacakan item kerja: Buat kueri item kerja dan buka gunakan Excel. Simpan spreadsheet Excel.

    Proses ini tidak menyimpan lampiran, riwayat perubahan, atau tautan apa pun ke artefak lain.

Untuk informasi selengkapnya, lihat Gambaran Umum Perlindungan Data kami.

Menghapus proyek

Gunakan browser web Anda untuk melakukan penghapusan sementara. Setelah 28 hari, proyek akan dihapus secara permanen jika tidak dipulihkan dalam waktu tersebut.

  1. Masuk ke organisasi Anda (https://dev.azure.com/{yourorganization}).

  2. Pilih ikon roda gigi Pengaturan organisasi.

    Cuplikan layar pilihan, Pengaturan organisasi.

  3. Pilih Proyek, periksa satu atau beberapa proyek untuk dihapus, lalu pilih Hapus.

    Cuplikan layar urutan Proyek yang dipilih, periksa setiap proyek, dan hapus.

  4. Konfirmasi penghapusan dengan memasukkan nama proyek, lalu pilih Hapus di layar popup.

    Cuplikan layar popup konfirmasi untuk menghapus proyek.

Proyek Anda dihapus dan dapat dipulihkan hingga 28 hari setelahnya. Proyek yang dihapus dihapus dari daftar proyek Anda.

Menghapus laporan yang tersisa setelah menghapus proyek

Jika proyek Anda menggunakan pelaporan SQL Server dan tidak menghapus artefak eksternal, Anda dapat menghapus laporan menggunakan SQL Server Report Manager. Dari halaman kumpulan proyek, hapus folder yang sesuai dengan proyek yang dihapus.

Cuplikan layar menu konteks dengan perintah hapus.

Memulihkan proyek yang dihapus

Jika Anda secara tidak sengaja menghapus proyek di Azure DevOps, Anda dapat memulihkannya dalam waktu 28 hari setelah penghapusannya.

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

  2. Pilih ikon roda gigi Pengaturan organisasi.

    Cuplikan layar memperlihatkan ikon roda gigi, pengaturan organisasi.

  3. Pilih Gambaran Umum, lalu gulir ke bawah ke "proyek yang baru dihapus."

    Cuplikan layar yang memperlihatkan proyek yang baru dihapus.

  4. Sorot proyek yang ingin Anda pulihkan, lalu pilih Pulihkan.

    Cuplikan layar memperlihatkan proyek yang disorot, dan tombol Pulihkan.

  1. Masuk ke instans Anda (http://{ServerName:8080/tfs/}/{CollectionName}).

  2. Pilih ikon roda gigi Pengaturan Admin.

    Cuplikan layar memperlihatkan tombol Pengaturan admin dikelilingi oleh kotak merah.

  3. Pilih Proyek, lalu gulir ke bawah ke Proyek yang baru dihapus.

  4. Sorot proyek yang ingin Anda pulihkan, lalu pilih Pulihkan.

    Screenshot memperlihatkan cara Menyoroti proyek, lalu pilih Pulihkan untuk Azure DevOps Server.

Pulihkan proyek dengan REST API

Peringatan

Untuk memulihkan proyek dengan nama yang sudah ada, ganti nama proyek terlebih dahulu. Untuk mengganti nama proyek, masukkan teks berikut dalam isi permintaan: "name":"new name".

  1. Dapatkan daftar proyek yang dihapus menggunakan permintaan berikut:

    GET 'https://dev.azure.com/{organization}/_apis/projects?stateFilter=deleted&api-version=7.2-preview.4'

  2. Pulihkan proyek yang dihapus menggunakan permintaan berikut:

    PATCH 'https://dev.azure.com/{organization}/_apis/projects/{projectId}?api-version=7.2-preview.4'

    Isi permintaan

    {
 "state" : "wellFormed"
}

  1. Buka jendela browser dan masukkan URL yang menggunakan formulir berikut:

    http://ServerName:8080/tfs/DefaultCollection/ProjectName

    Misalnya, untuk menyambungkan ke server bernama FabrikamPrime, masukkan: 'http://FabrikamPrime:8080/tfs/'.

    Port default adalah 8080. Tentukan nomor port dan direktori untuk server Anda jika default tidak digunakan.

  2. Dapatkan daftar proyek yang dihapus menggunakan permintaan berikut:

    GET http://ServerName:8080/tfs/DefaultCollection/_apis/projects?stateFilter=
deleted&api-version=5.0-preview.3

  3. Pulihkan proyek yang dihapus menggunakan permintaan berikut:

    PATCH http://ServerName:8080/tfs/DefaultCollection/_apis/projects/{projectId}?
api-version=5.0-preview.3

    Isi permintaan

    {
 "state" : "wellFormed"
}

Memulihkan proyek dengan PowerShell

  1. Jalankan skrip PowerShell berikut untuk mendapatkan daftar proyek yang dihapus dan pastikan untuk memperbarui {yourPAT} dan {organization}.

    $MyPat = '{yourPAT}'
$MyOrg = '{organization}'
$headerValue = "Basic " + [Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes(":" + $MyPat))
(irm -Method Get -Uri "https://dev.azure.com/$MyOrg/_apis/projects?stateFilter=deleted&api-version=7.2-preview.4" -Headers @{Authorization = $headerValue}).value

  2. Gunakan skrip berikut untuk memulihkan proyek dan pastikan untuk memperbarui {yourPAT}, , {yourOrganization}dan {deletedProjectName}.

    $MyPat = '{yourPAT}'
$MyOrg = '{yourOrganization}'
$projectName = '{deletedProjectName}'
$headerValue = "Basic " + [Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes(":" + $MyPat))
$project = (irm -Method Get -Uri "https://dev.azure.com/$MyOrg/_apis/projects?stateFilter=deleted&api-version=7.2-preview.4" -Headers @{Authorization = $headerValue}).value | where {$_.name -eq $projectName}
irm -Uri ($project.url + "?api-version=7.2-preview.4") -Headers @{Authorization = $headerValue} -Method PATCH -Body '{"state":"wellFormed"}' -ContentType 'application/json'

Proyek Dan data terkait Anda dipulihkan.

  1. Jalankan skrip PowerShell berikut untuk mendapatkan daftar proyek yang dihapus dan pastikan untuk memperbarui $collectionUrl.

    $collectionUrl = "https://localhost/defaultcollection"
(irm -Uri "$collectionUrl/_apis/projects?stateFilter=
deleted&api-version=5.0-preview.3" -UseDefaultCredentials).value

  2. Gunakan skrip berikut untuk memulihkan proyek dan pastikan untuk memperbarui $collectionUrl dan $projectName.

    $collectionUrl = "https://localhost/defaultcollection"
$projectName = 'Project1'
$project = (irm -Uri "$collectionUrl/_apis/projects?stateFilter=
deleted&api-version=5.0-preview.3" -UseDefaultCredentials).value
 | where {$_.name -eq $projectName}
irm -Uri ($project.url + "?api-version=5.0-preview.3") 
-UseDefaultCredentials -Method PATCH -Body '{"state":"wellFormed"}'
 -ContentType 'application/json'

Proyek Dan data terkait Anda dipulihkan.

Tanya Jawab Umum

Lihat tanya jawab umum berikut tentang menghapus proyek di Azure DevOps.

A: Tautan item kerja yang menunjuk ke item kerja proyek yang dihapus akan tetap ada hingga proyek dihapus secara permanen. Setelah proyek dihapus secara permanen, tautan item kerja secara otomatis dibersihkan dalam waktu 24 jam. Jika Anda memerlukan tautan item kerja yang dibersihkan lebih cepat dari itu, Anda dapat menghapusnya secara manual dari formulir item kerja secara langsung.

T: Saya menghapus proyek di Azure DevOps, tetapi di Visual Studio Team Explorer masih ada, apa yang harus saya lakukan?

A: Tunggu 28 hari sebelum proyek dihapus secara permanen.

Menggunakan AI untuk mengelola penghapusan dan pemulihan proyek

Petunjuk

Anda dapat menggunakan AI untuk membantu Anda dalam tugas ini nanti dalam artikel ini, atau lihat Mengaktifkan dukungan AI dengan Azure DevOps MCP Server untuk memulai.

Jika Anda menggunakan GitHub Copilot, Azure DevOps MCP Server dapat membantu Anda menghapus, memulihkan, dan membersihkan proyek Azure DevOps dengan aman melalui perintah bahasa alami.

Contoh permintaan untuk penghapusan dan pemulihan proyek

Tugas Contoh tanggapan
Merencanakan penghapusan proyek yang aman I need to delete an obsolete project but want to preserve its build definitions and work item history first. Walk me through exporting the critical data before I delete the project
Memulihkan proyek yang dihapus secara tidak sengaja A team member accidentally deleted our staging project yesterday. Show me how to restore it before the 28-day permanent deletion window expires and verify all repos and pipelines are intact
Membersihkan setelah migrasi We migrated from Azure DevOps Server to Azure DevOps Services and have leftover projects in the old collection. Guide me through identifying which ones are safe to hard-delete from the admin console
Mengaudit proyek untuk kandidat penghapusan List all projects in my organization that have had zero commits, no pipeline runs, and no work item updates in the last 6 months so I can evaluate them for deletion
Mengotomatiskan penghapusan proyek melalui CLI I need to delete 5 test projects we created during a proof of concept. Show me how to use the Azure DevOps CLI to delete them in batch and verify each deletion completed
Memecahkan masalah tautan item kerja yang rusak After deleting a project, work items in our other projects still show links to the deleted project. Explain when these links get cleaned up and how to remove them manually if needed

Petunjuk

Untuk hasil terbaik, gunakan perintah ini dalam mode agen dengan Azure DevOps MCP Server yang terhubung. Sesuaikan perintah dengan nama proyek, organisasi, atau skenario migrasi tertentu Anda.

Konten terkait

  • Last updated on