GitLab e chave SSH

O GitLab é o repositório utilizado pela plataforma Olist Ecommerce. Com ele, o time de desenvolvimento pode realizar backups e versionamento do código. A ferramenta facilita também a transferência de sustentação dos projetos entre Olist e agências parceiras.

Acesso a área do parceiro no Gitlab

Para o uso do repositório:

1. Crie uma conta no GitLab para cada desenvolvedor do projeto da sua loja;
2. Envie os e-mails das contas criadas para o time da Olist Ecommerce. O envio deve ser feito inicialmente pelo canal da agência parceira no Discord, ou então para o e-mail ajuda@vnda.com.br com o assunto “Acesso Gitlab”.

Autenticações e Acesso do Gitlab

1. O Gitlab pode exigir que você crie chaves para 2FA também. Você pode fazer isso no celular, pelo aplicativo do Google Authenticator

Criando sua chave SSH

Para fazer uso dos comandos do projeto que se comunicam com o Gitlab, você vai precisar gerar uma chave SSH de comunicação. Este passo é feito uma única vez e fica associado à sua conta no Gitlab, funcionando para todos os projetos ao mesmo tempo.

Abaixo listamos os passos de forma descomplicada, mas você pode ler toda a documentação do Gitlab referente a criação de chave SSH clicando aqui.

Passo a passo resumido

Terminal recomendado para usuários Windows

Recomendamos que você use o terminal “Git Bash”, ou o Powershell Core 7. A indicação e links de instalação estão na aba Aplicativos.

No seu terminal, execute o comando:

Criação de Chave SSH

ssh-keygen -t ed25519 -C "Chave SSH Olist Ecommerce"

Pressione Enter e aparecerá a mensagem abaixo, informando o local e o arquivo onde a chave será salva na sua máquina:

Criação de Chave SSH

Generating public/private ed25519 key pair.
Enter file in which to save the key (/home/user/.ssh/id_ed25519):

Nesta mensagem, pressione Enter para confirmar o caminho e prosseguir. Recomendamos não mudar o caminho onde a chave será salva! Faça isto somente se você souber controlar suas credenciais.

Após confirmar, defina uma senha. As mensagens de criação de senha serão estas (senha e confirmar senha):

Criação de Chave SSH

Enter passphrase (empty for no passphrase):
Enter same passphrase again:

Importante lembrar desta senha, ela será necessária sempre que você executar alguns comandos na loja. Após a definição de senha uma mensagem de confirmação será exibida, encerrando as etapas de criação.

Copie a chave gerada:

Windows (Git Bash ou Powershell Core 7):

Criação de Chave SSH

cat ~/.ssh/id_ed25519.pub | clip

Linux

Criação de Chave SSH

xclip -sel clip < ~/.ssh/id_ed25519.pub

MacOS

Criação de Chave SSH

tr -d '\n' < ~/.ssh/id_ed25519.pub | pbcopy

Após copiar com um dos comandos acima, acesse sua conta no Gitlab:

1. Na barra lateral esquerda, selecione o seu avatar
2. Clique na opção Edit Profile
3. Na barra lateral esquerda, clique na opção SSH Keys
4. Na tela principal, clique no botão Add new key
5. Na caixa maior, denominada Key, pressione CTRL + V para colar o conteúdo da chave copiada com um dos comandos anteriores
6. No campo Title defina um título que descreva o uso da chave
7. No campo Expiration date, remova a data de expiração definida
8. Clique no botão Add Key e garanta que a chave vai aparecer na listagem abaixo

Pronto!

Sua chave está configurada e pronta para uso! Fique atento aos comandos que você for rodar na loja, que eles podem pedir a Autenticação do GitLab. Para isso, você precisa usar a senha definida neste passo a passo.

Testando se a chave SSH está válida

No seu terminal, execute o comando: ssh -T git@gitlab.com. Você vai autenticar com a chave SSH criada e receberá a mensagem “Welcome to Gitlab” seguido do seu usuário. Isso significa que sua chave está reconhecida e válida.

Qualquer mensagem diferente disso significa que sua chave não está reconhecida e você precisa refazer os passos de criação acima.