Cambiar el nombre de un proyecto en Azure DevOps

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

El cambio de nombre de un proyecto en Azure DevOps actualiza el nombre del proyecto en rutas de acceso de control de versiones, elementos de trabajo, 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.

Requisitos previos

Cambiar el nombre de un proyecto

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

2. Seleccione Configuración del proyecto>Descripción general y, a continuación, introduzca un nuevo nombre y seleccione Guardar.

   

3. Para confirmar el cambio de nombre, introduzca el nuevo nombre del proyecto, marque la casilla situada junto a "Entiendo las consecuencias de cambiar el nombre de este proyecto" y, a continuación, seleccione 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:

• Actualización de repositorios de Git remotos
• Actualizar los espacios de trabajo del servidor Team Foundation Version Control (TFVC)
• Actualizar los espacios de trabajo locales de TFVC
• Actualizar fuentes de OData
• Actualizar vistas de Analytics

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:

• Team Explorer de Visual Studio
• Microsoft Excel, si el equipo usa la integración de Office de Azure DevOps 2019

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, realice una operación para obtener o dar entrada, con lo que se corregirá la asignación del área de trabajo para usar el nuevo nombre del proyecto.

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. En Visual Studio, ejecute una operación de obtención o registro y la asignación del espacio de trabajo se corregirá para utilizar 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 compatibles de Visual Studio, debe crear un nuevo espacio de trabajo local asignado 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.

Contenido relacionado

• Eliminar un proyecto
• Git y Azure Repos

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 con el área de trabajo ya no está disponible, puede eliminar el área de trabajo ejecutando el siguiente comando en el editor de código 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 utiliza Visual Studio 2010 y tiene consultas guardadas en el disco, no podrá abrirlas después de cambiar el nombre de un proyecto. Puede utilizar Visual Studio 2012 o una versión posterior para abrirlas.