Partilhar via

Destrua arquivos com controle de versão

  • Artigo

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 comando tf destroy. 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, consulte comando Destroy (Team Foundation Version Control).

Observação

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

Pré-requisitos

  • Para utilizar o comando destroy, seja membro do grupo de segurança Team Foundation Administrators . Para obter mais informações, 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, 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 repositório 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, escolha o terminal de comandos para a sua versão do Visual Studio, como Developer Command Prompt 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

    Observação

    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

    Este comando exibe informações sobre possíveis alterações pendentes e shelvesets na janela do prompt de comando. Se especificar /i ou não interativo, não será apresentado um diálogo de Sim, Nãoou Sim para Todos antes de os ficheiros serem removidos permanentemente.

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

    tf destroy /keephistory $/MyTeamProject/aFolder

    Observação

    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 comando tf history para exibir o histórico de um arquivo. Você também pode ver o histórico no Explorador de Controlo de Código-Fonte no Visual Studio. Para obter mais informações, consulte comando Histórico e Obter o histórico de um item.

  • Utilize a opção /stopat para reter as informações históricas até um valor versionspec inclusive. O valor versionspec pode ser a versão mais recente, um conjunto de alterações específico ou uma data. Para mais informações sobre os valores versionspec, consulte utilizar comandos de controlo 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 opção /startcleanup 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 aFolder, digite:

    tf destroy /startcleanup $/MyTeamProject/aFolder