Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Сервисы Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022
При переименовании проекта в Azure DevOps имя проекта обновляется в путях управления версиями, рабочих элементах, запросах и других артефактах проекта. Можно переименовать один проект несколько раз и использовать старые имена. После переименования проекта некоторые действия могут потребоваться от участников группы.
Предупреждение
При переименовании проекта Azure DevOps отправляет уведомления по электронной почте всем членам проекта, если число пользователей меньше 1000. Для проектов с числом пользователей более 1000 эти уведомления получают только администраторы коллекции проектов.
Переименование проекта нарушает предметы федерации удостоверений рабочей нагрузки в подключениях к службе Azure Resource Manager.
Подсказка
Вы можете использовать ИИ, чтобы помочь с этой задачей позже в этой статье или ознакомиться с включение помощи ИИ в Azure DevOps MCP Server, чтобы начать работу.
Предварительные условия
| Категория | Требования |
|---|---|
| Разрешения | Участник группы "Администраторы проектов" или разрешение уровня проекта на переименование командного проекта с установленным значением "Разрешить". Дополнительные сведения см. в разделе Изменение разрешений на уровне проекта. |
Переименование проекта
Войдите в проект (
https://dev.azure.com/{Your_Organization}/{Your_Project}).Выберите"Обзор>, введите новое имя и нажмите кнопку "Сохранить".
Чтобы подтвердить переименование, введите новое имя проекта, установите флажок рядом с надписью "Я понимаю последствия переименования этого проекта", а затем нажмите кнопку "Сохранить".
Результаты переименования
После завершения переименования:
URL-адреса продолжают работать как для старых, так и для новых имен проектов, поэтому существующие ссылки не прерываются.
Ссылки на рабочие элементы не истекают, так как идентификаторы рабочих элементов являются уникальными для всей организации, а не для одного проекта. Любое допустимое имя проекта в URL-адресе определяет рабочий элемент.
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 — если ваш проект использует репозитории Git
- Обновление рабочих областей сервера TFVC — если проект использует TFVC с рабочими областями сервера
- Обновление локальных рабочих областей TFVC — если проект использует TFVC с локальными рабочими областями
- Обновление потоков OData — при подключении отчетов Power BI, с помощью OData
- Обновление представлений Аналитики — если вы создали пользовательские представления Аналитики
Перезапуск клиентов
Открытые клиенты сохраняют в памяти кэш всех имен проектов, но этот кэш не очищается автоматически после переименования проекта. Чтобы очистить кэш, перезапустите клиент, чтобы он заполнял новое имя проекта. Если клиент не перезапущен, операции, использующие кэшированное имя проекта, завершаются сбоем с исключением project not found.
Для следующих клиентов сохраните свою работу в каждой, а затем перезапустите:
- 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 выполните операцию получения или регистрации. Затем сопоставление рабочей области обновляется, чтобы использовать новое имя проекта.
При возможности обновите клиентов до последней версии или выпуска. Для всех остальных поддерживаемых версий Visual Studio создайте новую локальную рабочую область, сопоставленную с новым именем проекта.
Локальные рабочие области управляются локально, а не на сервере. Старые клиенты без обновленной логики переименования не могут обновлять локальные рабочие области до нового имени проекта.
Обновление каналов OData
Если вы используете веб-каналы OData в Power BI, обновите URL-адрес веб-канала, чтобы использовать новое имя проекта. Обновление URL-адреса веб-канала важно для поддержания подключений к данным и предотвращения ошибок в отчетах. Дополнительные сведения см. в разделе "Обзор примеров отчетов с помощью запросов OData".
Обновление представлений аналитики
Если вы создали пользовательские представления Аналитики с помощью старого имени проекта, обновите представления с новым именем. Дополнительные сведения см. в разделе "Аналитика".
Использование искусственного интеллекта для управления переименованиями проектов
Подсказка
Вы можете использовать ИИ, чтобы помочь с этой задачей позже в этой статье или ознакомиться с включение помощи ИИ в Azure DevOps MCP Server, чтобы начать работу.
Если вы используете GitHub Copilot, Azure DevOps MCP Server поможет вам спланировать и выполнить переименование проекта и обрабатывать все дальнейшие действия с помощью запросов естественного языка.
Примеры запросов на переименование проектов
| задачи | Пример запроса |
|---|---|
| Планирование переименования с помощью анализа влияния | I need to rename my Azure DevOps project from 'ProjectAlpha' to 'Platform-Core'. List everything that breaks, including Git remotes, TFVC workspaces, OData feeds, and service connections, and give me a step-by-step remediation plan |
| Сообщите команде о переименовании | Draft an announcement for my team explaining that our Azure DevOps project is being renamed, what actions each developer needs to take to update their Git remotes and local workspaces, and a timeline for the change |
| Исправьте неисправные подключения к сервису | After renaming my project, my Azure Resource Manager service connections using workload identity federation stopped working. Walk me through updating the federation subjects to use the new project name |
| Массовое обновление удалённых репозиториев Git | Generate a script I can share with my team that detects their current Git remote URLs pointing to the old project name and updates them to use the new project name |
| Обновление отчетов после переименования | I renamed my project and now my Power BI dashboards connected through OData show errors. Guide me through updating the Analytics views and OData feed URLs to use the new project name |
| Восстановление после проблемного переименования | I renamed a project but some team members can't open their TFVC local workspaces anymore. Help me understand why and walk me through the steps to fix both server and local workspaces |
Подсказка
Для получения наилучших результатов используйте эти запросы в режиме агента с подключенным сервером MCP Azure DevOps. Настройте запросы с определенными именами проектов, размером команды или системой управления версиями.
Часто задаваемые вопросы
Вопрос. Почему попытка повторного использования имени проекта завершилась ошибкой из-за наличия существующих рабочих областей?
Ответ. Невозможно повторно использовать имя проекта, если сопоставления рабочих областей по-прежнему обращаются к нему. Эта функция помогает избежать неоднозначности ситуации, когда рабочая область может быть сопоставлена с двумя проектами. Обратитесь к пользователям, имеющим эти сопоставления, и удалите их или обновите их , чтобы использовать новое имя.
Если компьютер пользователя, содержащий рабочую область, больше недоступен, удалите рабочую область, выполнив следующую команду из командной строки разработчика Visual Studio: tf workspace /delete [/collection:TeamProjectCollectionUrl] workspacename[;workspaceowner]
Как переименование проекта влияет на навигационный опыт в браузере?
Ответ. После переименования проекта все браузеры с открытым проектом могут столкнуться с некоторыми ошибками. Эти ошибки возникают из-за кэшей, удерживаемых браузером, которые включают старое имя проекта. Обновите страницу, чтобы ошибки исчезли, так как кэш будет обновлён с новым именем проекта.
Вопрос. Переименованы ли другие артефакты в проекте?
Ответ. Да, все артефакты с одинаковым именем будут переименованы вместе с проектом. Единственными исключениями являются команда по умолчанию и репозиторий. Переименование этих артефактов выполняется в качестве наилучших усилий. Например, если проект Foo был переименован в Bar, команда foo по умолчанию не будет переименована, если команда с именем Bar уже существовала в проекте.