Переименование проекта в Azure DevOps
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Переименование проекта в Azure DevOps обновляет имя проекта в путях управления версиями, рабочих элементах, запросах и других артефактах проекта. Можно переименовать один проект несколько раз и использовать старые имена. Некоторые действия могут потребоваться от участников команды после переименования проекта.
Предупреждение
При переименовании проекта Azure DevOps уведомляет всех участников проекта по электронной почте, если число пользователей меньше 1000. Для проектов с числом пользователей более 1000 эти уведомления получают только администраторы коллекции проектов.
Переименование проекта нарушает объекты идентификации рабочей нагрузки через федерацию удостоверений в подключениях службы Azure Resource Manager.
Предварительные условия
| Категория | Требования |
|---|---|
| разрешения | Член группы администраторов проектов или группы проекта, для которых разрешено действие Переименовать командный проект, установлено на Разрешить. Дополнительные сведения см. в разделе Изменение разрешений на уровне проекта. |
Переименование проекта
Войдите в проект (
https://dev.azure.com/{Your_Organization}/{Your_Project}).Выберите "Обзор параметров>проекта", а затем введите новое имя и нажмите кнопку "Сохранить".
Чтобы подтвердить переименование, введите новое имя проекта, установите флажок рядом с надписью "Я понимаю последствия переименования этого проекта", а затем нажмите кнопку "Сохранить".
Результаты переименования
Следующие результаты возникают после операции переименования.
Azure DevOps переименовывает проект.
Все члены проекта получают уведомление об изменении имени по электронной почте, если менее 1000 участников.
URL-адрес продолжает работать как для нового имени команды, так и для старого имени команды. Эта функция предназначена для предотвращения разрыва ссылок.
Если проект в URL-адресе является допустимым проектом в организации, мы показываем идентификатор рабочего элемента. В следующем примере показана организация с проектами с именем Example1 и Example2.
https://dev.azure.com/MyOrg/Example1/_workitems/edit/40/— Отображает рабочий элемент 40 — отображает рабочий элемент 40https://dev.azure.com/MyOrg/Example2/_workitems/edit/40/https://dev.azure.com/MyOrg/Potato/_workitems/edit/40/— отображает ошибку 404Идентификаторы рабочих элементов уникальны в организации, поэтому ссылки не истекают.
Старое имя проекта можно использовать еще раз.
Обязательные действия пользователя для работы с переименованным проектом
Каждый пользователь в команде должен перезапустить своих клиентов и выполнить некоторые из следующих действий на основе используемых функций:
- Обновление удаленных служб Git
- Обновление рабочих областей сервера Team Foundation Version Control (TFVC)
- Обновление локальных рабочих областей TFVC
- Обновление потоков OData
- Обновление представлений аналитики
Перезапуск клиентов
Открытые клиенты сохраняют кэш всех имен проектов в памяти, но этот кэш не очищается автоматически после переименования проекта. Чтобы очистить кэш, перезапустите клиент, чтобы он заполнял новое имя проекта. Если вы не перезагрузите клиент, то операции, использующие кэшированное имя проекта, завершаются сбоем с исключением проект не найден.
Для следующих клиентов сохраните свою работу в каждой, а затем перезапустите:
- Visual Studio Team Explorer
- Microsoft Excel, если ваша команда использует Azure DevOps Office Integration 2019
Обновление удаленных репозиториев Git
Если проект использует Git, необходимо обновить удаленные ссылки для каждого репозитория из переименованного проекта. Эти обновления необходимы, поскольку URL-адрес удалённого репозитория содержит проект и имя репозитория. Git использует удаленные ссылки для получения и отправки изменений между локальным репозиторием и удаленной версией, хранящейся на сервере. Каждый член вашей команды должен обновить свои локальные репозитории Git, чтобы продолжить подключение с своих компьютеров разработки.
Для получения дополнительной информации смотрите в разделе "Обновление удаленных репозиториев Git на ваших компьютерах для разработки".
Обновление рабочих областей сервера TFVC
Если проект использует TFVC с рабочими областями сервера, эти рабочие области необходимо обновить с новым именем проекта. Для клиентов Visual Studio выполните команду получения или возврата, и тогда сопоставление рабочей области будет скорректировано для использования нового имени проекта.
Дополнительные сведения см. в разделе "Переименовать команду( TFVC)".
Обновление локальных рабочих областей TFVC
Если команда использует TFVC с локальными рабочими областями, эти рабочие области необходимо обновить с новым именем проекта. Для Visual Studio выполните get или check-in, и сопоставление рабочей области будет автоматически скорректировано для использования нового имени проекта.
По возможности, мы рекомендуем обновить ваших клиентов до последней версии. Для всех остальных поддерживаемых версий Visual Studio необходимо создать новую локальную рабочую область, сопоставленную с новым именем проекта.
Локальные рабочие области управляются локально, а не на сервере. Старые клиенты без обновленной логики переименования не могут обновлять локальные рабочие области до нового имени проекта.
Обновление каналов OData
Если вы используете веб-каналы OData в Power BI, обновите URL-адрес веб-канала, чтобы использовать новое имя проекта. Обновление URL-адреса веб-канала важно для поддержания подключений к данным и предотвращения ошибок в отчетах. Дополнительные сведения см. в разделе "Обзор примеров отчетов с помощью запросов OData".
Обновление представлений аналитики
Если вы создали пользовательские представления Аналитики с помощью старого имени проекта, необходимо обновить представления с новым именем. Дополнительные сведения см. в разделе "Аналитика".
Связанные статьи
Часто задаваемые вопросы
Вопрос. Почему попытка повторного использования имени проекта завершилась сбоем из-за существующих рабочих пространств?
Ответ. Вы не можете повторно использовать имя проекта, если для него по-прежнему существуют сопоставления рабочих областей. Эта функция помогает избежать неоднозначности ситуации, когда рабочая область может быть сопоставлена с двумя проектами. Обратитесь к пользователям, имеющим эти сопоставления, и удалите их или обновите их, чтобы использовать новое название.
Если компьютер пользователя, содержащий рабочую область, больше недоступен, можно удалить рабочую область, выполнив следующую команду из командной строки разработчика Visual Studio: tf workspace /delete [/collection:TeamProjectCollectionUrl] workspacename[;workspaceowner]
Как переименование проекта влияет на навигационный опыт в браузере?
Ответ. После переименования проекта все браузеры с открытым проектом могут столкнуться с некоторыми ошибками. Эти ошибки возникают из-за кэшей, удерживаемых браузером, которые включают старое имя проекта. Обновите страницу, чтобы ошибки исчезли, так как кэш будет обновлён с новым именем проекта.
Вопрос. Переименованы ли другие артефакты в проекте?
Ответ. Да, все артефакты с одинаковым именем будут переименованы вместе с проектом. Единственными исключениями являются команда по умолчанию и репозиторий. Переименование этих артефактов выполняется в качестве наилучших усилий. Например, если проект Foo был переименован в Bar, команда foo по умолчанию не будет переименована, если команда с именем Bar уже существовала в проекте.
Вопрос. Почему не удается открыть запросы, сохраненные на диске после переименования?
Ответ. Если вы используете Visual Studio 2010 и у вас есть запросы, сохраненные на диске, их нельзя открыть после переименования проекта. Чтобы открыть их, можно использовать Visual Studio 2012 или более поздней версии.