Partilhar via


Destrua arquivos com controle de versão

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Com o tempo, um servidor de controle de versão adquire um número crescente de arquivos e pastas. Isso pode causar problemas ao tentar gerenciar os requisitos de espaço em disco. Você pode ser forçado a remover todos os projetos e suas hierarquias do controle de versão. Por exemplo, um projeto pode ser criado apenas para fins de aprendizagem ou talvez alguns arquivos estejam contaminados com um vírus. Portanto, como um administrador TFVC, ocasionalmente você pode ter que destruir arquivos e pastas que estão sob controle de versão.

O procedimento a seguir mostra como destruir arquivos e pastas usando o tf destroy comando. Embora os arquivos sejam removidos permanentemente, você pode manter o histórico associado a eles. Para obter mais informações sobre as opções e argumentos disponíveis para tf destroyo , consulte Comando Destroy (Team Foundation Version Control).

Nota

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

Pré-requisitos

  • Para usar o destroy comando, você deve ser um membro do grupo de segurança Team Foundation Administrators . Para obter mais informações, consulte Permissões TFVC padrão.

  • Antes de executar tf destroy sem a /keephistory opção, primeiro exclua os arquivos que deseja destruir. Para obter mais informações, consulte Excluir arquivos e pastas do controle de versão. Depois de excluir um arquivo, seu nome de arquivo agora inclui uma ID de exclusão. Por exemplo, se um nome de arquivo for aFile.cs, após a exclusão, o nome do arquivo será aFile.cs; x123, onde x123 é o ID de exclusão.

    Depois de excluir os arquivos, você pode sincronizar o depósito TFVC. Caso contrário, o armazém não será sincronizado com os itens destruídos.

Para destruir permanentemente ficheiros com controlo de versão

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

  • Para visualizar a destruição do arquivo aFile.cs sem destruí-lo, digite no prompt de comando:

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

    Nota

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

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

    tf destroy /i $/MyTeamProject/aFile.cs
    

    Este comando exibe informações sobre possíveis alterações pendentes e prateleiras na janela do prompt de comando. Se você especificar /i ou não interativo, não será solicitado com uma caixa de diálogo Sim, Não ou Sim para Todos antes que os arquivos sejam removidos permanentemente.

  • Para destruir todos os arquivos em aFolder e, ao mesmo tempo, manter seu histórico, digite:

    tf destroy /keephistory $/MyTeamProject/aFolder
    

    Nota

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

    Esta ação retém as informações históricas sobre todos os arquivos em aFolder. Você pode usar o tf history comando para exibir o histórico de um arquivo. Você também pode exibir o histórico no Gerenciador de Controle do Código-Fonte no Visual Studio. Para obter mais informações, consulte Comando Histórico e Obter o histórico de um item.

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

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

    tf destroy $/MyTeamProject /keephistory /stopat:D10/23/2005
    
  • Use a /startcleanup opção para limpar imediatamente os metadados TFVC dos arquivos que não são mais referenciados pelo Azure DevOps Server. Sem essa opção, esses metadados são removidos quando o banco de dados é mantido por um processo SQL que é executado a cada cinco dias. Sete dias após a exclusão dos metadados do TFVC, o conteúdo dos arquivos destruídos será excluído por outro processo SQL.

    Para destruir imediatamente todos os arquivos em uma pasta, digite:

    tf destroy /startcleanup $/MyTeamProject/aFolder