Odstranění projektu

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Pokud je projekt zastaralý, můžete ho odstranit z vaší organizace nebo kolekce v Azure DevOps. Podobně pokud migrujete z místního Azure DevOps Serveru na Azure DevOps Services, může být potřeba projekt odstranit. Odebrání projektů může také vylepšit navigaci tím, že ji omezí jenom na projekty, které se aktuálně používají.

Upozornění

Projekty odstraněné z webového portálu se trvale odstraní a trvale odstraní, pokud se neobnoví do 28 dnů. Projekty odstraněné z místní konzoly pro správu Azure DevOps jsou však pevně odstraněné a není možné je obnovit. Podrobnosti o obnovení najdete v tématu Obnovení projektu. Pokud chcete získat přístup k datům z odstraněného projektu bez jejich obnovení, uložte data projektu.

Požadavky

• Musíte být členem skupiny Správci kolekce projektů. Vlastníci organizace jsou automaticky členy této skupiny.
• Musíte mít oprávnění k odstranění týmového projektu nastavené na Povolit. Další informace najdete v tématu Zobrazení oprávnění na úrovni projektu.
• (Volitelné) Před odstraněním projektu uložte data projektu, pokud chcete získat přístup k datům projektu bez jejich obnovení.

Uložení dat projektu

Pomocí následujících postupů můžete ukládat data, která uživatelé nejvíce zajímají, například zdrojový kód, data sestavení a pracovní položky. Tento postup je volitelný a něco, co byste mohli zvážit před odstraněním projektu.

• Zdrojový kód a vlastní šablony sestavení: Stáhněte si soubory jako soubor ZIP. Vyberte úložiště, soubor nebo složku a vyberte Stáhnout jako zip. Nebo vyberte Stáhnout a stáhněte všechny soubory v aktuálně vybrané složce nebo aktuálně vybraný soubor.

  

  Tento proces neukládá žádnou historii změn ani odkazy na jiné artefakty. Pokud používáte Git, naklonujte úložiště , aby se zachovala úplná historie projektu a všechny větve.

• Sestavení dat: Pokud chcete ukládat protokoly a data do složek sestavení, přečtěte si téma Zobrazení výsledků sestavení.

• Data sledování pracovních položek: Vytvořte dotaz pracovní položky a otevřete ho v Excelu. Uložte excelovou tabulku.

  Tento proces neukládá žádné přílohy, historii změn ani odkazy na jiné artefakty.

Další informace najdete v našem přehledu ochrany dat.

Odstranit projekt

Prohlížeč

Pomocí webového prohlížeče proveďte obnovitelné odstranění. Po 28 dnech se projekty trvale odstraní, pokud se během této doby neobnoví.

1. Přihlaste se ke své organizaci (https://dev.azure.com/{yourorganization}).

2. Vyberte nastavení organizace.

   

3. Vyberte Projekty, zaškrtněte jeden nebo více projektů, které chcete odstranit, a pak vyberte Odstranit.

   

4. Potvrďte odstranění zadáním názvu projektu a v místní obrazovce vyberte Odstranit .

   

Váš projekt se odstraní a můžete ho obnovit až 28 dní poté. Odstraněný projekt se odebere ze seznamu projektů.

Konzola pro správu

Konzola pro správu se podporuje jenom pro místní servery Azure DevOps.

Rozhraní příkazového řádku Azure DevOps

Týmový projekt můžete odstranit pomocí příkazu az devops project delete . Pokud chcete začít, přečtěte si téma Začínáme s Azure DevOps CLI.

az devops project delete --id
                         [--org]
                         [--yes] 

Parametry

• ID: Povinné. ID projektu, který chcete odstranit. K určení ID projektu použijte příkaz az devops project list .
• org: Adresa URL organizace Azure DevOps Výchozí organizaci můžete nakonfigurovat pomocí .az devops configure -d organization=ORG_URL Požadováno, pokud není nakonfigurováno jako výchozí nebo vyzvednuto pomocí git config. Příklad: --org https://dev.azure.com/MyOrganizationName/.
• Ano: Nepožádejte o potvrzení.

Příklad

Následující příkaz odstraní týmový projekt se zadaným ID bez výzvy k potvrzení.

az devops project delete --id 9a61d475-b1a7-4da7-b9db-80df15ac985c --yes

Obnovení odstraněného projektu

Pokud omylem odstraníte projekt v Azure DevOps, můžete ho obnovit do 28 dnů od jeho odstranění.

1. Přihlaste se ke své organizaci (https://dev.azure.com/{yourorganization}).

2. Vyberte nastavení organizace.

   

3. Vyberte Přehled a posuňte se dolů na nedávno odstraněné projekty.

   

4. Zvýrazněte projekt, který chcete obnovit, a pak vyberte Obnovit.

   

Obnovení projektu pomocí rozhraní REST API

Upozorňující

Pokud chcete obnovit projekt s názvem, který už byl pořízen, musíte projekt před obnovením přejmenovat. Pokud chcete projekt přejmenovat, zadejte do textu požadavku následující text: "name":"new name"

1. Otevřete okno prohlížeče a zadejte adresu URL, která používá následující formulář:

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

   Pokud se například chcete připojit k serveru s názvem FabrikamPrime, zadejte: 'http://FabrikamPrime:8080/tfs/'.

   Výchozí port je 8080. Zadejte číslo portu a adresář serveru, pokud se nepoužívají výchozí hodnoty.

2. Pomocí následujícího požadavku získejte seznam odstraněných projektů:

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

3. Obnovte odstraněný projekt pomocí následujícího požadavku:

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

   Text požadavku

   {
    "state" : "wellFormed"
   }
   

Obnovení projektu pomocí PowerShellu

1. Spuštěním následujícího skriptu PowerShellu získejte seznam odstraněných projektů a nezapomeňte aktualizovat $collectionUrl.

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

   Zobrazí se podobný následující snímek obrazovky:

2. K obnovení projektu použijte následující skript. Nezapomeňte aktualizovat $collectionUrl a $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'
   

Projekt a přidružená data se obnoví.

Nejčastější dotazy

Podívejte se na následující nejčastější dotazy týkající se odstraňování projektů v Azure DevOps.

Otázka: Proč po odstranění jednoho projektu mají pracovní položky ve zbývajícím projektu stále odkazy na odstraněné pracovní položky projektu?

A: Pracovní položky se odstraní do 24 hodin od odstranění projektu.

Otázka: Odstranil(a) jsem projekt v Azure DevOps, ale v Team Exploreru sady Visual Studio se stále nachází, co mám dělat?

A: Počkejte 28 dní, než se projekt trvale odstraní.

Související články

• Vytvoření projektu
• Obnovení projektu
• Odstranění projektu pomocí rozhraní REST API
• Nástroj příkazového řádku TFSDeleteProject