Destruir arquivos com controle de versão

  • Artigo

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

Visual Studio 2019 | Visual Studio 2022

Com o passar do tempo, o servidor para controle de versão adquire um número crescente de arquivos e pastas. Isso pode causar problemas na hora de gerenciar os requisitos de espaço em disco. Você pode ter que remover todos os projetos e suas hierarquias do controle de versão. Por exemplo, um projeto pode ser criado apenas para fins de aprendizado ou talvez alguns arquivos estejam contaminados com um vírus. Portanto, como administrador do TFVC, às vezes será necessário destruir arquivos e pastas que estão no controle de versão.

O procedimento a seguir mostra como destruir arquivos e pastas com o comando tf destroy. Embora os arquivos sejam removidos de modo permanente, é possível reter o histórico associado. Se quiser saber mais sobre as opções e os argumentos disponíveis para tf destroy, confira Comando Destroy (Controle de Versão do Team Foundation).

Observação

A operação destroy está disponível apenas na linha de comando.

Pré-requisitos

  • Para usar o comando destroy, é necessário ser membro do grupo de segurança Administradores do Team Foundation. Para saber mais, consulte Permissões padrão do TFVC.

  • Antes de usar o comando tf destroy sem a opção /keephistory, exclua os arquivos que você quer destruir. Para saber mais, confira Excluir arquivos e pastas do controle de versão. Depois disso, o nome do arquivo incluirá uma ID de exclusão. Por exemplo, se o nome do arquivo for aFile.cs, após a exclusão será aFile.cs;x123, em que x123 é a ID de exclusão.

    Depois de excluir os arquivos, sincronize o depósito do TFVC. Se você não fizer isso, o depósito não ficará sincronizado com os itens destruídos.

Destruir arquivos com controle de versão de modo permanente

No Windows, selecione Iniciar e digite Prompt de Comando do Desenvolvedor. Nos resultados da pesquisa, selecione o prompt de comando do desenvolvedor da versão do Visual Studio; por exemplo, Prompt de Comando do Desenvolvedor para Visual Studio 2022.

  • Para pré-visualizar a destruição do arquivo aFile.cs sem eliminá-lo de fato, digite no prompt de comando:

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

    Observação

    O texto na janela do prompt de comando será Destroyed: $/MyTeamProject/aFile.cs, mas o arquivo não é realmente destruído quando você usa a opção /preview.

  • Para destruir o arquivo aFile.cs, digite no prompt de comando:

    tf destroy /i $/MyTeamProject/aFile.cs

    Assim, é possível ver informações sobre possíveis alterações pendentes e check-ins particulares na janela do prompt de comando. Se você especificar /i, ou não interativo, não verá uma caixa de diálogo com as opções Sim, Não ou Sim para todos antes da remoção permanente dos arquivos.

  • Para destruir todos os arquivos em aFolder e, ao mesmo tempo, reter o histórico associado, digite:

    tf destroy /keephistory $/MyTeamProject/aFolder

    Observação

    Não é possível especificar /preview com /keephistory.

    Essa ação retém as informações de histórico sobre todos os arquivos em aFolder. É possível usar o comando tf history para ver o histórico de um arquivo, bem como o Source Control Explorer no Visual Studio. Para saber mais, confira Comando History e Ver o histórico de um item.

  • Use a opção /stopat para reter as informações de histórico até o valor versionspec. O valor versionspec pode ser a versão mais recente, um conjunto de alterações específico ou uma data. Para saber mais sobre os valores versionspec, confira Usar os comandos para controle de versão do Team Foundation.

    Para destruir todos os arquivos no projeto MyTeamProject e, ao mesmo tempo, reter o histórico dos arquivos até 23/10/2005, digite:

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

  • Use a opção /startcleanup para limpar de imediato os metadados do TFVC dos arquivos a que o Azure DevOps Server não faz mais referência. Sem essa opção, os metadados serão removidos do banco de dados quando ocorrer a manutenção realizada pelo processo SQL. Vale lembrar que, sete dias após a exclusão dos metadados do TFVC, o conteúdo dos arquivos destruídos será eliminado por outro processo SQL.

    Para destruir de imediato todos os arquivos em aFolder, digite:

    tf destroy /startcleanup $/MyTeamProject/aFolder