Sdílet prostřednictvím

Použijte TFSDeleteProject pro odstranění projektu na lokální instalaci Azure DevOps

  • Článek

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

Projekt můžete z Azure DevOps Serveru odebrat, pokud už projekt nepotřebujete pomocí TFSDeleteProject.

Kromě toho, pokud existují součásti, které zůstávají neschycené po neúspěšném vytvoření projektu, můžete je odebrat pomocí TFSDeleteProject.

Pokud chcete odstranit projekt z Azure DevOps Services pomocí konzoly pro správu, přečtěte si téma Odstranění projektu.

Varování

TFSDeleteProject trvale zničí projekt, po kterém jej nelze obnovit. Před použitím TFSDeleteProject byste měli zálohovat všechna důležitá data projektu.

Pokud chcete získat přístup k nástroji příkazového řádku TFSDeleteProject, otevřete okno příkazového řádku a zadejte:

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

Požadavky

Pokud chcete použít příkaz TFSDeleteProject, musíte být členem skupiny zabezpečení Team Foundation Administrators skupiny zabezpečení nebo správci projektu skupiny zabezpečení.

Další informace najdete v tématu Nastavení oprávnění správce proAzure DevOps Serveru .

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

možnost

popis

/q

Volitelný. Použijte tichý režim. Neukazujte uživateli výzvu k potvrzení.

/force

Volitelný. Určuje, že proces odstranění by měl pokračovat i v případě, že některé součásti nelze odstranit.

/excludewss

Volitelný. Určuje, že se neodstraní sharepointový web přidružený k projektu. Tuto možnost zadejte, pokud chcete zachovat existující web, aby ho ostatní projekty mohly dál používat.

/collection:URL

Povinné Určuje identifikátor URI kolekce projektů. Pro identifikátor URI musíte použít následující formát: http://ServerName:Port/VirtualDirectoryName/CollectionName.

Pokud nezadáte virtuální adresář, musíte pro identifikátor URI použít následující formát: http://ServerName:Port/CollectionName.

TeamProjectName

Povinný. Název projektu. Pokud název obsahuje mezery, uzavřete ho do uvozovek.

Poznámky

Když vytvoříte projekt, Azure DevOps Server vytvoří datové objekty na serveru, který hostuje Azure DevOps Server, a může vytvářet datové objekty na serveru, který je hostitelem sady SharePoint Products, a server, který je hostitelem služby SQL Server Reporting Services.

Když odeberete projekt, sestavy se automaticky odeberou ze služby SQL Server Reporting Services.

Když odeberete projekt, můžete zvolit, zda chcete odebrat objekty vytvořené pro podporu sharepointového webu.

Chyba ale může bránit Azure DevOps Serveru ve vytváření nebo odstraňování všech objektů. Při řešení těchto problémů poskytují následující části informace na pozadí, odkazy na další prostředky a konkrétní kroky, které vám pomůžou určit příčinu problému, opravit problém a v případě potřeby odstranit datové objekty, které zůstávají po spuštění TFSDeleteProject.

Proces TFSDeleteProject

Když použijete nástroj příkazového řádku TFSDeleteProject, nejprve odstraní data projektu a pak weby projektu.

Fáze 1: TFSDeleteProject odstraní data projektu

V první fázi TFSDeleteProject automaticky provede následující kroky pro odebrání dat projektu:

  1. TFSDeleteProject vytvoří inventář všech komponent, které jsou kandidáty na odstranění.

    To zahrnuje komponenty, které se integrují se správcem testů, sestavením Team Foundation a správou verzí Team Foundation.

  2. TFSDeleteProject odstraní komponentu, která zobrazuje uzel projektu v Team Exploreru.

  3. TFSDeleteProject označí informace o správě verzí k odstranění, ale neodstraní tyto informace okamžitě.

    Informace zahrnují všechny větve správy verzí v zadaném projektu, ale žádné jiné větve mimo projekt.

    • Pokud je v projektu jak nadřazená větev, tak podřízená větev, TFSDeleteProject označí oba pro odstranění.
    • Pokud jsou nadřazené a podřízené větve v různých projektech, TFSDeleteProject označí pouze zadanou větev.
    • Pokud je jiný projekt větví ze zadaného projektu, TFSDeleteProject označí pouze zadaný projekt. Po odstranění zadaného projektu se větvový projekt stane sirotkem.

  4. TFSDeleteProject okamžitě odstraní data sestavení, včetně informací a základních dat, definic sestavení, agentů sestavení a výsledků testů přidružených k projektu. Nástroj neodstraní umístění uložených sestavení.

    Před vytvořením projektu, který používá stejné umístění sestavení, není nutné odstranit umístění přetažení sestavení starého projektu.

    Pokud zadaný projekt obsahuje velké množství dat sestavení, odstranění nemusí být dokončeno během časového limitu.

    Chcete-li tento problém vyřešit, přečtěte si téma Zvýšení Time-Out Doby a poté spusťte TFSDeleteProject znovu.

  5. TFSDeleteProject okamžitě odstraní pracovní položky a pole pracovních položek, která patří do zadaného projektu, a odstraní všechna nesdílená metadata.

    Pokud zadaný projekt obsahuje velké množství dat pracovní položky, odstranění nemusí být dokončeno během časového limitu.

    Chcete-li tento problém vyřešit, přečtěte si téma Zvýšení Time-Out Doby a potom spusťte TFSDeleteProject znovu.

Fáze 2: TFSDeleteProject odstraní weby projektů

V druhé fázi TFSDeleteProject odstraní následující data:

Důležitý

Dokončení těchto kroků může trvat dlouhou dobu a během této doby mohou snížit výkon serveru.

  • TFSDeleteProject používá rozhraní API služby Reporting Services k odstranění sestav na serveru, který je hostitelem služby Reporting Services.
  • TFSDeleteProject odstraní web portálu projektu ze serveru, který je hostitelem sady SharePoint Products.

K tomuto kroku dochází pouze v případě, že projekt vlastní web a odstranění webu není vyloučeno z příkazového řádku. (Vezměte v úvahu, že více projektů může odkazovat na jeden web, ale pouze jeden z nich může být vlastníkem, ve kterém jsou sestavy a řídicí panely ve výchozím nastavení používány tímto projektem).

Poznámka

Před odstraněním projektu můžete ověřit, že služby Reporting Services a sharepointové produkty používají správné adresy URL projektu tím, že ověříte nastavení portálu. Další informace najdete v tématu Přidání portálu projektu.

Pokud TFSDeleteProject úspěšně odstraní všechny výše uvedené datové prvky, vrátí zprávu Hotovo.

Chcete-li ověřit tento výsledek, viz téma Ověření odstranění komponent projektu.

Pokud některé součásti nejsou odebrány, můžete znovu spustit TFSProjectDelete pomocí možnosti /force pokračovat v procesu odstraňování i v případě, že není možné odstranit všechny datové prvky.

S touto možností TFSDeleteProject přeskočí komponentu, kterou nemůže odstranit, vrátí chybovou zprávu, odstraní další komponentu a ponechá metadata projektu a nastavení zabezpečení nedotčené.

Data, která mohou zůstat nesmazaná

Po úspěšném dokončení TFSDeleteProject můžou v nasazení zůstat následující data:

  • Data projektu v krychli.

    Data projektu zůstanou v datové krychli, dokud se datová krychle znovu nevytvoře. Služba kontroleru skladu odebere všechna historická data sestavení, která byla odstraněna z databází Azure DevOps.

  • Sestavení zahoďte soubory a složky.

    Binární soubory sestavení, soubory protokolu sestavení a soubory protokolu obsahující výsledky testu se publikují během procesu sestavení.

    Umístění těchto souborů se neodstraní. Pokud chcete tyto soubory odebrat, musíte je odebrat ručně.

  • metadata pro sledování pracovních položek, které jsou sdíleny.

    TFSDeleteProject neodstraní žádná metadata pro sledování pracovních položek, která jsou sdílena mezi projekty.

  • Sady odložených změn ve správě verzí obsahující sdílený kód.

    Sady odložených položek správy verzí se neodstraní, pokud je v sadě odložených položek kód z více projektů.

Ověření odstranění projektu

Úspěšné odstranění projektu můžete ověřit tak, že potvrdíte, že se uzel projektu už nezobrazuje v Team Exploreru a že jeho web portálu projektu a složky sestav již neexistují.

  1. Otevřete Team Explorer a ověřte, že se projekt nezobrazuje jako uzel projektu.

  2. Otevřete Internet Explorer a zadejte adresu URL webu portálu projektu. Ověřte, že web již neexistuje.

  3. V Internet Exploreru do pole Adresa zadejte adresu URL webu služby Reporting Services pomocí jednoho z následujících formátů adresy URL:

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

  4. Ve Správci sestav zvolte Zobrazit podrobnosti.

  5. Ověřte, že složka odstraněného projektu již není zobrazena.

    Zvolte kořenovou složku TfsReports a pak zvolte složku pojmenovanou pro kolekci projektů.

    Složka s názvem odstraněného projektu by už neměla být.

  6. Pokud zůstanou sestavy nebo webová stránka, podívejte se na další postup.

Odstraňte zbývající součásti po částečném odstranění projektu

Pokud web portálu projektu a složka sestav zůstanou po odstranění projektu, odeberte web a složku ručně.

  1. Přihlaste se k serveru, který hostuje službu Reporting Services pro projekt, který jste odstranili.

  2. Otevřete Internet Explorer a do pole Adresa zadejte adresu URL webu služby Reporting Services pomocí jednoho z následujících formátů adresy URL:

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

  3. Ve Správci sestav zvolte Zobrazit podrobnosti.

  4. Zvolte kořenovou složku TfsReports a pak zvolte složku pojmenovanou pro kolekci projektů.

  5. Zaškrtněte políčko pro odstraněný projekt.

  6. Zvolte Odstranit.

  7. Zvolte OK a potvrďte, že chcete odstranit složku sestav projektu.

  8. Chcete-li odebrat web portálu projektu odstraněného projektu, podívejte se na následující stránku na webu společnosti Microsoft:

Vytvářet, upravovat a odstraňovat weby služby Windows SharePoint Services.

Zvyšte časový limit

Ve výchozím nastavení se u každého volání webové služby, které příkaz TFSDeleteProject vydá pro odstranění komponenty, očekává dokončení do 10 minut. Pokud existuje šest volání, může proces trvat až hodinu. Pokud chcete odstranit projekt, který je přidružený k velkému množství dat, můžete dočasně prodloužit toto časové období.

Poznámka

Když časový limit zvětšíte, změna ovlivní všechna volání webové služby. Obecně byste měli dobu časového limitu udržovat do 10 minut, aby se zabránilo tomu, že volání webových služeb zhorší výkon serveru a způsobí, že uživatelé nebudou moci používat uživatelské rozhraní po delší dobu. Po úspěšném odstranění projektu byste proto měli období časového limitu změnit zpět na 10 minut.

Požadavky

Abyste mohli tyto postupy dokončit, musíte být správcem Systému Windows na serveru aplikační vrstvy.

Důležitý

Nesprávná úprava registru počítače může způsobit nestabilitu počítače. Pokud registr neznáte, neměli byste přidávat ani odebírat položky ani je žádným způsobem upravovat.

  1. Přihlaste se k serveru aplikační vrstvy.

  2. Zvolte Start, Spustit, zadejte regedit a pak zvolte OK.

  3. V podokně prohlížeče rozbalte HKEY_ LOCAL_MACHINE:

    • Pokud server používá 32bitový operační systém, rozbalte: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\11.0\TeamFoundation\RequestSettings.
    • Pokud server používá 64bitový operační systém, rozbalte: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432\Microsoft\VisualStudio\11.0\TeamFoundation\RequestSettings.

  4. Pokud klíč TeamFoundation\RequestSettings neexistuje, vytvořte ho následujícím postupem:

    1. Otevřete místní nabídku pro TeamFoundation, přejděte na možnost Nový a vyberte Klíč.
    2. Pojmenujte klíč RequestSettings.
    3. Otevřete místní nabídku pro RequestSettings, přejděte na Nový a zvolte Hodnotu DWORD.
    4. Pojmenujte novou hodnotu DefaultTimeout.

  5. Otevřete místní nabídku pro DefaultTimeout a zvolte Změnit.

  6. Do pole Data hodnoty zadejte dobu vypršení v milisekundách a pak zvolte volbu Desetinné.

    Pokud chcete například prodloužit časový limit na 30 minut, zadejte 1800000. Pokud chcete období časového limitu změnit zpět na 10 minut, zadejte 600000.

  7. Zvolte OK.

  8. V nabídce Soubor zvolte Ukončit.

Příklad

Následující příkaz odebere všechny komponenty přidružené k project StoreFront na serveru Azure DevOps Server AdventureWorks1 v kolekci projektů Collection1 a z Team Exploreru.

TFSDeleteProject /force /collection:http://AdventureWorks1:8080/tfs/Collection1 StoreFront