GitLab e chave SSH

O GitLab é o repositório utilizado pela plataforma Vnda. 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 Vnda 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;

1. O Gitlab pode exigir que você crie chaves para 2FA também. Você pode fazer isso no celular, pelo aplicativo do Google Authenticator
2. Envie os e-mails das contas criadas para o time Vnda. O envio deve ser feito inicialmente pelo canal da agência parceira no Discord, ou então para o e-mail para [email protected] com o assunto "Acesso Gitlab".

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ês façam uso do terminal "Git Bash", ou do Powershell Core 7. A indicação e links de instalação estão na aba Aplicativos.

No seu terminal, execute o comando:

ssh-keygen -t ed25519 -C "Chave SSH Vnda"

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

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! .

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

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, com o comando apropriado dependendo do seu sistema operacional:

Windows (Git Bash ou Powershell Core 7):

cat ~/.ssh/id_ed25519.pub | clip

Linux

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

macOS

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 [email protected]. 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.