Exportar os repositórios de origem do GitHub Enterprise Server
Depois de bloquear os repositórios de origem, você pode exportá-los individualmente ou em lote usando uma lista de URLs de repositório em um arquivo de texto. Feito isso, você criará um único arquivo de migração para o processo de importação.
Note: Locking a repository prevents users from pushing to the repository or modifying a repository's resources, like issues, labels, milestones, wikis, and comments. New teams and collaborators can't be associated with a locked repository.
If you're performing a trial run, you don't need to lock repositories. Otherwise, it's highly recommended. Para obter mais informações, consulte "Sobre migrações".
-
SSH into sua instância do GitHub Enterprise Server.
$ ssh -p 122 admin@HOSTNAME
-
Para preparar a exportação de um repositório, use o comando
ghe-migrator add
com a URL do repositório:-
Se você estiver bloqueando o repositório, adicione
--lock
ao comando. Se estiver executando um teste, não será necessário incluir--lock
.$ ghe-migrator add https://hostname/username/reponame --lock
-
Você pode excluir anexos de arquivos adicionando
--exclude_attachments
ao comando. Anexos de arquivos podem ser grandes e gerar um volume desnecessário no seu arquivo de migração final. -
Para preparar a exportação de vários repositórios de uma só vez, crie um arquivo de texto listando cada URL do repositório em uma linha separada e execute o comando
ghe-migrator add
com o sinalizador-i
e o caminho para o seu arquivo de texto.$ ghe-migrator add -i PATH/TO/YOUR/REPOSITORY_URLS.txt
-
-
Quando solicitado, informe seu nome de usuário do GitHub Enterprise Server:
Insira o nome de usuário autorizado para a migração: admin
-
Quando o token de acesso pessoal for solicitado, informe o token de acesso que você criou na seção "Preparar a instância de origem do GitHub Enterprise Server":
Insira o token de acesso pessoal: **************
-
Após a conclusão do
ghe-migrator add
, ele imprimirá o "GUID de Migração" exclusivo gerado para identificar a exportação e a lista dos recursos adicionados à exportação. Você usará o GUID de Migração gerado nas etapas subsequentesghe-migrator add
eghe-migrator export
para informar que oghe-migrator
deve continuar operando na mesma exportação.> 101 modelos adicionados na exportação > GUID de Migração: exemplo-guid-migração > Número de registros nesta migração: > usuários | 5 > organizações | 1 > repositórios | 1 > equipes | 3 > branches_protegidos | 1 > revisões_solicitações_pull | 1 > marcos | 1 > problemas | 3 > solicitações_pull | 5 > comentários_revisões_pull_requests | 4 > comentários_commit | 2 > comentários_problema | 10 > problema_eventos | 63 > versões | 3 > anexos | 4 > projetos | 2
Sempre que você adicionar um novo repositório com o GUID de Migração atual, ele atualizará a exportação atual. Se você executar
ghe-migrator add
novamente sem GUID de Migração, ele vai iniciar uma nova exportação e gerar um novo GUID de Migração. Não reutilize o GUID de Migração gerado durante uma exportação quando você começar a preparar a migração para importar. -
Se você bloqueou o repositório de origem, é possível usar o comando
ghe-migrator target_url
para personalizar uma mensagem de bloqueio na página de repositório que vincula ao novo local do repositório. Informe a URL do repositório de origem, a URL do repositório de destino e o GUID de Migração da Etapa 5:$ ghe-migrator target_url https://hostname/username/reponame https://target_hostname/target_username/target_reponame -g MIGRATION_GUID
-
Para adicionar mais repositórios à mesma exportação, use o comando
ghe-migrator add
com o sinalizador-g
. Informe a nova URL do repositório e o GUID de Migração da Etapa 5:$ ghe-migrator add https://hostname/username/other_reponame -g MIGRATION_GUID --lock
-
Quando terminar de adicionar os repositórios, gere o arquivo de migração usando o comando
ghe-migrator export
com o sinalizador-g
e o GUID de Migração da Etapa 5:$ ghe-migrator export -g MIGRATION_GUID > Archive saved to: /data/github/current/tmp/MIGRATION_GUID.tar.gz
- To specify where migration files should be staged append the command with
--staging-path=/full/staging/path
. Defaults to/data/user/tmp
.
- To specify where migration files should be staged append the command with
-
Fechar a conexão com sua instância do GitHub Enterprise Server:
$ exit > logout > Connection to hostname closed.
-
Copie o arquivo de migração para o seu computador usando o comando
scp
. O arquivo terá o nome do GUID de Migração:$ scp -P 122 admin@hostname:/data/github/current/tmp/MIGRATION_GUID.tar.gz ~/Desktop
-
To import the archived migration data to a GitHub Enterprise Server instance, see "Importing migration data to GitHub Enterprise Server".