Git Convert: um passo na migração do SVN para o Git

Onde ＜svn-repo＞ é o URI do repositório SVN que você quer migrar e, ＜project＞ é o nome do projeto que você quer importar e ＜git-repo-name＞ é o nome do diretório do novo Repositório do Git.

Por exemplo, se você estivesse migrando um projeto chamado Confluence, hospedado em https://svn.atlassian.com, você poderia executar o seguinte comando:

Se o repositório SVN não tiver um layout padrão, vai ser preciso informar as localizações do seu tronco, ramificações e marcações usando as opções de linha de comando --trunk, --branches e --tags. Por exemplo, se você tiver ramificações armazenadas nos diretórios /branches e /bugfixes, o seguinte comando seria utilizado:

Após o término do git svn clone (que pode demorar um pouco), você vai ver um novo diretório chamado ＜git-repo-name＞ em ~/GitMigration. Esse é o repositório convertido do Git. Você deve conseguir acessar o ＜ git-repo-name＞ e executar qualquer um dos comandos padrão do Git para explorar seu projeto.

Ramificações e marcações não são importadas para o novo repositório do Git como você pode esperar. Você não vai ver nenhuma das suas ramificações do SVN na saída do git branch, nem nenhuma das suas marcações do SVN na saída do git tag. Mas, se executar git branch -r, você vai ver todas as ramificações e marcações do seu repositório SVN. O comando git svn clone importa suas ramificações do SVN como ramificações remotas e importa as marcações do SVN como ramificações remotas prefixadas com tags/.

Esse comportamento facilita certos procedimentos de sincronização bidirecional, mas tentar fazer uma migração unidirecional do Git pode ser muito confuso. É por isso que nosso próximo passo é converter as ramificações remotas em ramificações locais e marcações reais do Git.

O script clean-git incluso no svn-migration-scripts.jar transforma as ramificações do SVN em ramificações locais do Git e as marcações do SVN em marcações do Git completas. Observe que esta é uma operação destrutiva e não vai ser possível mover os commits do repositório do Git de volta ao repositório SVN.

Se você estiver seguindo este guia de migração, isso não é um problema, pois ele defende uma sincronização unidirecional do SVN para o Git (o repositório do Git é considerado como somente leitura até depois da etapa Migrar). No entanto, se você está planejando fazer commit nos repositórios do Git e do SVN durante o processo de migração, não execute os comandos a seguir. Essa é uma tarefa avançada e não é recomendada para o projeto típico.

Para ver o que pode ser limpo, execute o comando a seguir em ~/GitMigration/< git-repo-name>:

Isso vai exibir todas as alterações que o script quer fazer, mas na verdade não vai implementar nenhuma delas. Para realizar essas alterações, é preciso usar a opção --force, assim:

Agora você deve ver todas as suas ramificações do SVN na saída do git branch, junto com suas marcações do SVN na saída do git tag. Isso significa que você converteu com sucesso seu projeto do SVN em um repositório do Git.

Nesta etapa, você transformou um repositório do SVN em um novo repositório do Git com o comando git svn clone e, em seguida, limpou a estrutura do repositório resultante com o svn-migration-scripts.jar. Na próxima etapa, você vai aprender como manter esse novo repositório do Git sincronizado com quaisquer novos commits realizados no repositório do SVN. Esse processo vai ser semelhante à conversão, mas há algumas considerações importantes sobre o fluxo de trabalho durante esse período de transição.