Saltar para o conteúdo

Configurando Mirror entre repositórios: Gitlab para Github

fevereiro 26, 2026

Aprenda o que é um Mirror de repositórios e a como configurar um de forma rápida

landscape

Afinal, o que é um Mirror de repositórios?

Imagine que você trabalha em uma empresa de Desenvolvimento de Software, e junto com a sua equipe vocês desenvolveram uma solução para um cliente da Companhia, e agora ele deseja ter acesso ao código fonte da aplicação. Como você faria isso? Existem muitas maneiras de passar esse acesso, e uma delas é o Mirror. Com ele, você faz de fato um espelhamento(Mirror), onde criamos um repositório em branco (em nosso exemplo, na conta do cliente), e ele será atualizado com todo o código e futuras mudanças de um repositório já existente(repositório da empresa).

Passo a passo para configurar o seu Mirror

Confira abaixo os passos para realizar a configuração de um Mirror partindo do Gitlab para o Github de forma fácil e rápida.

1. Acesseu o seu repositório de origem

Em nosso caso, esse se encontra no GitLab. Após entrar no projeto, siga o seguinte caminho dentro dele:

settings → Repository → Mirroring repositories → Add new

landscape
Procurando a área de Repository dentro do Projeto

landscape
Selecionando Mirroring repositories

2. Adicione o Git repository URL do seu repositório de destino

Pode ser https ou ssh, mas lembre-se de respeitar os formatos que o Gitlab espera.

landscape
Adicionando endereço git do repositório de destino

3. Termine a configuração

Nessa mesma tela, antes de partirmos para a próxima etapas precisamos configurar outras coisas, sendo elas:

  1. Em Authentication method, escolha SSH public key
  2. Em Username, coloque git
  3. Selecione a opção Detect host keys (será gerado alguns Fingerprints ao realizar essa ação)

Após essas configurações, clique em Mirror repository.

landscape
Configurando outros tópicos para o Mirror dentro do Gitlab

4. Conferindo a configuração

Após os passos anterior, sua área de Mirrroring repositories deve estar desta forma:

landscape
Conferindo configuração e copiado chave pública

Clique em copiar a chave SSH pública e guarde esse valor, vamos precisar dele no futuro.

Important

Não feche essa tela, vamos precisar usar ela adiante

5. Acesse seu repositório de destino

Copie a chave pública que foi gerada. Agora vamos no github e acesse:

settings → access → SSH and GPG keys

landscape
Acessando as configurações de SSH e GPG Keys

6. Selecione New SSH key

landscape
Adicionando nova SSH Key

7. Passando a chave pública do Gitlab

Coloque um nome, no campo Key type escolha Authentication Key, cole a chave públia que copiamos no 4º passo e clique em Add SSH key

Note

Essa etapa pode pedir a sua senha do Github para salvar

landscape
Review da chave pública adicionada

8. Testando Mirror e conferindo resultados

Volte no gitlab, e selecione a opção update now para atualizar o seu repositório de destino

landscape
Atualizando o repositório de destino a partir do origem

Note

No print acima, eu já havia clicado nem atualizar, por isso os campos de Last update attempt e Last sucessful update foram alterados.

Olhando o repositório no Github, conseguimos ver que o mesmo foi atualizado:

landscape
Visualizando repositório de destino atualizado com o repositório de origem

landscape
Visualização de quando foi atualizado seu repositório

Última modificação