Workshop introdutório de git/GitHub.
Para o workshop são necessárias as seguintes ferramentas:
- Terminal/Shell: Para quem tem um sistema operativo macOS ou Linux esta vem integrada (ir para secção git); para quem possui Windows ver a secção WSL (Windows Subsystem for Linux).
- git:: https://git-scm.com/download
- ou opcionalmente
- GitHub Desktop: https://desktop.github.com/
- Text Editor / IDE (Recommended - Visual Studio Code): Iremos usar o VSCode como editor de código neste workshop (Site de instalação).
- (Opcional) Windows Terminal: Apenas opcional, mas para quem quiser esta versão do terminal do Windows 10/11 integra quaisquer terminais que tenham no computador (CMD, PowerShell, Ubuntu, etc.) com um visual mais compacto e moderno (Site de instalação).
Para instalar o git na vossa máquina vão ter de correr os seguintes comandos (ou instalar o executavel do git no caso do windows) dependendo do vosso sistema operativo:
-
Windows:
- Descarrega e corre o executável do git (https://git-scm.com/download/win)
-
Windows WSL/Linux:
- Abre o terminal e corre o seguinte comando:
sudo apt-get install git -y
-
macOS:
- Abre o terminal e corre o seguinte comando (Homebrew):
brew install git
Depois de estar instalado verifiquem a instalação correndo o seguinte comando no terminal, que deverá devolver a vossa versão do git (em WSL/Linux/MacOS):
git --version
No teu terminal, corre os seguintes comandos registares a tua identificação no Git:
git config --global user.name "username"
git config --global user.email "[email protected]"
# Guarda as credenciais para não ser necessário colocar a cada ação no git (opcional)
git config --global credential.helper store
Substitui os valores dentro das aspas (sem as removeres) com o teu username e email do GitHub.
- Guia de Instalação para Windows 10/11
O Subsistema Windows para Linux (WSL) permite que developers corram um ambiente GNU/Linux - incluindo a maioria das ferramentas da linha de comandos, utilitários e aplicações - diretamente no Windows, sem modificações, sem a sobrecarga de uma máquina virtual tradicional ou sem uma configuração de dual-boot.
Iremos instalar a versão 2 do WSL, sendo esta a mais recente e a que melhor simula um ambiente GNU/Linux sem problemas de desempenho e compatibilidade.
Primeiro deves ativar o recurso opcional Subsistema Windows para Linux antes de instalar alguma distribuição Linux no Windows.
Abre PowerShell como Administrador e corre o seguinte comando:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
Antes de instalarem o WSL 2, precisam de ativar o recurso opcional Plataforma de Máquina Virtual.
Abre PowerShell como Administrador e corre o seguinte comando:
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
Reinicia a tua máquina para concluir a instalação do WSL e procede para o próximo passo para atualizares para o WSL 2.
-
Descarrega o pacote mais recente:
-
Instala o pacote de atualização descarregado na etapa anterior. (Clica duas vezes para correr- se forem solicitadas permissões elevadas (de Administrador), clica 'sim' para aprovar esta instalação).
Assim que a instalação estiver concluída, passa para o próximo passo - definir WSL 2 como a versão padrão ao instalar novas distribuições Linux.
Abre PowerShell como Administrador e corre o seguinte comando para definir o WSL 2 como a versão padrão ao instalar novas distribuições Linux:
wsl --set-default-version 2
Vamos usar o Ubuntu por ser a distribuição mais amigável na ótica do utilizador, mas também porque é a mais completa e versátil para qualquer ambiente de desenvolvimento.
- Abre a Microsoft Store e seleciona a distribuição linux Ubuntu.
- Na página da distribuição Ubuntu, clica em "Obter".
Na primeira vez que iniciares o Ubuntu, uma consola será aberta e serás solicitado a aguardar um ou dois minutos para que os arquivos sejam descompactados e armazenados no teu PC. Lançamentos futuros devem levar menos de um segundo.
Vais precisar de criar um utilizador e uma palavra-passe para o Ubuntu;
Por fim corre os seguintes comandos no terminal Ubuntu para poderes ter acesso a todas as ferramentas e aplicações atualizadas:
sudo apt-get update
sudo apt-get upgrade -y
(Em principio se tiverem pacotes para atualizar, no vosso terminal o resultado dos comandos vai ser diferente)
PARABÉNS! Instalaste e configuraste com sucesso o Ubuntu no Windows 10!
Esta secção foi baseada no guia oficial da Microsoft presente neste site.
- Introduction to Git <-- RECOMMENDED
- Git Tutorial for Beginners
- Github Docs
- GitHub's Git Cheat Sheet
- Git Katas (Git learning with exercises) <-- RECOMMENDED
- Git Basics with Professor António Rito Silva @IST
- GitHub's Training Website
- Git Tutorial for Beginners
- GitHub Tutorial 2020 - Beginner's Training Guide
Quaisquer dúvidas adicionais recorram aos canais de discord atribuídos para esse fim.