Skip to content

Início / Tutoriais / VS Code e Git

Instalar VS Code

Abaixo estão os passos necessários para colocar em funcionamento o novo Ambiente de Desenvolvimento Docker + VS Code.

O coordenador irá facultar 3 portas que serão utilizadas para:

  • HTTPS: 10XX0
  • HTTP: 10XX1
  • SSH: 10XX2

Os XX serão individuais e no passo 3.2 terão de ser alterados no ficheiro de configuração.

1 - Gerar Chave SSH

1.1 - Abra a Windows PowerShell e execute o seguinte comando alterando para o respectivo email:

ssh-keygen -t ed25519 -C "o_seu_email@optigest.net"

1.2 - De seguinda será pedido para gerar a password que irá ser utilizada para aceder ao VS Code:

 1.2.1 - Carregar em Enter;

 1.2.2 - Introduzir uma password e carregar em Enter;

 1.2.3 - Repetir a password e carregar novamente em Enter;

1.3 - Os ficheiros foram gravados na pasta %USERPROFILE%/.ssh . Deve ser feita uma cópia de segurança (por ex: OneDrive) dos dois ficheiros gerados;

1.4 - A chave pública (.pub) deverá ser partilhada com o coordenador responsável para que este possa adicionar as permissões necessárias no servidor.

2 - Gerar Token GitLab

2.1 - Aceder aos Tokens de Acesso do GitLab e criar um novo Token com todas as permissões e sem data de validade (É possível retirar a data no X ao lado da mesma);

2.2 - Guardar o Token gerado ("Personal Access Token") para os passos seguintes. Nota: Não é possível ver o Token depois de gerado pelo que devem guarda-lo à parte.

3 - VS Code

3.1 - Efetuar o download do VS Code e instalar.

3.2 - Utilizando o Explorador do Windows, abrir a pasta %USERPROFILE%/.ssh e criar o ficheiro config sem extensão com o seguinte texto, alterando a Port para a vossa porta SSH:

Host dsv.optigest.net
    HostName dsv.optigest.net
    Port 10XX2
    User root
    IdentityFile ~/.ssh/id_ed25519

3.3 - Abrir o VS Code e clicar no botão azul em baixo do lado esquerdo para iniciar a ligação ao servidor remoto;

3.4 - Escolher a opção Connect to Host... e em seguida dsv.optigest.net , seguindo a sequência: Linux, Continue. Caso tenha sido criada uma password para a Chave SSH do ponto 1 a mesma será solicitada no ultimo passo;

3.5 - Após o VS Code recarregar e introduzir a password da Chave SSH, carregar em Ctrl + Shift + X para abrir as extensões;

 3.5.1 - Instalar as extensões: - GitLab Workflow - html-entities

3.6 - Carregar em Ctrl + Shift + P para abrir os comandos do VS Code, escrever GitLab e escolher a opção >GitLab: Add Account to VS Code;

 3.6.1 - Introduzir o URL https://gitlab.optigest.net e de seguida introduzir o Token de Acesso gerado anteriormente.

4 - Configurar Optitravel

4.1 - Escolher a opção Clone Git Repository… que aparece no centro do ecrã ou caso não apareça carregar em Ctrl + Shift + G e terão a opção do menu lateral esquerdo;

 4.1.1 - Escolher a opção Clone from GitLab;

 4.1.2 - Escolher optigest/optitravel;

 4.1.3 - Escolher https://gitlab.optigest.net/optigest/optitravel.git

 4.1.4 - Escolher a pasta /var/www/html/ e carregar em OK

 4.1.5 - Assim que terminar o Clone, carregar na opção Open

4.2 - Carregar em Ctrl + Shift + ç para abrir um terminal e introduzir os seguintes comandos individualmente:

git config --global user.email "o_seu_email@optigest.net"
git config --global user.name "PrimeiroNome UltimoNome"
git config --global credential.helper store
git config pull.rebase false

4.3 - Para terminar iremos alterar algumas definições do VS Code. Ir a File -> Preferences -> Settings , mudar para o separador Remote [SSH: dsv.optigest.net] e na barra de pesquisa colocar o seguinte:

 4.3.1 - git.autofetch e alterar para all

 4.3.2 - git.fetchOnPull e colocar o visto

 4.3.3 - files.autoGuessEncoding e retirar o visto caso tenha

 4.3.4 - files.encoding e escolher a opção Western (ISO 8859-1)

 4.3.5 - files.eol e alterar para \n

 4.3.6 - editor.tabSize e alterar para 4

Neste ponto, o sistema deverá estar pronto a funcionar :)

↑ (Última atualização: 06/01/2026)