Como criar chave SSH e usar no GitLab

Guia passo a passo para configuração

Introdução

Este guia ensina como criar uma chave SSH e configurá-la no GitLab. Isso melhora a segurança ao acessar e gerenciar seus repositórios.

Pré-requisitos

  • GitLab: Já instalado e configurado.

Abrindo o Terminal

No Windows, abra o Prompt de Comando ou PowerShell. No Linux ou Mac, abra o Terminal.

Criando a chave SSH

Digite este comando para criar a chave:

ssh-keygen -t rsa -b 4096 -C "[email protected]"

Quando solicitado, pressione Enter para confirmar o local padrão e, se preferir, deixe a senha em branco.

Localizando a chave

O arquivo será salvo na pasta padrão:

C:\Users\SEU-USUARIO\.ssh

Substitua SEU-USUARIO pelo nome do seu usuário no sistema.

Copiando a chave pública

Abra o arquivo id_rsa.pub com um editor de texto, como o Bloco de Notas, e copie todo o conteúdo.

Adicionando a chave no GitLab

No GitLab, acesse Configurações do Usuário > SSH Keys. Clique em Add new key, cole a chave copiada e salve.

Testando a configuração

Para confirmar que tudo está funcionando, abra um projeto no GitLab e clique em Code. Escolha a opção Clone with SSH e copie o comando exibido.

No Windows, navegue até uma pasta desejada no Prompt de Comando ou PowerShell, e execute o comando copiado. Por exemplo:

git clone [email protected]:usuario/projeto.git

Se for a primeira vez que você usa essa chave, poderá receber um aviso de fingerprint pedindo confirmação da autenticidade do host. Digite yes para continuar. Isso adicionará o servidor GitLab à lista de hosts conhecidos.

Se tudo estiver configurado corretamente, o repositório será clonado na pasta selecionada.

Conclusão

Agora você pode usar a chave SSH para acessar seus repositórios no GitLab com segurança. Caso tenha problemas, revise os passos ou consulte a documentação do GitLab.

Carregando...