Importando um Arquivo de Dump de Subversão

Um arquivo de dump de Subversão (SVN) inclui o conteúdo completo de um repositório de Subversão. É possível importar o arquivo completo de dump da Subversão (ou parte dele) para um novo componente existente.
Antes de Iniciar
Você deve ser um administrador do Repositório do Jazz para mapear nomes de usuário. Se você não mapear nomes de usuário, todos os arquivos e todas as pastas importadas são de propriedade de quem executou a importação.
Por Que e Quando Desempenhar Esta Tarefa

Para criar um arquivo de dump de Subversão, utilize o comando de Subversão svnadmin dump. Os arquivos de dump podem ser filtrados para remoção de conteúdos de repositório que não desejar importar para Controle de origem do Rational Team Concert. Para obter informações adicionais sobre a criação e filtragem de arquivos de dump de Subversão, consulte http://svnbook.red-bean.com/en/1.1/re31.html ou a documentação de Subversão em http://subversion.tigris.org/.

Há duas fases para importação de um arquivo de dump de Subversão. Na primeira fase, você especifica a origem da importação (um arquivo de dump de Subversão) e o destino (um componente em um espaço de trabalho de repositório). Na segunda fase, o importador abre o arquivo de dump e exibe uma lista de pastas que podem ser selecionadas para importação e uma lista de nomes de usuários de Subversão que podem ser mapeados em usuários do Jazz.

Para importar um arquivo de dump de Subversão:

  1. No menu principal Controle de Origem do Jazz, clique em Arquivo > Importar.
  2. Na página Selecionar, expanda Controle de Origem do Jazz e selecione Arquivo de Dump SVN. Clique em Avançar.
  3. Na página Importar Arquivo de Dump SVN, clique em Navegar. Navegue até o arquivo de dump que deseja importar e clique em Abrir.
  4. Opcional: Para salvar um arquivo de dump compactado, selecione Salvar uma versão compactada do arquivo de dump para importações adicionais.
  5. Clique em Avançar.
  6. Na página Importar no espaço de trabalho e componente, especifique um espaço de trabalho e componente de destino para a importação:
    Dica: Se estiver importando o tronco, crie um novo componente para ele. Se estiver importando uma ramificação, selecione uma linha de base de componente que tenha sido criada durante a importação do tronco anterior.
    • Para importar um espaço de trabalho de repositório e componente existente, selecione Selecionar um componente em um espaço de trabalho de repositório existente e selecione o espaço de trabalho e componente.
    • Para importar em um novo componente em um espaço de trabalho de repositório existente, selecione Selecionar um componente em um espaço de trabalho de repositório existente e clique em Novo componente. Digite um nome para o novo componente.
    • Para criar um novo espaço de trabalho de repositório e componente para receber a importação, selecione Criar um novo nome de espaço de trabalho de repositório e digite um nome para o novo espaço de trabalho. A importação cria um novo espaço de trabalho e componente. O componente possui o mesmo nome que o espaço de trabalho.
  7. Clique em Avançar.
  8. Opcional: Na página Configurar importação do SVN para o Jazz, conclua qualquer uma das seguintes etapas:
    • Especificar um nome de linha de base, no campo Nome da Linha de Base Pós-importação, digite um novo nome de linha de base.
    • Gerar linhas de base para ramificações e pontos de tag, selecione Criar linha de base para ramificação e pontos de tag.
    • Especificar uma codificação de arquivo de texto, na área de janela Codificação de arquivo de texto, selecione Outro. Na lista drop-down, selecione um tipo de codificação.
    • Para reconciliar arquivos existentes e importados, selecione Reconciliar qualquer sobreposição entre arquivos e pastas importadas existentes.
    • Para especificar um intervalo de revisão a ser importado, na área de janela Revisões a serem importadas, selecione Importar todas as revisões dentro do intervalo especificado. Nos campos Revisão Inicial e Revisão Final, especifique o intervalo de revisão.
  9. Clique em Avançar.
  10. Opcional: Na página Mapeamento de Usuário, complete qualquer uma das seguintes etapas:
    • Para adiar o mapeamento de usuários até depois do arquivo de dump SVN ter sido lido e a lista de usuários exibida, selecione Solicitar por usuários do Jazz depois dos IDs de usuário SVN terem sido descobertos.
    • Para não mapear usuários, selecione Não mapear usuários do SVN em usuários do Jazz.
    • Para mapear automaticamente nomes de usuários com o mesmo ID e criar usuários que estão faltando, selecione Mapear automaticamente usuários do SVN em usuários do Jazz com o mesmo ID e criar todos os usuários que estão faltando.
  11. Opcional: Na página Mapeamentos de Usuário, para mapear manualmente usuários do SVN em usuários do Jazz, selecione Utilizar os mapeamentos digitados a seguir e conclua uma das seguintes etapas:
    • Para incluir um usuário do SVN, clique em Incluir usuário do SVN. Na caixa de diálogo Incluir um ID de usuário do SVN, digite um nome de usuário no campo e clique em OK.
    • Para criar um novo usuário do Jazz com o mesmo ID de usuário como um usuário de Subversão, na coluna ID de Usuário do SVN, selecione um nome e, em seguida, clique em Criar usuários do Jazz.
    • Para mapear um ID de usuário do SVN em um usuário existente do Jazz, na coluna ID de Usuário do SVN, selecione um nome e, em seguida, clique em Alterar usuário do Jazz. Na caixa de diálogo Selecionar usuários, digite um nome de usuário do Jazz no campo e clique em OK.
    • Para remover um usuário de Subversão, clique no nome de usuário e, em seguida, clique em Remover.
    • Para salvar os mapeamentos atuais em um arquivo que você possa reutilizar para importações futuras, clique em Salvar.
    • Para reutilizar um arquivo de mapeamento que você criou em uma importação anterior, clique em Carregar.
  12. Clique em Avançar.
  13. Na página Caminhos de Projeto, para especificar os caminhos de projetos a serem importados, conclua uma das seguintes etapas:
    • Se não tiver certeza da estrutura do repositório de Subversão, selecione Solicitar para determinar quais pastas importar quando a estrutura de pastas do repositório do SVN for conhecida.
    • Para importar um caminho como uma pasta de nível superior no componente de destino, selecione Importar os caminhos especificados a seguir como pastas de nível superior no componente de destino. Para incluir um caminho, clique em Incluir Caminho e, na caixa de diálogo Incluir Caminho, digite o nome do caminho no campo caminho e clique em OK. Para carregar um conjunto de caminhos salvos em um arquivo, clique em Carregar e navegue no arquivo. Para salvar o arquivo em um local especificado, clique em Salvar.
    • Para importar um caminho especificado a seguir como uma raiz de componente, selecione Importar o caminho especificado a seguir como a raiz do componente. Para editar um caminho, selecione-o e, em seguida, clique em Editar. Na caixa de diálogo Editar caminho, no campo Caminho, altere o caminho e clique em OK.
  14. Clique em Concluir para exibir o conteúdo (pastas e usuários) do arquivo de dump de Subversão selecionado.
  15. Nesta fase do processo de importação, selecione as pastas para importar e, se você for um administrador de repositórios, especifique como os nomes de usuário do SVN são mapeados em nomes de usuário do Jazz. Na página Escolher pastas do SVN a serem importadas, na área Pastas localizadas no repositório do SVN, selecione as pastas que deseja importar e conclua uma das etapas a seguir:
    • Para procurar no arquivo por projetos Eclipse, clique em Incluir Projetos ou utilize os botões Incluir e Remover para criar uma lista das pastas que deseja importar.
    • Para salvar a lista de pastas atual em um arquivo que você deseja reutilizar para importações futuras, clique em Salvar.
    • Para reutilizar uma lista de pastas que você criou em uma importação anterior, clique em Carregar.
  16. Para mapear nomes de usuário, clique em Avançar.
  17. Na página Mapeamento de Usuário, especifique qualquer mapeamento de nome de usuário que desejar que o importador faça, ou clique em Não mapear usuários do SVN em usuários do Jazz se desejar que todos os arquivos e todas as pastas importadas sejam de propriedades do usuário do Jazz que está executando o importador.
    • Clique em um nome nesta lista e, em seguida, clique em Alterar usuário do Jazz para visualizar uma lista de nomes de usuário do Jazz para os quais o usuário da Subversão pode ser mapeado.
    • Para criar um novo usuário do Jazz para mapear em um usuário de Subversão, clique em Criar Usuários do Jazz.
    • Para desfazer qualquer mapeamento especificado, clique em Reconfigurar.
    • Para salvar os mapeamentos de usuários atuais em um arquivo para que você possa reutilizá-los para importações futuras, clique em Salvar.
    • Para reutilizar um arquivo de mapeamento de usuário que você criou em uma importação anterior, clique em Carregar.
  18. Para iniciar a importação, clique em Concluir.
Resultados
Depois da importação estar concluída, é possível incluir o novo componente em um fluxo ou, se você tiver importado em um componente existente, entregar os conjuntos de alterações importados, para que outros membros da equipe possam utilizá-los.

Feedback

Isso ajudou? É possível fornecer feedback em Jazz.net (é necessário registrar-se): Comentar nos fóruns ou submeter um erro