Поделиться через

Удаление проекта

  • Статья

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

Если проект становится устаревшим, его можно удалить из организации или коллекции в Azure DevOps. Аналогичным образом, если вы переносите локальный сервер Azure DevOps в Azure DevOps Services, возможно, потребуется удалить проект. Удаление проектов также может улучшить навигацию, ограничив ее только теми проектами, которые в настоящее время используются.

Внимание

  • Обратимо удаленные проекты с веб-портала окончательно удаляются, если не восстанавливаются в течение 28 дней.
  • В редких случаях процесс удаления может занять до 70 дней из-за повторных попыток серверной части и необходимости удаления данных из нескольких источников.
  • Не удается восстановить удаленные проекты из локальной консоли администрирования Azure DevOps. Дополнительные сведения см. в разделе "Восстановление проекта " и "Сохранение данных проекта".

Необходимые компоненты

  • Разрешения:
    • Быть членом группы "Администраторы коллекции проектов". Владельцы организации автоматически входят в эту группу.
    • Укажите разрешение "Удалить командный проект" в значение Allow. Дополнительные сведения см. в разделе "Просмотр разрешений на уровне проекта".
  • Необязательно. Сохраните данные проекта перед удалением проекта, если вы хотите получить доступ к данным проекта без его восстановления.
  • Разрешения. Укажите разрешение " Удалить командный проект " в качестве "Разрешить". Дополнительные сведения см. в разделе "Просмотр разрешений".
  • Необязательно. Сохранение данных проекта при удалении проекта приводит к необратимой потере данных.

Сохранение данных проекта

Используйте следующие процедуры для сохранения данных, которые пользователи больше всего заботятся о том, как исходный код, данные сборки и рабочие элементы. Эта процедура является необязательной, и вы можете рассмотреть ее перед удалением проекта.

  • Исходный код и пользовательские шаблоны сборки: скачивание файлов в виде ZIP-файла. Выберите Действия репозитория репозиторий, файл или папку и выберите "Скачать как ZIP". Или нажмите кнопку "Скачать ", чтобы скачать все файлы в выбранной папке или текущий выбранный файл.

    Снимок экрана: скачивание кода.

    Этот процесс не сохраняет журнал изменений или ссылки на другие артефакты. Если вы используете Git, клонируйте репозитории для сохранения полной истории проекта и всех ветвей.

  • Создание данных. Чтобы сохранить журналы и данные в папках сборки drop, см. статью "Просмотр результатов сборки".

  • Данные отслеживания рабочих элементов: создайте запрос рабочего элемента и откройте его с помощью Excel. Сохраните электронную таблицу Excel.

    Этот процесс не сохраняет вложения, журнал изменений или ссылки на другие артефакты.

Дополнительные сведения см. в обзоре защиты данных.

Удаление проекта

Используйте веб-браузер для выполнения обратимого удаления. Через 28 дней проекты окончательно удаляются, если они не восстанавливаются в течение этого времени.

  1. Войдите в свою организацию (https://dev.azure.com/{yourorganization}).

  2. Выберите Значок шестеренки параметры организации.

    Снимок экрана: выбор параметров организации.

  3. Выберите "Проекты", проверьте один или несколько проектов, чтобы удалить, а затем нажмите кнопку "Удалить".

    Снимок экрана: последовательность выбранных проектов, проверка каждого проекта и удаление.

  4. Подтвердите удаление, введя имя проекта, а затем нажмите кнопку "Удалить " на всплывающем экране.

    Снимок экрана: экран подтверждения удаления проекта.

Проект удаляется и может быть восстановлен до 28 дней после этого. Удаленный проект удаляется из списка проектов.

Удаление отчетов, оставшихся после удаления проекта

Если проект использовал отчеты SQL Server и не удалил внешние артефакты, можно удалить отчеты с помощью диспетчера отчетов SQL Server. На странице коллекции проектов удалите папку, соответствующую удаленному проекту.

Снимок экрана: контекстное меню с командой удаления.

Восстановление удаленного проекта

Если вы непреднамеренно удалите проект в Azure DevOps, его можно восстановить в течение 28 дней после его удаления.

  1. Войдите в свою организацию (https://dev.azure.com/{yourorganization}).

  2. Выберите Значок шестеренки параметры организации.

    Снимок экрана: значок шестеренки, параметры организации.

  3. Выберите "Обзор", а затем прокрутите вниз до "недавно удаленных проектов".

    Снимок экрана: недавно удаленные проекты.

  4. Выделите проект, который требуется восстановить, и нажмите кнопку "Восстановить".

    Снимок экрана: выделенный проект и кнопка

  1. Войдите в экземпляр (http://{ServerName:8080/tfs/}/{CollectionName}).

  2. Выберите Значок шестеренки параметры администратора.

    Снимок экрана: кнопка

  3. Выберите "Проекты", а затем прокрутите вниз до недавно удаленных проектов.

  4. Выделите проект, который требуется восстановить, и нажмите кнопку "Восстановить".

    Снимок экрана: выделение проекта, а затем выберите

Примечание.

Пользовательский интерфейс не поддерживает восстановление командного проекта для Azure DevOps Server 2019. Чтобы восстановить удаленный командный проект, используйте следующие методы REST API или PowerShell. Дополнительные сведения см. в разделе REST API "Проекты-обновление".

Восстановление проекта с помощью REST API

Предупреждение

Чтобы восстановить проект с уже принятым именем, необходимо переименовать проект, прежде чем восстановить его. Чтобы переименовать проект, введите следующий текст в тексте запроса: "name":"new name"

  1. Откройте окно браузера и введите URL-адрес, использующий следующую форму:

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

    Например, чтобы подключиться к серверу с именем FabrikamPrime, введите :'http://FabrikamPrime:8080/tfs/.

    Порт по умолчанию — 8080. Укажите номер порта и каталог сервера, если значения по умолчанию не используются.

  2. Получите список удаленных проектов с помощью следующего запроса:

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

  3. Восстановите удаленный проект с помощью следующего запроса:

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

    Текст запроса

    {
 "state" : "wellFormed"
}

Восстановление проекта с помощью PowerShell

  1. Выполните следующий скрипт PowerShell, чтобы получить список удаленных проектов и обязательно обновить $collectionUrl.

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

    Появится что-то подобное следующему снимку экрана: Снимок экрана: пример возврата скрипта PowerShell для удаленных проектов.

  2. Чтобы восстановить проект, используйте следующий скрипт. Обязательно обновите $collectionUrl и $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'

Проект и связанные данные восстанавливаются.

Вопросы и ответы

Ознакомьтесь со следующими часто задаваемыми вопросами об удалении проектов в Azure DevOps.

Ответ. Рабочие элементы удаляются в течение 24 часов после удаления проекта.

Вопрос. Я удалил проект в Azure DevOps, но в Visual Studio Team Explorer все еще есть, что делать?

Ответ. Подождите 28 дней до окончательного удаления проекта.