Compartir a través de

Uso de TFSDeleteProject para eliminar un proyecto en Azure DevOps local

  • Artículo

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

Puede quitar un proyecto de Azure DevOps Server cuando el proyecto ya no sea necesario mediante TFSDeleteProject.

Además, si hay componentes que permanecen sin eliminar después de crear un proyecto incorrecto, puede usar TFSDeleteProject para quitarlos.

Para eliminar un proyecto de Azure DevOps Services mediante la consola de administración, consulte Eliminación de un proyecto.

Advertencia

TFSDeleteProject destruye permanentemente el proyecto, después del cual no se puede recuperar. Debe realizar una copia de seguridad de todos los datos importantes del proyecto antes de usar TFSDeleteProject.

Para acceder a la herramienta de línea de comandos TFSDeleteProject, abra una ventana de comandos y escriba:

cd %programfiles%\Microsoft Visual Studio\2022\Enterprise\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer\TfsDeleteProject.exe

Prerrequisitos

Para usar el comando TFSDeleteProject, debe ser miembro del grupo de seguridad de administradores de Team Foundation o del grupo de seguridad de administradores de proyectos.

Para más información, consulte Establecimiento de permisos de administrador para Azure DevOps Server.

TFSDeleteproject [/q] [/force] [/excludewss] /collection:URL TeamProjectName

Opción

descripción

/q

Opcional. Use el modo silencioso. No pida confirmación al usuario.

/force

Opcional. Especifica que el proceso de eliminación debe continuar incluso si algunos componentes no se pueden eliminar.

/excludewss

Opcional. Especifica que no elimine el sitio de SharePoint asociado al proyecto. Especifique esta opción para mantener el sitio existente para que otros proyectos puedan seguir usándolo.

/colección:URL

Obligatorio. Especifica el URI de la colección de proyectos. Debe usar el siguiente formato para el URI: http://ServerName:Port/VirtualDirectoryName/CollectionName.

Si no especifica un directorio virtual, debe usar el siguiente formato para el URI: http://ServerName:Port/CollectionName.

NombreDelProyectoDelEquipo

Obligatorio. Nombre del proyecto. Si el nombre incluye espacios, escríbalo entre comillas.

Observaciones

Al crear un proyecto, Azure DevOps Server crea objetos de datos en el servidor que hospeda Azure DevOps Server y puede crear objetos de datos en el servidor que hospeda Productos de SharePoint y el servidor que hospeda SQL Server Reporting Services.

Al quitar un proyecto, los informes se quitan automáticamente de SQL Server Reporting Services.

Al quitar un proyecto, puede elegir si desea quitar o no los objetos creados para apoyar el sitio de SharePoint.

Sin embargo, un error puede impedir que Azure DevOps Server cree o elimine todos los objetos. Para solucionar estos problemas, en las secciones siguientes se proporciona información general, vínculos a otros recursos y pasos específicos que le ayudan a determinar la causa del problema, corregir el problema y, cuando sea necesario, eliminar objetos de datos que permanecen después de ejecutar TFSDeleteProject.

Proceso TFSDeleteProject

Cuando se usa la herramienta de línea de comandos TFSDeleteProject, primero se eliminan los datos del proyecto y, a continuación, los sitios web del proyecto.

Fase 1: TFSDeleteProject elimina los datos del proyecto

En la primera fase, TFSDeleteProject realiza automáticamente los pasos siguientes para quitar los datos del proyecto:

  1. TFSDeleteProject crea un inventario de todos los componentes que son candidatos para su eliminación.

    Esto incluye componentes que se integran con test Manager, Team Foundation Build y control de versiones de Team Foundation.

  2. TFSDeleteProject elimina el componente que muestra el nodo del proyecto en Team Explorer.

  3. TFSDeleteProject marca la información de control de versiones para su eliminación, pero no elimina inmediatamente esta información.

    La información incluye todas las ramas de control de versiones del proyecto especificado, pero ninguna otra rama fuera del proyecto.

    • Si una rama primaria y una rama secundaria están en el proyecto, TFSDeleteProject marca ambas para su eliminación.
    • Si las ramas padre e hijo están en proyectos diferentes, TFSDeleteProject marca solo la rama especificada.
    • Si otro proyecto es una rama del proyecto especificado, TFSDeleteProject marca solo el proyecto especificado. Cuando se elimina el proyecto especificado, el proyecto de rama se convierte en huérfano.

  4. TFSDeleteProject elimina inmediatamente los datos de compilación, incluidos la información y los datos principales, las definiciones de compilación, los agentes de compilación y los resultados de pruebas asociados al proyecto. La herramienta no elimina las ubicaciones de entrega de compilaciones.

    No es necesario eliminar la ubicación de colocación de compilación de un proyecto anterior antes de crear un proyecto que use la misma ubicación de colocación de compilación.

    Si el proyecto especificado contiene una gran cantidad de datos de compilación, es posible que la eliminación no finalice dentro del período de tiempo de espera.

    Para solucionar este problema, consulte Aumentar el período de Time-Out y, a continuación, vuelva a ejecutar TFSDeleteProject.

  5. TFSDeleteProject elimina inmediatamente los elementos de trabajo y los campos de elementos de trabajo que pertenecen al proyecto especificado y elimina todos los metadatos no compartidos.

    Si el proyecto especificado contiene una gran cantidad de datos de elementos de trabajo, es posible que la eliminación no finalice dentro del período de tiempo de espera.

    Para solucionar este problema, consulte Aumentar el período de Time-Out y, a continuación, vuelva a ejecutar TFSDeleteProject.

Fase 2: TFSDeleteProject elimina sitios web del proyecto

En la segunda fase, TFSDeleteProject elimina los datos siguientes:

Importante

Estos pasos pueden tardar mucho tiempo en completarse y, durante ese tiempo, pueden degradar el rendimiento del servidor.

  • TFSDeleteProject usa las API de Reporting Services para eliminar informes en el servidor que hospeda Reporting Services.
  • TFSDeleteProject Elimina el sitio web del portal del proyecto del servidor que hospeda Productos de SharePoint.

Este paso solo se produce si el proyecto posee el sitio y la eliminación del sitio no está excluida en la línea de comandos. (Tenga en cuenta que varios proyectos pueden apuntar a un único sitio, pero solo uno de ellos puede ser el propietario donde los informes o paneles están de forma predeterminada mediante este proyecto).

Nota

Antes de eliminar un proyecto, puede confirmar que Reporting Services y Productos de SharePoint usan las direcciones URL de proyecto correctas comprobando la configuración del portal. Para obtener más información, consulte Añadir un portal de proyectos.

Si TFSDeleteProject elimina correctamente todos los elementos de datos anteriores, devuelve el mensaje Listo.

Para comprobar este resultado, consulte "Verificar que los componentes del proyecto han sido eliminados".

Si no se quitan uno o varios componentes, puede volver a ejecutar TFSProjectDelete mediante la opción /force para continuar con el proceso de eliminación aunque no pueda eliminar todos los elementos de datos.

Con esta opción TFSDeleteProject, omite un componente que no puede eliminar, devuelve un mensaje de error, elimina el siguiente componente y deja intactos los metadatos del proyecto y la configuración de seguridad.

Datos que pueden permanecer indeletados

Los datos siguientes pueden permanecer en la implementación después de que TFSDeleteProject se complete correctamente:

  • datos del proyecto en el cubo.

    Los datos del proyecto permanecen en el cubo hasta que se vuelve a generar el cubo, en cuyo momento el servicio del controlador de almacenamiento quita todos los datos de compilación históricos que se han eliminado de las bases de datos de Azure DevOps.

  • Construir archivos y carpetas de entrega.

    Los archivos binarios de compilación, los archivos de registro de compilación y los archivos de registro que contienen los resultados de las pruebas se publican durante el proceso de compilación.

    Las ubicaciones de estos archivos no se eliminan. Si desea quitar estos archivos, debe quitarlos manualmente.

  • Metadatos de seguimiento de elementos de trabajo compartidos.

    TFSDeleteProject no elimina ningún metadato para el seguimiento de elementos de trabajo que se comparte entre proyectos.

  • conjuntos de estantes de control de versiones que contienen código compartido.

    Los "shelvesets" de control de versiones no se eliminan si contienen código de varios proyectos.

Comprobación de la eliminación del proyecto

Para comprobar el éxito de la eliminación de un proyecto, confirme que el nodo del proyecto ya no aparece en Team Explorer y que su sitio web del portal de proyectos y las carpetas de informes ya no existen.

  1. Abra Team Explorer y compruebe que el proyecto no aparece como un nodo de proyecto.

  2. Abra Internet Explorer y escriba la dirección URL del sitio web del portal del proyecto. Compruebe que el sitio ya no existe.

  3. En Internet Explorer, en el cuadro Dirección, escriba la dirección URL del sitio web de Reporting Services con uno de los siguientes formatos de dirección URL:

    • http://ReportingServices/Reports
    • http://ReportingServices/Reports_TFSInstance

  4. En el Administrador de informes, elija Mostrar detalles.

  5. Compruebe que la carpeta del proyecto eliminado ya no aparece.

    Elija la carpeta raíz TfsReports y, a continuación, elija la carpeta denominada para la colección de proyectos.

    Ya no debe haber una carpeta con el nombre del proyecto eliminado.

  6. Si los informes o el sitio web permanecen, consulte el procedimiento siguiente.

Quitar componentes restantes después de la eliminación parcial del proyecto

Si el sitio web del portal del proyecto y la carpeta de informes permanecen después de eliminar un proyecto, quite el sitio y la carpeta manualmente.

  1. Inicie sesión en el servidor que hospeda Reporting Services para el proyecto que eliminó.

  2. Abra Internet Explorer y, en el cuadro Dirección, escriba la dirección URL del sitio web de Reporting Services con uno de los siguientes formatos de dirección URL:

    • http://localhost/Reports
    • http://localhost/Reports_TFSInstance

  3. En el Administrador de informes, elija Mostrar detalles.

  4. Elija la carpeta raíz TfsReports y, a continuación, elija la carpeta denominada para la colección de proyectos.

  5. Seleccione la casilla para el proyecto que se eliminó.

  6. Elija Eliminar.

  7. Elija Aceptar para confirmar que desea eliminar la carpeta de informes del proyecto.

  8. Para quitar el sitio web del portal de proyectos de un proyecto eliminado, consulte la página siguiente en el sitio web de Microsoft:

Crear, Editar y Eliminar sitios de Windows SharePoint Services.

Aumento del período de tiempo de espera

De forma predeterminada, cada llamada de servicio web que emite el comando TFSDeleteProject para eliminar un componente debe completarse en un plazo de 10 minutos. Si hay seis llamadas, el proceso podría tardar hasta una hora. Si desea eliminar un proyecto asociado a una gran cantidad de datos, puede aumentar temporalmente este período de tiempo de espera.

Nota

Al aumentar el período de tiempo de espera, el cambio afecta a todas las llamadas de servicio web. En general, desea mantener el período de tiempo de espera en un plazo de 10 minutos para evitar que las llamadas de servicio web degraden el rendimiento del servidor y que los usuarios queden bloqueados en el uso de la interfaz de usuario durante largos períodos de tiempo. Por lo tanto, después de eliminar correctamente el proyecto, debe restablecer el período de espera a 10 minutos.

Prerrequisitos

Para completar estos procedimientos, debe ser administrador de Windows en el servidor de nivel de aplicación.

Importante

Modificar incorrectamente el registro del equipo puede hacer que el equipo se vuelva inestable. Si no está familiarizado con el Registro, no debe agregar ni quitar entradas ni modificarlas de ninguna manera.

  1. Inicie sesión en el servidor de nivel de aplicación.

  2. Elija Inicio, Ejecutar, escriba regedit y, a continuación, elija Aceptar.

  3. En el panel del explorador, expanda HKEY_ LOCAL_MACHINE:

    • Si el servidor ejecuta un sistema operativo de 32 bits, expanda: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\11.0\TeamFoundation\RequestSettings.
    • Si el servidor ejecuta un sistema operativo de 64 bits, expanda: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432\Microsoft\VisualStudio\11.0\TeamFoundation\RequestSettings.

  4. Si la clave TeamFoundation\RequestSettings no existe, siga estos pasos para crearla:

    1. Abra el menú contextual de TeamFoundation, seleccione Nuevo y elija Clave.
    2. Nombre la clave 'RequestSettings'.
    3. Abra el menú contextual de RequestSettings, seleccione Nuevo y elija Valor DWORD.
    4. Asigne al nuevo valor el nombre DefaultTimeout.

  5. Abra el menú contextual de DefaultTimeout y elija Modificar.

  6. En Datos de valor, escriba el período de tiempo de espera en milisegundos y, a continuación, elija Decimal.

    Por ejemplo, para aumentar el período de tiempo de espera a 30 minutos, escriba 1800000. Para cambiar el período de tiempo de espera a 10 minutos, escriba 600000.

  7. Elija Aceptar.

  8. En el menú Archivo, elija Salir.

Ejemplo

El comando siguiente quita todos los componentes asociados al proyecto StoreFront en el servidor AdventureWorks1 de Azure DevOps Server en la colección de proyectos Collection1 y de Team Explorer.

TFSDeleteProject /force /collection:http://AdventureWorks1:8080/tfs/Collection1 StoreFront