Compartilhar via

Destruir arquivos controlados por versão

  • Artigo

Azure DevOps Services | 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 à medida que você tenta 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 administrador do TFVC, ocasionalmente, talvez seja necessário destruir arquivos e pastas que estão sob controle de versão.

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

Nota

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 de Administradores do Team Foundation. Para saber mais, consulte Permissões padrão do TFVC.

  • Antes de executar tf destroy sem a opção /keephistory, 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, o nome do 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, em que x123 é a ID de exclusão.

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

Para destruir permanentemente arquivos controlados por versão

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 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 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, manter seu histórico, insira:

    tf destroy /keephistory $/MyTeamProject/aFolder

    Nota

    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. Você pode usar o comando tf history 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 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 obter mais informações sobre valores versionspec, 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, insira:

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

  • Use a opção /startcleanup para limpar imediatamente os metadados do TFVC dos arquivos que não são mais referenciados pelo Servidor do Azure DevOps. 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 de metadados do TFVC, o conteúdo dos arquivos destruídos será excluído por outro processo SQL.

    Para destruir imediatamente todos os arquivos em aFolder, insira:

    tf destroy /startcleanup $/MyTeamProject/aFolder