Usuń projekt

  • Artykuł

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Jeśli projekt stanie się przestarzały, możesz usunąć go z organizacji lub kolekcji w usłudze Azure DevOps. Podobnie, jeśli migrujesz z lokalnego serwera Azure DevOps Server do usługi Azure DevOps Services, może być konieczne usunięcie projektu. Usunięcie projektów może również poprawić nawigację, ograniczając ją tylko do tych projektów, które są obecnie używane.

Uwaga

Projekty usunięte z portalu internetowego są usuwane nietrwale i trwale usuwane, jeśli nie zostaną przywrócone w ciągu 28 dni. Jednak projekty usunięte z lokalnej konsoli usługi Azure DevOps Administracja istration są trwale usuwane i nie można ich przywrócić. Aby uzyskać szczegółowe informacje na temat przywracania, zobacz Przywracanie projektu. Aby uzyskać dostęp do danych z usuniętego projektu bez ich przywracania, zapisz dane projektu.

Wymagania wstępne

  • Musisz być członkiem grupy Administracja istratorów kolekcji projektów. Właściciele organizacji są automatycznie członkami tej grupy.
  • Musisz mieć uprawnienie Usuń projekt zespołowy ustawiony na Zezwalaj. Aby uzyskać więcej informacji, zobacz Wyświetlanie uprawnień na poziomie projektu.
  • (Opcjonalnie) Zapisz dane projektu przed usunięciem projektu, jeśli chcesz uzyskać dostęp do danych projektu bez ich przywracania.
  • Aby przywrócić projekt, musisz mieć uprawnienie Usuń projekt zespołowy ustawiony na Zezwalaj. Aby uzyskać więcej informacji, zobacz Wyświetlanie uprawnień.
  • (Opcjonalnie) Zapisz dane projektu, ponieważ usunięcie projektu powoduje nieodwracalną utratę danych.

Zapisywanie danych projektu

Użyj poniższych procedur, aby zapisać dane, które użytkownicy najbardziej dbają, takich jak kod źródłowy, dane kompilacji i elementy robocze. Ta procedura jest opcjonalna i warto wziąć pod uwagę przed usunięciem projektu.

  • Kod źródłowy i niestandardowe szablony kompilacji: pobierz pliki jako plik zip. Wybierz Repository actions repozytorium, plik lub folder, a następnie wybierz pozycję Pobierz jako plik Zip. Możesz też wybrać pozycję Pobierz , aby pobrać wszystkie pliki w aktualnie wybranym folderze lub aktualnie wybrany plik.

    Screenshot of Downloading code.

    Ten proces nie zapisuje historii zmian ani linków do innych artefaktów. Jeśli używasz usługi Git, sklonuj repozytoria, aby zachować pełną historię projektu i wszystkie gałęzie.

  • Dane kompilacji: aby zapisać dzienniki i dane w folderach kompilacji upuszczania, zobacz Wyświetlanie wyników kompilacji.

  • Dane śledzenia elementów roboczych: utwórz zapytanie dotyczące elementu roboczego i otwórz je przy użyciu programu Excel. Zapisz arkusz kalkulacyjny programu Excel.

    Ten proces nie zapisuje żadnych załączników, historii zmian ani łączy z innymi artefaktami.

Aby uzyskać więcej informacji, zobacz omówienie ochrony danych.

Usuwanie projektu

Użyj przeglądarki internetowej, aby wykonać usuwanie nietrwałe. Po upływie 28 dni projekty zostaną trwale usunięte, jeśli nie zostaną przywrócone w tym czasie.

  1. Zaloguj się do organizacji (https://dev.azure.com/{yourorganization}).

  2. Wybierz pozycję gear iconUstawienia organizacji.

    Screenshot of selection, Organization settings.

  3. Wybierz pozycję Projekty, zaznacz co najmniej jeden projekt do usunięcia, a następnie wybierz pozycję Usuń.

    Screenshot of sequence selected Projects, check each project, and delete.

  4. Potwierdź usunięcie, wprowadzając nazwę projektu, a następnie wybierz pozycję Usuń na ekranie podręcznym.

    Screenshot of popup confirmation delete project screen.

Projekt zostanie usunięty i można go przywrócić do 28 dni później. Usunięty projekt zostanie usunięty z listy projektów.

Usuwanie raportów pozostałych po usunięciu projektu

Jeśli projekt używał raportowania programu SQL Server i nie usunął artefaktów zewnętrznych, możesz usunąć raporty przy użyciu Menedżera raportów programu SQL Server. Na stronie kolekcji projektów usuń folder odpowiadający usuniętemu projektowi.

Screenshot of the context menu with delete command.

Przywracanie usuniętego projektu

Jeśli przypadkowo usuniesz projekt w usłudze Azure DevOps, możesz przywrócić go w ciągu 28 dni od usunięcia.

  1. Zaloguj się do organizacji (https://dev.azure.com/{yourorganization}).

  2. Wybierz pozycję gear iconUstawienia organizacji.

    Screenshot showing the gear icon, Organization settings.

  3. Wybierz pozycję Przegląd, a następnie przewiń w dół do "ostatnio usuniętych projektów".

    Screenshot that shows recently deleted projects.

  4. Wyróżnij projekt, który chcesz przywrócić, a następnie wybierz pozycję Przywróć.

    Screenshot showing highlighted project, and Restore button.

  1. Zaloguj się do wystąpienia (http://{ServerName:8080/tfs/}/{CollectionName}).

  2. Wybierz gear iconpozycję Administracja ustawienia.

    Screenshot showing Admin settings button surrounded by red box.

  3. Wybierz pozycję Projekty, a następnie przewiń w dół do pozycji Ostatnio usunięte projekty.

  4. Wyróżnij projekt, który chcesz przywrócić, a następnie wybierz pozycję Przywróć.

    Screenshot showing how to Highlight the project, and then select Restore for Azure DevOps Server.

Uwaga

Interfejs użytkownika nie obsługuje przywracania projektu zespołowego dla usługi Azure DevOps Server 2019. Użyj następujących metod interfejsu API REST lub programu PowerShell, aby przywrócić usunięty projekt zespołowy. Aby uzyskać więcej informacji, zobacz Projects-Update REST API (Interfejs API REST aktualizacji projektów).

Przywracanie projektu przy użyciu interfejsu API REST

Ostrzeżenie

Aby przywrócić projekt o nazwie, która jest już zajęta, musisz zmienić nazwę projektu przed jego przywróceniem. Aby zmienić nazwę projektu, wprowadź następujący tekst w treści żądania: "name":"new name"

  1. Otwórz okno przeglądarki i wprowadź adres URL, który używa następującego formularza:

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

    Na przykład aby nawiązać połączenie z serwerem o nazwie FabrikamPrime, wprowadź: "http://FabrikamPrime:8080/tfs/".

    Domyślny port to 8080. Określ numer portu i katalog dla serwera, jeśli wartości domyślne nie są używane.

  2. Pobierz listę usuniętych projektów przy użyciu następującego żądania:

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

  3. Przywróć usunięty projekt przy użyciu następującego żądania:

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

    Treść żądania

    {
 "state" : "wellFormed"
}

Przywracanie projektu przy użyciu programu PowerShell

  1. Wykonaj następujący skrypt programu PowerShell, aby uzyskać listę usuniętych projektów i pamiętaj, aby zaktualizować $collectionUrlprogram .

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

    Zostanie wyświetlony podobny do poniższego zrzutu ekranu: Screenshot of PowerShell script return example for deleted projects.

  2. Aby przywrócić projekt, użyj następującego skryptu. Pamiętaj, aby zaktualizować $collectionUrl i $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 i skojarzone dane są przywracane.

— często zadawane pytania

Zapoznaj się z następującymi często zadawanymi pytaniami dotyczącymi usuwania projektów w usłudze Azure DevOps.

Elementy robocze są usuwane w ciągu 24 godzin po usunięciu projektu.

Pyt.: Usunięto projekt w usłudze Azure DevOps, ale w programie Visual Studio Team Explorer nadal istnieje, co robię?

1: Poczekaj 28 dni, zanim projekt zostanie trwale usunięty.