Aracılığıyla paylaş

Şirket içi Azure DevOps'ta bir projeyi silmek için TFSDeleteProject kullanma

Azure DevOps Server |Azure DevOps Server |Azure DevOps Server 2022 | Azure DevOps Server 2020

TFSDeleteProject kullanarak proje artık gerekli olmadığında Azure DevOps Server'dan bir projeyi kaldırabilirsiniz.

Ayrıca, başarısız bir proje oluşturulduktan sonra silinmemiş olarak kalan bileşenler varsa, bunları kaldırmak için TFSDeleteProject kullanabilirsiniz.

Yönetici konsolunu kullanarak Azure DevOps Services'ten proje silmek için bkz.proje silme .

Uyarı

TFSDeleteProject projeyi kalıcı olarak yok eder ve daha sonra kurtarılamaz. TFSDeleteProject kullanmadan önce tüm önemli proje verilerini yedeklemeniz gerekir.

TFSDeleteProject komut satırı aracına erişmek için bir Komut İstemi penceresi açın ve şunu girin:

cd %programfiles%\Microsoft Visual Studio\2022\Enterprise\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer\TfsDeleteProject.exe

Önkoşullar

TFSDeleteProject komutunu kullanmak için, Team Foundation Yöneticileri güvenlik grubunun veya Proje Yöneticileri güvenlik grubunun üyesi olmanız gerekir.

Daha fazla bilgi için bkz. Azure DevOps Serveriçin yönetici izinlerini ayarlama .

TFSDeleteproject [/q] [/force] [/excludewss] /collection:URL TeamProjectName

Seçenek

Açıklama

/q

Opsiyonel. Sessiz modu kullanın. Kullanıcıdan onay istemde bulunmayın.

/zorla

Opsiyonel. Bazı bileşenler silinemese bile silme işleminin devam etmesi gerektiğini belirtir.

/excludewss

Opsiyonel. Projeyle ilişkili SharePoint sitesinin silinmediğini belirtir. Diğer projelerin kullanmaya devam edebilmesi için mevcut siteyi korumak için bu seçeneği belirtin.

/koleksiyon:URL

Gerekli. Proje koleksiyonunun URI'sini belirtir. URI için aşağıdaki biçimi kullanmanız gerekir: http://ServerName:Port/VirtualDirectoryName/CollectionName.

Sanal dizin belirtmezseniz, URI için aşağıdaki biçimi kullanmanız gerekir: http://ServerName:Port/CollectionName.

TeamProjectName

Gerekli. Projenin adı. İsim boşluklar içeriyorsa, tırnak içine alın.

Açıklamalar

Proje oluşturduğunuzda Azure DevOps Server, Azure DevOps Server'ı barındıran sunucuda veri nesneleri oluşturur ve SharePoint Ürünleri'ni barındıran sunucuda ve SQL Server Reporting Services'i barındıran sunucuda veri nesneleri oluşturabilir.

Bir projeyi kaldırdığınızda, raporlar SQL Server Reporting Services'ten otomatik olarak kaldırılır.

Bir projeyi kaldırdığınızda, SharePoint sitesini desteklemek için oluşturulan nesnelerin kaldırılıp kaldırılmayacağını seçebilirsiniz.

Ancak bir hata Azure DevOps Server'ın tüm nesneleri oluşturmasını veya silmesini engelleyebilir. Aşağıdaki bölümlerde bu sorunları gidermek için arka plan bilgileri, diğer kaynaklara bağlantılar ve sorunun nedenini belirlemenize, sorunu düzeltmenize ve gerektiğinde TFSDeleteProject çalıştırıldıktan sonra kalan veri nesnelerini silmenize yardımcı olacak belirli adımlar sağlanır.

TFSDeleteProject işlemi

TFSDeleteProject komut satırı aracını kullandığınızda, önce proje verilerini ve ardından proje Web sitelerini siler.

1. Aşama: TFSDeleteProject proje verilerini siler

İlk aşamada, TFSDeleteProject proje verilerini kaldırmak için aşağıdaki adımları otomatik olarak gerçekleştirir:

  1. TFSDeleteProject, silinmeye aday olan tüm bileşenlerin bir envanterini oluşturur.

    Bu, Test Yöneticisi, Team Foundation Derlemesi ve Team Foundation sürüm denetimiyle tümleşen bileşenleri içerir.

  2. TFSDeleteProject, Takım Gezgini'nde proje düğümünü görüntüleyen bileşeni siler.

  3. TFSDeleteProject, sürüm denetimi bilgilerini silinmek üzere işaretler, ancak bu bilgileri hemen silmez.

    Bilgiler, belirtilen projedeki tüm sürüm denetimi dallarını içerir, ancak projenin dışında başka dal yoktur.

    • Projede hem ana dal hem de alt dal varsa, TFSDeleteProject her ikisini de silinmek üzere işaretler.
    • Ebeveyn ve çocuk dallar farklı projelerdeyse, TFSDeleteProject yalnızca belirtilen dalı işaretler.
    • Başka bir proje belirtilen projeden bir dalsa, TFSDeleteProject yalnızca belirtilen projeye bayrak ekler. Belirtilen proje silindiğinde, dal projesi sahipsiz kalır.

  4. TFSDeleteProject bilgiler ve temel veriler, derleme tanımları, derleme aracıları ve projeyle ilişkili test sonuçları dahil olmak üzere derleme verilerini hemen siler. Araç, derleme çıktıları konumlarını silmez.

    Aynı derleme bırakma konumunu kullanan bir proje oluşturmadan önce eski bir projenin derleme bırakma konumunu silmeniz gerekmez.

    Belirtilen proje büyük miktarda derleme verisi içeriyorsa, silme işlemi zaman aşımı süresi içinde tamamlanmayabilir.

    Bu sorunu geçici olarak çözmek için bkz. Time-Out Süresini Artırma ve ardından TFSDeleteProject'i yeniden çalıştırma.

  5. TFSDeleteProject, belirtilen projeye ait iş öğelerini ve iş öğesi alanlarını hemen siler ve paylaşılmayan tüm meta verileri siler.

    Belirtilen proje büyük miktarda iş öğesi verisi içeriyorsa, silme işlemi zaman aşımı süresi içinde tamamlanmayabilir.

    Bu sorunu çözmek için bkz. Time-Out Süresini Artırma ve ardından TFSDeleteProject'i yeniden çalıştırma.

2. Aşama: TFSDeleteProject proje web sitelerini siler

İkinci aşamada, TFSDeleteProject aşağıdaki verileri siler:

Önemli

Bu adımların tamamlanması uzun sürebilir ve bu süre boyunca sunucu performansını düşürebilir.

  • TFSDeleteProject Reporting Services'i barındıran sunucudaki raporları silmek için Reporting Services API'lerini kullanır.
  • TFSDeleteProject Proje portalı Web sitesini SharePoint Ürünleri'ni barındıran sunucudan siler.

Bu adım yalnızca projenin sitenin sahibi olduğunda ve site silme işlemi komut satırında dışlanmadıysa gerçekleşir. (Birden çok projenin tek bir siteye işaret edebileceğini, ancak yalnızca birinin bu projede varsayılan olarak kullanılan raporların/panoların sahibi olabileceğini düşünün).

Not

Bir projeyi silmeden önce, portal ayarlarını doğrulayarak Reporting Services ve SharePoint Ürünleri'nin doğru proje URL'lerini kullandığını onaylayabilirsiniz. Daha fazla bilgi için bkz. Bir Proje Portalı Ekleme.

TFSDeleteProject yukarıdaki tüm veri öğelerini başarıyla silerse Bitti iletisini döndürür.

Bu sonucu doğrulamak için bkz. Proje Bileşenlerinin Silindiğini Doğrulama.

Bir veya daha fazla bileşen kaldırılmazsa, tüm veri öğelerini silemiyor olsa bile silme işlemine devam etmek için /force seçeneğini kullanarak TFSProjectDelete'ı yeniden çalıştırabilirsiniz.

TFSDeleteProject bu seçenekle silinemeyen bir bileşeni atlar, hata iletisi döndürür, sonraki bileşeni siler ve proje meta verilerini ve güvenlik ayarlarını olduğu gibi bırakır.

Silinmemiş olarak kalabilecek veriler

TFSDeleteProject başarıyla tamamlandıktan sonra aşağıdaki veriler dağıtımda kalabilir:

  • küptekiProject verileri.

    Proje verileri, küp yeniden derlenene kadar küpte kalır ve bu sırada ambar denetleyicisi hizmeti Azure DevOps veritabanlarından silinmiş olan tüm geçmiş derleme verilerini kaldırır.

  • Düşürme dosya ve klasörlerini oluştur.

    Derleme işlemi sırasında ikili dosyalar, derleme günlük dosyaları ve test sonuçlarını içeren log dosyaları yayımlanır.

    Bu dosyaların konumları silinmez. Bu dosyaları kaldırmak istiyorsanız, bunları el ile kaldırmanız gerekir.

  • iş öğesi takibi için paylaşılan meta veriler .

    TFSDeleteProject, projeler arasında paylaşılan iş öğesi izleme meta verilerini silmez.

  • Paylaşılan kod içeren sürüm kontrol rafları.

    Raf kümesinde birden çok projeden kod varsa sürüm denetimi raf kümeleri silinmez.

Proje silmeyi doğrulama

Proje düğümünün artık Takım Gezgini'nde görünmediğini ve proje portalı Web sitesi ve rapor klasörlerinin artık mevcut olmadığını onaylayarak proje silme işleminin başarısını doğrulayabilirsiniz.

  1. Takım Gezgini'ni açın ve projenin proje düğümü olarak görünmediğini doğrulayın.

  2. Internet Explorer'ı açın ve proje portalı Web sitesinin URL'sini yazın. Sitenin artık mevcut olmadığını doğrulayın.

  3. Internet Explorer'da, Adres kutusuna aşağıdaki URL biçimlerinden birini kullanarak Reporting Services Web sitesinin URL'sini yazın:

    • http://ReportingServices/Reports
    • http://ReportingServices/Reports_TFSInstance

  4. Rapor Yöneticisi'nde Ayrıntıları Göster'i seçin.

  5. Silinen projenin klasörünün artık görünmediğini doğrulayın.

    TfsReports kök klasörünü seçin ve ardından proje koleksiyonu için adlı klasörü seçin.

    Silinen projenin adına sahip bir klasör artık olmamalıdır.

  6. Raporlar veya web sitesi kalıyorsa sonraki işleme bakın.

Kısmi proje silindikten sonra kalan bileşenleri kaldırma

Proje sildikten sonra proje portalı Web sitesi ve raporlar klasörü kalıyorsa, siteyi ve klasörü el ile kaldırın.

  1. Sildiğiniz proje için Reporting Services'i barındıran sunucuda oturum açın.

  2. Internet Explorer'ı açın ve Adres kutusuna aşağıdaki URL biçimlerinden birini kullanarak Reporting Services Web sitesinin URL'sini yazın:

    • http://localhost/Reports
    • http://localhost/Reports_TFSInstance

  3. Rapor Yöneticisi'nde Ayrıntıları Göster'i seçin.

  4. TfsReports kök klasörünü seçin ve ardından proje koleksiyonu için adlı klasörü seçin.

  5. Silinen projenin onay kutusunu seçin.

  6. Sil'i seçin.

  7. Projenin raporlar klasörünü silmek istediğinizi onaylamak için Tamam'ı seçin.

  8. Silinen bir projenin proje portalı Web sitesini kaldırmak için Microsoft Web sitesinde aşağıdaki sayfaya bakın:

Windows SharePoint Services Siteleri Oluşturma, Düzenleme ve Silme .

Zaman aşımı süresini artırma

Varsayılan olarak, bir bileşeni silmek için TFSDeleteProject komutunun yaptığı her bir web hizmeti çağrısının 10 dakika içinde tamamlanması gerekir. Altı çağrı varsa işlem bir saate kadar sürebilir. Büyük miktarda veriyle ilişkili bir projeyi silmek istiyorsanız, bu zaman aşımı süresini geçici olarak artırabilirsiniz.

Not

Zaman aşımı süresini artırdığınızda, değişiklik tüm Web hizmeti çağrılarını etkiler. Genel olarak, Web hizmeti çağrılarının sunucu performansını düşürmesini ve kullanıcıların uzun süreler boyunca kullanıcı arabirimini kullanmalarına engel olmasını önlemek için zaman aşımı süresini 10 dakika içinde tutmak istiyorsunuz. Bu nedenle, proje başarıyla silindikten sonra zaman aşımı süresini 10 dakika olarak değiştirmeniz gerekir.

Önkoşullar

Bu yordamları tamamlamak için uygulama katmanı sunucusunda Windows Yöneticisi olmanız gerekir.

Önemli

Bilgisayarınızın kayıt defterini yanlış değiştirmek bilgisayarınızın kararsız olmasına neden olabilir. Kayıt defteri hakkında bilginiz yoksa, girdileri eklememeli veya kaldırmamalısınız ya da herhangi bir şekilde değiştirmemelisiniz.

  1. Uygulama katmanı sunucusunda oturum açın.

  2. Başlat, Çalıştır'ı seçin, regedit yazın ve tamam'ı seçin.

  3. Tarayıcı bölmesinde HKEY_ LOCAL_MACHINE genişletin:

    • Sunucu 32 bit işletim sistemi çalıştırıyorsa şunu genişletin: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\11.0\TeamFoundation\RequestSettings.
    • Sunucu 64 bit işletim sistemi çalıştırıyorsa, HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432\Microsoft\VisualStudio\11.0\TeamFoundation\RequestSettings'ı genişletin.

  4. TeamFoundation\RequestSettings anahtarı yoksa, oluşturmak için şu adımları izleyin:

    1. TeamFoundation bağlam menüsünü açın, Yeni'nin üzerine gelin ve Anahtar'ı seçin.
    2. Anahtara RequestSettings adını verin.
    3. RequestSettings bağlam menüsünü açın, Yeni'nin üzerine gelin ve DWORD Değeri'ni seçin.
    4. Yeni değeri DefaultTimeout olarak adlandırın.

  5. DefaultTimeout bağlam menüsünü açın ve Değiştir'i seçin.

  6. Değer Verileri'nde, zaman aşımı süresini milisaniye olarak yazın ve Ondalık'ı seçin.

    Örneğin, zaman aşımı süresini 30 dakikaya çıkarmak için 1800000 yazın. Zaman aşımı süresini 10 dakikaya geri döndürmek için 600000 yazın.

  7. Tamam'ı seçin.

  8. Dosya menüsünde Çıkış'ı seçin.

Örnek

Aşağıdaki komut, Collection1 proje koleksiyonundaki Azure DevOps Server AdventureWorks1 sunucusundaki StoreFront projesiyle ilişkilendirilmiş tüm bileşenleri Takım Gezgini'nden kaldırır.

TFSDeleteProject /force /collection:http://AdventureWorks1:8080/tfs/Collection1 StoreFront
  • Last updated on