Git

Guilherme — Wed, 20 May 2026 13:26:14 GMT

Created page with "= Guia Completo: Utilizando Git e GitHub do Zero = Bem-vindo(a) ao guia de uso básico do Git e GitHub! Este tutorial foi escrito para quem nunca teve contato com a ferrament..."

Página nova

= Guia Completo: Utilizando Git e GitHub do Zero =

Bem-vindo(a) ao guia de uso básico do Git e GitHub! Este tutorial foi escrito para quem nunca teve contato com a ferramenta. O Git é um sistema de controle de versão (como uma máquina do tempo para o seu código), e o GitHub é um site onde você guarda esse código na nuvem.

Neste tutorial, vamos cobrir o ciclo completo: pegar um código que já existe no seu servidor, colocar no GitHub, baixar no seu computador para editar, salvar as alterações e atualizar o servidor novamente.

== Pré-requisitos ==
* Ter uma conta criada no [https://github.com GitHub].
* Ter o Git instalado no servidor e no seu computador.
* Saber abrir o Terminal (Linux/Mac) ou o Prompt de Comando/PowerShell (Windows).

---

== Passo Zero: Protegendo suas Senhas (O arquivo .gitignore) ==
'''MUITO IMPORTANTE:''' Antes de enviarmos seu código do servidor para o GitHub, precisamos garantir que arquivos com senhas de banco de dados não sejam enviados. Se você enviar uma senha para um repositório público, qualquer pessoa na internet poderá ver!

Para isso, usamos um arquivo chamado <code>.gitignore</code>. Ele diz ao Git: ''"Ignore estes arquivos, não os envie para a nuvem"''.

# Acesse a pasta do seu projeto no servidor através do terminal.
# Crie um arquivo chamado <code>.gitignore</code> (com o ponto no início).
# Dentro dele, escreva o nome do arquivo que contém as suas senhas.

Por exemplo, se as suas configurações de banco de dados estão em um arquivo chamado <code>config.php</code> ou <code>.env</code>, você criaria e editaria o arquivo assim:

<pre>
nano .gitignore
</pre>
Dentro do arquivo, adicione a linha com o nome do arquivo a ser ignorado:
<pre>
config.php
</pre>
Salve e feche o arquivo. O Git agora fingirá que o <code>config.php</code> não existe!
== Situação 1: Do Servidor para o GitHub ==
Você tem o sistema rodando no servidor e quer guardar esse código no GitHub.
=== 1. Crie um Repositório no GitHub ===
Entre no site do GitHub e clique no botão verde '''"New"''' (Novo repositório).
Dê um nome ao seu projeto (ex: <code>meu-sistema</code>).
Escolha a visibilidade:
#* '''Public (Público):''' Qualquer um na internet pode ver seu código.
#* '''Private (Privado):''' Apenas você e quem você convidar podem ver. (Recomendado para sistemas de empresas).
'''NÃO''' marque as opções "Add a README file" ou "Add .gitignore". Deixe o repositório totalmente vazio.
Clique em '''Create repository'''.
=== 2. Envie o código do Servidor ===
No terminal do seu servidor, navegue até a pasta onde estão os arquivos do seu sistema e digite os comandos abaixo, um por um:
Inicia o Git na pasta do servidor:
<pre>
git init
</pre>
Adiciona todos os arquivos (menos os que estão no .gitignore) para serem salvos:
<pre>
git add .
</pre>
Cria um "pacote" com esses arquivos e dá uma mensagem a ele (isso se chama ''commit''):
<pre>
git commit -m "Primeiro envio do sistema"
</pre>
Muda o nome da ramificação principal para "main" (padrão atual do GitHub):
<pre>
git branch -M main
</pre>
Conecta a sua pasta local ao repositório que você criou no GitHub (Substitua a URL abaixo pela URL do seu repositório no GitHub):
<pre>
git remote add origin https://github.com/SEU_USUARIO/NOME_DO_REPOSITORIO.git
</pre>
Envia (''push'') o código para o GitHub:
<pre>
git push -u origin main
</pre>
'''Atenção para Repositórios Privados:'''
Ao fazer o comando <code>git push</code>, o GitHub pedirá seu usuário e senha. Hoje em dia, a "senha" não é a senha do site, mas sim um '''Personal Access Token (PAT)'''.
Vá no GitHub > Settings (Configurações) > Developer settings > Personal access tokens > Tokens (classic).
Gere um novo token marcando a caixinha "repo", copie esse código gigante e cole no terminal quando pedir a senha.
== Situação 2: Do GitHub para o seu Computador Local ==
Agora que o código está seguro no GitHub, você quer baixá-lo no seu computador para trabalhar usando o VSCode (ou Google Antigravity/ambiente web).
Abra o seu terminal no computador local e navegue até a pasta onde deseja salvar o projeto.
Digite o comando de "clonar" (copiar):
<pre>
git clone https://github.com/SEU_USUARIO/NOME_DO_REPOSITORIO.git
</pre>
O Git criará uma pasta com o nome do seu projeto.
Abra o VSCode, clique em '''File > Open Folder''' e selecione essa nova pasta.
'''Nota:''' Se o repositório for '''Privado''', o VSCode ou o terminal abrirá uma janelinha do navegador pedindo para você autorizar o acesso à sua conta do GitHub. É só clicar em autorizar.
'''Importante:''' Como você ignorou o arquivo de senha (ex: <code>config.php</code>) na Situação 1, ele não virá para o seu computador. Você precisará criar um <code>config.php</code> localmente com as senhas do seu banco de dados de teste (local).
== Situação 3: Atualizando o repositório após alterações locais ==
Você trabalhou no seu computador, modificou arquivos, criou novas funcionalidades no VSCode e agora quer mandar essas novidades de volta para o GitHub.
No terminal do seu computador (pode usar o terminal integrado do próprio VSCode), digite:
Adiciona todas as modificações que você fez:
<pre>
git add .
</pre>
Salva essas alterações com uma mensagem descrevendo o que foi feito:
<pre>
git commit -m "Adicionada tela de login e corrigido bug de layout"
</pre>
Envia as alterações para o GitHub:
<pre>
git push
</pre>
Pronto! Se você entrar no site do GitHub agora, verá que seus arquivos foram atualizados.
== Situação 4: Atualizando o código no Servidor ==
O GitHub já tem o código novo, mas o seu servidor (Situação 1) ainda está rodando o código antigo. Vamos puxar as novidades do GitHub para o servidor.
Acesse o terminal do seu servidor.
Vá para a pasta do seu sistema.
Digite o comando de "puxar" (''pull''):
<pre>
git pull origin main
</pre>
O Git irá baixar apenas os arquivos que foram modificados e atualizar seu sistema automaticamente!
Como nós protegemos o arquivo de senhas com o <code>.gitignore</code> no passo zero, o comando <code>git pull</code> '''não''' vai apagar ou sobrescrever as senhas do banco de dados de produção do seu servidor.
=== Resumo do Ciclo de Trabalho Diário ===
Daqui em diante, seu fluxo de trabalho sempre será este:
'''Trabalhar no Computador:''' <code>git add .</code> -> <code>git commit -m "mensagem"</code> -> <code>git push</code>
'''Atualizar o Servidor:''' <code>git pull origin main</code>

wiki.franca.unesp.br - Recent changes [pt-BR]

Git