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 destroy
o , 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 umversionspec
valor. Oversionspec
valor pode ser a versão mais recente, um conjunto de alterações específico ou uma data. Para obter mais informações sobreversionspec
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