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:
- No menu principal Controle de Origem do Jazz, clique em
.
- Na página Selecionar, expanda Controle de Origem do Jazz e
selecione Arquivo de Dump SVN.
Clique em Avançar.
- Na página Importar Arquivo de Dump SVN, clique em Navegar. Navegue até o arquivo de dump que deseja importar e clique em Abrir.
- Opcional: Para salvar um arquivo de dump compactado, selecione Salvar uma versão compactada do arquivo
de dump para importações adicionais.
- Clique em Avançar.
- 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.
- Clique em Avançar.
- 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.
- Clique em Avançar.
- 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.
- 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.
- Clique em Avançar.
- 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.
- Clique em Concluir para exibir o conteúdo (pastas e usuários) do arquivo de dump
de Subversão selecionado.
- 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.
- Para mapear nomes de usuário, clique em Avançar.
- 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.
- 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.