Destrucción de archivos con control de versiones

  • Artículo

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

Visual Studio 2019 | Visual Studio 2022

Con el tiempo, un servidor de control de versiones contiene un número creciente de archivos y carpetas. Esto puede provocar problemas al intentar administrar los requisitos de espacio en disco. Es posible que se le obligue a quitar todos los proyectos y sus jerarquías del control de versiones. Por ejemplo, un proyecto podría crearse solo con fines de aprendizaje, o quizás un virus haya contaminado algunos archivos. Por lo tanto, como administrador de TFVC, en ocasiones es posible que tenga que destruir archivos y carpetas que están con control de versiones.

En el procedimiento siguiente se muestra cómo destruir archivos y carpetas mediante el comando tf destroy. Aunque los archivos se quitan permanentemente, puede conservar el historial asociado a ellos. A fin de obtener más información sobre las opciones y argumentos disponibles para tf destroy, vea Comando Destroy (Control de versiones de Team Foundation).

Nota:

La operación destroy solo está disponible desde la línea de comandos.

Requisitos previos

  • Para usar el comando destroy, debe ser un miembro del grupo de seguridad Administradores de Team Foundation. Para obtener más información, vea Permisos predeterminados de TFVC.

  • Para ejecutar tf destroy sin la opción /keephistory, elimine primero los archivos que quiere destruir. Para obtener más información, vea Eliminación de archivos y carpetas del control de versiones. Después de eliminar un archivo, su nombre de archivo ahora incluye un id. de eliminación. Por ejemplo, si un nombre de archivo es aFile.cs, después de eliminar el nombre de archivo será aFile.cs;x123, donde x123 es el id. de eliminación.

    Después de eliminar los archivos, puede sincronizar el almacén de TFVC. De lo contrario, el almacén no se sincronizará con los elementos destruidos.

Destrucción permanente de archivos controlados por versiones

En Windows, seleccione Iniciar y luego escriba Símbolo del sistema para desarrolladores. En los resultados de la búsqueda, seleccione el símbolo del sistema para desarrolladores de la versión de Visual Studio, como Developer Command Prompt for Visual Studio 2022 (Símbolo del sistema para desarrolladores de Visual Studio 2022).

  • Para obtener una vista previa de la destrucción del archivo aFile.cs sin destruirlo, escriba lo siguiente en el símbolo del sistema:

    tf destroy /preview /i $/MyTeamProject/aFile.cs

    Nota:

    El texto de la ventana del símbolo del sistema muestra Destroyed: $/MyTeamProject/aFile.cs, pero el archivo no se destruye realmente cuando se usa la opción /preview.

  • Para destruir el archivo aFile.cs, escriba lo siguiente en el símbolo del sistema:

    tf destroy /i $/MyTeamProject/aFile.cs

    En este comando se muestra información sobre los posibles cambios pendientes y los conjuntos de cambios agregados pendientes de confirmación en la ventana del símbolo del sistema. Si especifica /i o no interactivo, no aparecerá el cuadro de diálogo Sí, No o Sí a todo antes de quitar permanentemente los archivos.

  • Para destruir todos los archivos de aFolder y, al mismo tiempo, conservar su historial, escriba lo siguiente:

    tf destroy /keephistory $/MyTeamProject/aFolder

    Nota:

    No se puede especificar /preview con /keephistory.

    Esta acción conserva la información histórica sobre todos los archivos de aFolder. Puede usar el comando tf history para ver el historial de un archivo. También puede ver el historial en el Explorador de control de código fuente en Visual Studio. Para obtener más información, vea Comando History y Obtención del historial de un elemento.

  • Use la opción /stopat para conservar la información histórica hasta un momento determinado, incluido un valor versionspec. El valor versionspec puede ser la versión más reciente, un conjunto de cambios específico o una fecha. Para obtener más información sobre los valores versionspec, vea Uso de comandos de Control de versiones de Team Foundation.

    Para destruir todos los archivos del proyecto MyTeamProject y, al mismo tiempo, conservar el historial de los archivos hasta el 23/10/2005, incluido, escriba lo siguiente:

    tf destroy $/MyTeamProject /keephistory /stopat:D10/23/2005

  • Use la opción /startcleanup para limpiar inmediatamente los metadatos de TFVC de los archivos a los que ya no hace referencia Azure DevOps Server. Sin esta opción, esos metadatos se quitan cuando la base de datos la mantiene un proceso SQL que se ejecuta cada cinco días. Siete días después de la eliminación de metadatos de TFVC, otro proceso SQL eliminará el contenido de los archivos destruidos.

    Para destruir inmediatamente todos los archivos de aFolder, escriba lo siguiente:

    tf destroy /startcleanup $/MyTeamProject/aFolder