Compartir a través de

Cambiar el nombre de un proyecto en Azure DevOps

Servicios Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Cambiar el nombre de un proyecto en Azure DevOps actualiza el nombre del proyecto en las rutas de acceso de control de versiones, los elementos de trabajo, las consultas y otros artefactos del proyecto. Puede cambiar el nombre de un solo proyecto varias veces y usar nombres antiguos. Es posible que los miembros del equipo deban realizar algunas acciones después de cambiar el nombre del proyecto.

Advertencia

  • Al cambiar el nombre de un proyecto, Azure DevOps notifica a todos los miembros del proyecto por correo electrónico si el recuento de usuarios es inferior a 1000. En el caso de los proyectos con más de 1000 usuarios, solo los administradores de colecciones de proyectos reciben estas notificaciones.

  • Cambiar el nombre de un proyecto interrumpe los sujetos de federación de identidad de carga de trabajo en las conexiones de servicio de Azure Resource Manager.

Sugerencia

Puede usar la inteligencia artificial para ayudar con esta tarea más adelante en este artículo, o consulte Enable AI assistance with Azure DevOps MCP Server para empezar.

Requisitos previos

Categoría Requisitos
Permisos Miembro del grupo Administradores de proyectos o del conjunto de permisos Cambiar nombre del proyecto de equipo de nivel de proyecto en Permitir. Para obtener más información, consulte Cambio de permisos de nivel de proyecto.

Cambiar el nombre de un proyecto

  1. Inicie sesión en el proyecto (https://dev.azure.com/{Your_Organization}/{Your_Project}).

  2. Seleccione Información general sobre la configuración > del proyecto y, a continuación, escriba un nuevo nombre y seleccione Guardar.

    Captura de pantalla que muestra la entrada del nuevo nombre y el botón Guardar resaltado.

  3. Para confirmar el cambio de nombre, escriba el nuevo nombre del proyecto, active la casilla situada junto a "Entiendo las consecuencias de cambiar el nombre de este proyecto" y, a continuación, seleccione Guardar.

    Captura de pantalla que muestra la pantalla de confirmación del nuevo nombre con el botón Guardar.

Resultados del cambio de nombre

Tras la operación de cambio de nombre se producen los siguientes resultados.

  • Azure DevOps cambia el nombre del proyecto.

  • Todos los miembros del proyecto reciben una notificación por correo electrónico del cambio de nombre, si hay menos de 1000 miembros.

  • La URL sigue funcionando tanto para el nuevo nombre del equipo como para el antiguo. Esta funcionalidad tiene por objeto evitar que se rompan los vínculos.

  • Si el proyecto de la URL es un proyecto válido en la organización, mostramos el ID del elemento de trabajo proporcionado. El siguiente ejemplo muestra una organización con proyectos denominados "Ejemplo1" y "Ejemplo2".

    https://dev.azure.com/MyOrg/Example1/_workitems/edit/40/ - Muestra el elemento de trabajo 40 https://dev.azure.com/MyOrg/Example2/_workitems/edit/40/ - Muestra el elemento de trabajo 40 https://dev.azure.com/MyOrg/Potato/_workitems/edit/40/ - Muestra un error 404

  • Los ID de los elementos de trabajo son únicos en la organización y, por lo tanto, los enlaces no caducan.

  • El nombre antiguo del proyecto se puede volver a utilizar.

Acciones que deben realizar los usuarios para trabajar con el proyecto renombrado.

Cada usuario de su equipo debe reiniciar sus clientes y realizar algunas de las siguientes acciones, en función de las características que utilicen:

Reiniciar los clientes

Los clientes abiertos mantienen una caché de todos los nombres de proyectos en la memoria, pero esta caché no se borra automáticamente después de cambiar el nombre de un proyecto. Para borrar la caché, reinicie el cliente para que se rellene con el nuevo nombre del proyecto. Si no reinicia el cliente, las operaciones que utilizan el nombre del proyecto almacenado en la caché fallarán con una excepción proyecto no encontrado.

Para los siguientes clientes, guarde su trabajo en cada uno de ellos y, a continuación, reinicie:

Actualización de repositorios de Git remotos

Si su proyecto utiliza Git, deberá actualizar las referencias remotas de cada repositorio del proyecto renombrado. Estas actualizaciones son necesarias porque la URL del repositorio remoto contiene el nombre del proyecto y del repositorio. Git utiliza referencias remotas para obtener y enviar cambios entre su repositorio local y la versión remota almacenada en el servidor. Cada miembro de su equipo debe actualizar sus repositorios Git locales para seguir conectándose desde sus máquinas de desarrollo.

Para obtener más información, consulte Actualizar los remotos Git en sus máquinas de desarrollo.

Actualizar los espacios de trabajo del servidor TFVC

Si su proyecto utiliza TFVC con espacios de trabajo del servidor, estos espacios de trabajo deben actualizarse con el nuevo nombre del proyecto. Para los clientes de Visual Studio, ejecute una obtención o una comprobación y, a continuación, el mapeo del área de trabajo se corrige para usar el nuevo nombre del proyecto.

Captura de pantalla del explorador de control de código fuente, que muestra la selección de obtener la última versión.

Para obtener más información, consulte Comando Renombrar (TFVC).

Actualizar los espacios de trabajo locales de TFVC

Si su equipo utiliza TFVC con espacios de trabajo locales, estos espacios de trabajo deben actualizarse con el nuevo nombre del proyecto. Para Visual Studio, ejecute una obtención o una confirmación y la asignación del área de trabajo se corrige para usar el nuevo nombre del proyecto.

Le recomendamos que actualice sus clientes a la última actualización o versión, si es posible. Para todas las demás versiones de Visual Studio admitidas, debe crear un área de trabajo local asignada al nuevo nombre del proyecto.

Los espacios de trabajo locales se administran localmente y no en el servidor. Los clientes más antiguos que no cuentan con la lógica de cambio de nombre actualizada no pueden actualizar los espacios de trabajo locales con el nuevo nombre del proyecto.

Actualizar fuentes de OData

Si usa fuentes de OData en Power BI, actualice la dirección URL de fuente para usar el nuevo nombre del proyecto. La actualización de la dirección URL de fuente es esencial para mantener las conexiones de datos y evitar errores en los informes. Para obtener más información, consulte Información general sobre informes de ejemplo mediante consultas de OData.

Actualizar vistas de Analytics

Si ha creado vistas de Analytics personalizadas con el nombre del proyecto anterior, debe actualizar las vistas con el nuevo nombre. Para más información, consulte Vistas de análisis.

Uso de IA para gestionar renombrados de proyectos

Sugerencia

Puede usar la inteligencia artificial para ayudar con esta tarea más adelante en este artículo, o consulte Enable AI assistance with Azure DevOps MCP Server para empezar.

Si usa GitHub Copilot, el Azure DevOps MCP Server puede ayudarle a planear y ejecutar cambios de nombre de proyectos y controlar todas las acciones de seguimiento mediante indicaciones en lenguaje natural.

Mensajes de ejemplo para cambiar el nombre de los proyectos

tarea Mensaje de ejemplo
Planear un cambio de nombre con análisis de impacto I need to rename my Azure DevOps project from 'ProjectAlpha' to 'Platform-Core'. List everything that will break, including Git remotes, TFVC workspaces, OData feeds, and service connections, and give me a step-by-step remediation plan
Comunicar un cambio de nombre al equipo 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
Corrección de conexiones de servicio interrumpidas 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
Actualización masiva de los remotos de 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
Actualización de informes después de un cambio de nombre I renamed my project and now my Power BI dashboards connected via OData show errors. Guide me through updating the Analytics views and OData feed URLs to use the new project name
Recuperarse de un cambio de nombre problemático 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

Sugerencia

Para obtener los mejores resultados, use estas solicitudes en modo de agente con el servidor MCP de Azure DevOps conectado. Personalice las indicaciones con los nombres de proyecto específicos, el tamaño del equipo o el sistema de control de versiones.

Contenido relacionado

Preguntas más frecuentes (P+F)

P: ¿Por qué ha fallado mi intento de reutilizar un nombre de proyecto debido a los espacios de trabajo existentes?

R: No puede reutilizar un nombre de proyecto si todavía hay asignaciones de espacios de trabajo que lo utilizan. Esta función ayuda a evitar la ambigüedad de que un espacio de trabajo pueda estar asignado a dos proyectos. Póngase en contacto con los usuarios que tengan estas asignaciones y elimínelas o actualícelas para usar el nuevo nombre.

Si la máquina del usuario que contiene el área de trabajo ya no está disponible, puede eliminar el área de trabajo ejecutando el siguiente comando desde el símbolo del sistema para desarrolladores de Visual Studio: tf workspace /delete [/collection:TeamProjectCollectionUrl] workspacename[;workspaceowner]

P: ¿Cómo afecta el cambio de nombre de un proyecto a mi experiencia de navegación en el navegador?

R: Después de cambiar el nombre de un proyecto, es posible que cualquier navegador que tenga el proyecto abierto encuentre algunos errores. Estos errores se deben a las cachés del navegador, que incluyen el nombre antiguo del proyecto. Actualice la página para que estos errores desaparezcan, ya que la caché se volverá a rellenar con el nuevo nombre del proyecto.

P: ¿Se renombran otros artefactos del proyecto?

R: Sí, todos los artefactos que comparten el mismo nombre se renombran junto con el proyecto. Las únicas excepciones son el equipo y el repositorio predeterminados. El cambio de nombre de estos artefactos se realiza en la medida de lo posible. Por ejemplo, si un proyecto Foo se renombrara como Bar, el equipo predeterminado Foo no se renombraría si ya existiera un equipo llamado Bar en el proyecto.

P: ¿Por qué no puedo abrir las consultas guardadas en un disco después de un cambio de nombre?

R: Si usa Visual Studio 2010 y tiene consultas guardadas en disco, no puede abrirlas después de cambiar el nombre de un proyecto. Puede usar Visual Studio 2012 o posterior para abrirlos.

  • Last updated on