Workshop Git

Workshop introdutório de git/GitHub.

Apresentação

LIVE WEBSITE

Guia de Instalação

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

git

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

Configurar Email e Username

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 "oteu@email.com"

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

WSL (Windows Subsystem for Linux)

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

Passo 1 - Ativar o 'Windows Subsystem for Linux'

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

Passo 2 - Ativar o recurso de Máquina Virtual

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.

Passo 3 - Descarregar o pacote de atualização do kernel Linux

1. Descarrega o pacote mais recente:

   • WSL2 Linux kernel update package for x64 machines.

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

Passo 4 - Definir WSL 2 como a versão padrão

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

Passo 5 - Instalar a distribuição Linux - Ubuntu

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.

1. Abre a Microsoft Store e seleciona a distribuição linux Ubuntu.

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

Links Úteis:

• 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

FIM

Quaisquer dúvidas adicionais recorram aos canais de discord atribuídos para esse fim.