Megosztás a következőn keresztül:

Projekt törlése a helyszíni Azure DevOpsban a TFSDeleteProject használatával

  • Cikk

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

Eltávolíthat egy projektet az Azure DevOps Serverről, ha a projektre már nincs szükség a TFSDeleteProject használatával.

Ezenkívül ha vannak olyan összetevők, amelyek a sikertelen projektlétrehozás után sem törlődnek, a TFSDeleteProject használatával eltávolíthatja őket.

Ha törölni szeretne egy projektet az Azure DevOps Servicesből a felügyeleti konzol használatával, olvassa el Projekt törlésecímű témakört.

Figyelmeztetés

A TFSDeleteProject véglegesen megsemmisíti a projektet, amely után nem állítható helyre. A TFSDeleteProject használata előtt biztonsági másolatot kell készítenie az összes fontos projektadatról.

A TFSDeleteProject parancssori eszköz eléréséhez nyisson meg egy parancssori ablakot, és írja be a következőt:

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

Előfeltételek

A TFSDeleteProject parancs használatához a Team Foundation-rendszergazdák biztonsági csoportnak vagy a Projektgazdák biztonsági csoportnak kell lennie.

További információ: Rendszergazdai engedélyek beállítása az Azure DevOps Server.

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

opció

leírás

/q

Szabadon választható. Használja a csendes módot. Ne kérje a felhasználótól a megerősítést.

/force

Szabadon választható. Meghatározza, hogy a törlési folyamat akkor is folytatódjon, ha egyes összetevők nem törölhetők.

/excludewss

Szabadon választható. Megadja, hogy ne törölje a projekthez társított SharePoint-webhelyet. Ezzel a beállítással fenntarthatja a meglévő webhelyet, hogy más projektek is használhassák.

/gyűjtemény:URL

Szükséges. A projektgyűjtemény URI-ját adja meg. Az URI-hoz a következő formátumot kell használnia: http://ServerName:Port/VirtualDirectoryName/CollectionName.

Ha nem ad meg virtuális könyvtárat, a következő formátumot kell használnia az URI-hoz: http://ServerName:Port/CollectionName.

TeamProjectName

Szükséges. A projekt neve. Ha a név szóközöket tartalmaz, tegye idézőjelek közé.

Megjegyzések

Projekt létrehozásakor az Azure DevOps Server adatobjektumokat hoz létre azon a kiszolgálón, amely az Azure DevOps Servert üzemelteti, és adatobjektumokat hozhat létre a SharePoint-termékeket üzemeltető kiszolgálón, valamint az SQL Server Reporting Servicest futtató kiszolgálón.

Ha eltávolít egy projektet, a jelentések automatikusan törlődnek az SQL Server Reporting Servicesből.

Amikor eltávolít egy projektet, eldöntheti, hogy eltávolítja-e a SharePoint-webhely támogatásához létrehozott objektumokat.

Egy hiba azonban megakadályozhatja, hogy az Azure DevOps Server létrehozza vagy törölje az összes objektumot. A problémák elhárításához az alábbi szakaszok háttérinformációkat, más erőforrásokra mutató hivatkozásokat és a probléma okának azonosítását, a probléma megoldását és szükség esetén a TFSDeleteProject futtatása után megmaradó adatobjektumok törlését ismertetik.

TFSDeleteProject folyamat

A TFSDeleteProject parancssori eszköz használatakor először törli a projektadatokat, majd a projektwebhelyeket.

1. fázis: A TFSDeleteProject törli a projektadatokat

Az első fázisban a TFSDeleteProject automatikusan végrehajtja a következő lépéseket a projektadatok eltávolításához:

  1. A TFSDeleteProject létrehozza a törlésre jelölt összes összetevő leltárát.

    Ide tartoznak a Test Managerrel, a Team Foundation buildel és a Team Foundation verziókövetésével integrálható összetevők.

  2. A TFSDeleteProject törli azt az összetevőt, amely megjeleníti a projektcsomópontot a Team Explorerben.

  3. A TFSDeleteProject a verziókövetési adatokat jelöli a törléshez, de nem törli azonnal ezeket az információkat.

    Az információk tartalmazzák a megadott projekt összes verziókövetési ágát, de a projekten kívül más ágakat sem.

    • Ha egy szülőág és egy gyermekág is szerepel a projektben, a TFSDeleteProject mindkettőt törli.
    • Ha a szülő- és gyermekágak különböző projektekben találhatók, a TFSDeleteProject csak a megadott ágat jelöli meg.
    • Ha egy másik projekt a megadott projekt ága, a TFSDeleteProject csak a megadott projektet jelöli meg. A megadott projekt törlésekor a fiókprojekt árva lesz.

  4. A TFSDeleteProject azonnal törli a buildadatokat, beleértve az információkat és az alapvető adatokat, a builddefiníciókat, a buildügynököket és a projekthez társított teszteredményeket. Az eszköz nem törli a build elhelyezési pontokat.

    Nem kell törölnie egy régi projekt buildelési helyét, mielőtt létrehoz egy projektet, amely ugyanazt a buildelési helyet használja.

    Ha a megadott projekt nagy mennyiségű buildadatot tartalmaz, előfordulhat, hogy a törlés nem fejeződik be az időkorláton belül.

    A probléma megoldásához tekintse meg a Time-Out időszak növelése című témakört, majd futtassa újra a TFSDeleteProject parancsot.

  5. A TFSDeleteProject azonnal törli a megadott projekthez tartozó munkaelemeket és munkaelemmezőket, és törli az összes nem megosztott metaadatot.

    Ha a megadott projekt nagy mennyiségű munkaelem-adatot tartalmaz, előfordulhat, hogy a törlés nem fejeződik be az időkorláton belül.

    A probléma megoldásához olvassa el a Time-Out időszak növelése című témakört, majd futtassa újra a TFSDeleteProject parancsot.

2. fázis: A TFSDeleteProject törli a projektwebhelyeket

A második fázisban a TFSDeleteProject a következő adatokat törli:

Fontos

Ezek a lépések hosszú időt is igénybe vehetnek, és ez idő alatt csökkenthetik a kiszolgáló teljesítményét.

  • A TFSDeleteProject a Reporting Services API-kkal törli a jelentéskészítési szolgáltatásokat futtató kiszolgálón lévő jelentéseket.
  • A TFSDeleteProject törli a projektportál webhelyét a SharePoint-termékeket üzemeltető kiszolgálóról.

Ez a lépés csak akkor fordul elő, ha a projekt a webhely tulajdonosa, és a hely törlését nem zárja ki a parancssor. (Vegye figyelembe, hogy több projekt is egyetlen webhelyre mutathat, de csak az egyik lehet a tulajdonos, ahol a jelentések/irányítópultok alapértelmezés szerint ezt a projektet használják).

Jegyzet

A projekt törlése előtt ellenőrizheti, hogy a Reporting Services és a SharePoint-termékek a megfelelő projekt URL-címeket használják-e a portál beállításainak ellenőrzésével. Ha további információra van szüksége, tekintse meg: Projektportál hozzáadása.

Ha a TFSDeleteProject sikeresen törli a fenti adatelemeket, a Kész üzenetet adja vissza.

Az eredmény ellenőrzéséhez tekintse meg a Projektösszetevők törlése című témakört.

Ha nem távolít el egy vagy több összetevőt, a /force beállítással újrafuttathatja a TFSProjectDelete parancsot a törlési folyamat folytatásához még akkor is, ha nem tudja törölni az összes adatelemet.

Ezzel a TFSDeleteProject beállítással kihagy egy olyan összetevőt, amelyet nem tud törölni, hibaüzenetet ad vissza, törli a következő összetevőt, és érintetlenül hagyja a projekt metaadatait és biztonsági beállításait.

Olyan adatok, amelyek töröletlenül maradhatnak

A TFSDeleteProject sikeres befejezése után a következő adatok maradhatnak az üzembe helyezésben:

  • Projektadatok a kockában.

    A projektadatok a kockában maradnak, amíg a kocka újra nem épül. Ekkor a raktárvezérlő szolgáltatás eltávolítja az Azure DevOps-adatbázisokból törölt összes korábbi buildadatot.

  • Dobható fájlok és mappák létrehozása.

    A buildelési folyamat során bináris fájlokat, buildnaplókat és teszteredményeket tartalmazó naplófájlokat tesznek közzé.

    Ezeknek a fájloknak a helye nem törlődik. Ha el szeretné távolítani ezeket a fájlokat, manuálisan kell eltávolítania őket.

  • Megosztott munkaelem-nyomkövetési metaadatok.

    A TFSDeleteProject nem törli a projektek között megosztott munkaelem-nyomkövetés metaadatait.

  • Megosztott kódot tartalmazó polckészletek verziókövetése.

    A verziókövetési polckészletek nem törlődnek, ha több projektből származó kód található a polckészletben.

Projekt törlésének ellenőrzése

A projekt törlésének sikerességét úgy ellenőrizheti, hogy a projektcsomópont már nem jelenik meg a Team Explorerben, és hogy a projektportál webhelye és jelentésmappái már nem léteznek.

  1. Nyissa meg a Team Explorert, és ellenőrizze, hogy a projekt nem jelenik-e meg projektcsomópontként.

  2. Nyissa meg az Internet Explorert, és írja be a projektportál webhelyének URL-címét. Ellenőrizze, hogy a webhely már nem létezik-e.

  3. Az Internet Explorer Cím mezőjébe írja be a Reporting Services webhelyÉNEK URL-címét az alábbi URL-formátumok egyikével:

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

  4. A Jelentéskezelőben válassza a Részletek megjelenítése lehetőséget.

  5. Ellenőrizze, hogy a törölt projekt mappája már nem jelenik-e meg.

    Válassza ki a TfsReports gyökérmappát, majd válassza ki a projektgyűjteményhez tartozó mappát.

    Nem lehet többé olyan mappa, amely a törölt projekt nevét tartalmazza.

  6. Ha a jelentések vagy a webhely továbbra is megmaradnak, tekintse meg a következő eljárást.

A projekt részleges törlése után fennmaradó összetevők eltávolítása

Ha a projektportál webhelye és jelentésmappája a projekt törlése után is megmarad, távolítsa el manuálisan a webhelyet és a mappát.

  1. Jelentkezzen be arra a kiszolgálóra, amely a törölt projekt Reporting Services szolgáltatását üzemelteti.

  2. Nyissa meg az Internet Explorert, és a Cím mezőbe írja be a Reporting Services webhely URL-címét az alábbi URL-formátumok egyikével:

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

  3. A Jelentéskezelőben válassza a Részletek megjelenítése lehetőséget.

  4. Válassza ki a TfsReports gyökérmappát, majd válassza ki a projektgyűjteményhez tartozó mappát.

  5. Jelölje be a törölt projekt jelölőnégyzetét.

  6. Válassza a Törlés lehetőséget.

  7. Az OK gombra kattintva ellenőrizheti, hogy törölni szeretné-e a projekt jelentésmappájának tartalmát.

  8. Ha el szeretné távolítani egy törölt projekt projektportáljának webhelyét, tekintse meg a Microsoft webhelyének következő lapját:

Windows SharePoint Services-webhelyeklétrehozása, szerkesztése és törlése.

Az időtúllépési időszak növelése

Alapértelmezés szerint minden olyan webszolgáltatás-hívásnak, amelyet a TFSDeleteProject parancs egy összetevő törlésével kapcsolatos problémákat tapasztal, 10 percen belül be kell fejeződnie. Ha hat hívás van, a folyamat akár egy órát is igénybe vehet. Ha olyan projektet szeretne törölni, amely nagy mennyiségű adattal van társítva, ideiglenesen növelheti ezt az időtúllépési időszakot.

Jegyzet

Ha növeli az időtúllépési időtartamot, a módosítás az összes webszolgáltatás-hívásra hatással van. Általában 10 percen belül meg szeretné tartani az időtúllépési időtartamot, hogy a webszolgáltatás-hívások ne rontják a kiszolgáló teljesítményét, és hosszú ideig kizárják a felhasználókat a felhasználói felület használatából. Ezért a projekt sikeres törlése után az időtúllépési időszakot 10 percre kell módosítania.

Előfeltételek

Ezeknek az eljárásoknak a elvégzéséhez Windows-rendszergazdának kell lennie az alkalmazásszintű kiszolgálón.

Fontos

A számítógép beállításjegyzékének helytelen módosítása instabillá teheti a számítógépet. Ha nem ismeri a beállításjegyzéket, ne vegyen fel vagy távolítson el bejegyzéseket, és ne módosítsa semmilyen módon.

  1. Jelentkezzen be az alkalmazásszintű kiszolgálóra.

  2. Válassza a Start, a Futtatás, a Regedit parancsot, majd az OK gombot.

  3. A böngészőablakban bontsa ki a HKEY_LOCAL_MACHINE:

    • Ha a kiszolgáló 32 bites operációs rendszert működtet, bontsa ki a következőt: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\11.0\TeamFoundation\RequestSettings.
    • Ha a kiszolgáló 64 bites operációs rendszert futtat, bontsa ki az alábbit: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432\Microsoft\VisualStudio\11.0\TeamFoundation\RequestSettings.

  4. Ha a TeamFoundation\RequestSettings kulcs nem létezik, a létrehozásához kövesse az alábbi lépéseket:

    1. Nyissa meg a TeamFoundation helyi menüjét, majd mutasson az Új pontra, és válassza a Kulcs lehetőséget.
    2. Nevezze el a RequestSettings kulcsát.
    3. Nyissa meg a RequestSettings helyi menüjét, mutasson az Új lehetőségre, és válassza a DWORD Érték lehetőséget.
    4. Nevezze el az új defaultTimeout értéket.

  5. Nyissa meg a DefaultTimeout helyi menüjét, és válassza a Módosítás lehetőséget.

  6. Az Értékadatok mezőbe írja be az időtúllépési időszakot ezredmásodpercben, majd válassza a Decimális lehetőséget.

    Ha például 30 percre szeretné növelni az időtúllépési időtartamot, írja be az 1800000-et. Ha az időtúllépési időszakot 10 percre szeretné módosítani, írja be a 600000-et.

  7. Válassza az OK gombot.

  8. A Fájl menüben válassza a Kilépés lehetőséget.

Példa

Az alábbi parancs eltávolítja a StoreFront projekthez társított összes összetevőt az Azure DevOps Server AdventureWorks1-kiszolgálón a Project Collection1 projektgyűjteményben és a Team Explorerben.

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