Guilherme at 13:16, 2 July 2026

2026-07-02T13:16:30Z

Guilherme: 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..."

2026-05-20T13:26:14Z

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>

← Edição anterior		Edição das 13h16min de 2 de julho de 2026
Linha 112:		Linha 112:
	'''Trabalhar no Computador:''' <code>git add .</code> -> <code>git commit -m "mensagem"</code> -> <code>git push</code>		'''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>		'''Atualizar o Servidor:''' <code>git pull origin main</code>
		+
		+	= Implantando o Sistema no Servidor do Zero =
		+
		+	Se você formatou seu servidor, contratou uma hospedagem nova, ou simplesmente quer instalar o seu sistema em um servidor onde ele ainda não existe, você precisará "clonar" o código do GitHub.
		+
		+	Como o GitHub agora é a fonte oficial (a nuvem) do seu projeto, o processo é bem simples, mas exige um cuidado especial com os arquivos que ignoramos anteriormente.
		+
		+	== Passo 1: Acessar a pasta destino no Servidor ==
		+	Primeiro, você precisa acessar o terminal do seu servidor e navegar até a pasta pública onde o seu site ou sistema deve ficar rodando.
		+
		+	Geralmente, em servidores Linux (Apache/Nginx), essa pasta fica em lugares como <code>/var/www/html</code>.
		+
		+	Digite no terminal do servidor:
		+	<pre>
		+	cd /caminho/para/a/pasta/do/seu/servidor
		+	</pre>
		+	== Passo 2: Clonar o Repositório ==
		+	Agora vamos baixar o código do GitHub para essa pasta.
		+	'''Importante:''' Se você simplesmente usar o comando de clonar, o Git criará uma subpasta com o nome do seu repositório (ex: <code>/var/www/html/meu-sistema</code>). Se você quiser que os arquivos fiquem '''diretamente''' na pasta atual, você deve colocar um '''ponto (.)''' no final do comando.
		+	Certifique-se de que a pasta atual está totalmente vazia e digite:
		+	<pre>
		+	git clone https://github.com/SEU_USUARIO/NOME_DO_REPOSITORIO.git .
		+	</pre>
		+	''(Não esqueça o espaço e o ponto no final se quiser instalar os arquivos soltos na pasta atual!)''
		+	=== E se o Repositório for Privado? ===
		+	Se o seu repositório for '''Privado''', o servidor não terá permissão para baixar os arquivos imediatamente. Ele pedirá seu "Username" (nome de usuário) e um "Password" (senha).
		+	Lembre-se: o GitHub não aceita mais a senha do site no terminal. Você precisará gerar um '''Personal Access Token (PAT)''':
		+	Vá no GitHub > Settings (Configurações) > Developer settings > Personal access tokens > Tokens (classic).
		+	Clique em "Generate new token".
		+	Dê um nome (ex: "Acesso Servidor"), defina a validade e marque a caixinha '''repo'''.
		+	Copie o código gerado.
		+	No terminal do servidor, cole esse código quando ele pedir o "Password".
		+	== Passo 3: Recriando o arquivo de Senhas (O Mais Importante!) ==
		+	Se você seguiu as boas práticas e utilizou o <code>.gitignore</code> para esconder as senhas do banco de dados (arquivos como <code>config.php</code> ou <code>.env</code>), você vai notar que '''o sistema dará erro ao tentar acessar o banco de dados'''.
		+	Isso é excelente! Significa que suas senhas estão seguras e não vieram do GitHub. Porém, para o sistema funcionar no servidor, você precisará recriar esse arquivo manualmente:
		+	No terminal do servidor, crie o arquivo que foi ignorado:
		+	<pre>
		+	nano config.php
		+	</pre>
		+	(Substitua <code>config.php</code> pelo nome do seu arquivo de configuração).
		+	Escreva ou cole o código com os dados de conexão do banco de dados do seu servidor (Usuário, Senha, Nome do Banco, etc).
		+	Salve e feche o arquivo.
		+	Pronto! Agora o seu servidor tem o código atualizado do GitHub e o arquivo de configuração seguro que só existe localmente.
		+	== Passo 4: Atualizações Futuras ==
		+	A partir de agora, o repositório já existe no servidor.
		+	Sempre que você trabalhar no seu computador pelo VSCode e enviar alterações para o GitHub (usando <code>git push</code>), basta acessar o servidor novamente, ir até a pasta do projeto e digitar:
		+	<pre>
		+	git pull origin main
		+	</pre>
		+	O servidor vai baixar apenas os arquivos novos do GitHub sem tocar no seu arquivo <code>config.php</code> protegido.
		+	</pre>

Git - Revision history

Guilherme at 13:16, 2 July 2026

Guilherme: 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..."