gitea-servidor/PRIMEIRO_REPOSITORIO.md

🎯 Como Criar e Usar seu Primeiro Repositório

📦 Passo 1: Criar Repositório no Gitea

1. Acesse: https://meurepositorio.com
2. Faça login com sua conta de administrador
3. Clique no "+" (canto superior direito)
4. Selecione "Novo Repositório"
5. Preencha:
   • Nome: scripts-servidor (ou qualquer nome)
   • Descrição: Scripts e configurações do servidor
   • Visibilidade: Privado (recomendado)
   • Initialize Repository: ✓ Marque "Initialize repository"
   • Add .gitignore: Nenhum (ou escolha se quiser)
   • Add License: Nenhum (ou escolha se quiser)
6. Clique em "Criar Repositório"

---

🔗 Passo 2: Clonar no Cursor (HTTPS)

No seu computador (onde está o Cursor):

1. Abra o Cursor
2. Pressione Ctrl+Shift+P (Windows/Linux) ou Cmd+Shift+P (Mac)
3. Digite: Git: Clone
4. Cole a URL: https://meurepositorio.com/seuusuario/scripts-servidor.git (substitua seuusuario pelo seu username do Gitea)
5. Escolha uma pasta no seu computador
6. Digite seu usuário e senha do Gitea quando solicitado
7. Clique em "Open" quando perguntar se quer abrir o repositório

Pronto! Você está conectado! 🎉

---

📝 Passo 3: Fazer seu Primeiro Commit

No Cursor:

1. Crie um arquivo: README.md
2. Escreva algo, por exemplo:

   # Scripts do Servidor
   
   Configurações e scripts do meu servidor
   

3. Salve o arquivo (Ctrl+S)
4. Abra o painel Git: Ctrl+Shift+G
5. Você verá o arquivo README.md em "Changes"
6. Clique no + ao lado do arquivo (stage)
7. Digite uma mensagem: "Primeiro commit"
8. Clique no ✓ (commit)
9. Clique nos ... → Push

Sucesso! Seu código está no Gitea! 🚀

---

💾 Salvar Credenciais (Não Pedir Senha Toda Vez)

No terminal do seu computador (onde está o Cursor):

# Windows
git config --global credential.helper wincred

# Mac
git config --global credential.helper osxkeychain

# Linux
git config --global credential.helper store

Na próxima vez que fizer push/pull, digite usuário e senha UMA VEZ. Depois disso, ficará salvo automaticamente!

---

📚 Repositórios Sugeridos para Organizar

1. scripts-servidor

• Scripts de gerenciamento
• Configurações
• Backups
• Tudo que fizemos hoje!

2. projetos-web

• Sites e aplicações web
• Frontend e backend

3. estudos

• Códigos de estudo
• Tutoriais
• Experimentos

4. automacao

• Scripts de automação
• Cron jobs
• Monitores

---

🔄 Workflow Diário

# 1. Abrir projeto no Cursor
code /caminho/do/projeto

# 2. Fazer mudanças nos arquivos
# (edite normalmente)

# 3. Ver mudanças
Ctrl+Shift+G

# 4. Stage arquivos
Clique no + ao lado dos arquivos

# 5. Commit
Digite mensagem e clique no ✓

# 6. Push para Gitea
Clique em ... → Push

---

🎯 Vantagens do Seu Gitea

✅ Privado: Ninguém vê seus códigos
✅ Ilimitado: Repos e tamanho sem limites
✅ Rápido: Na sua rede local
✅ Seu: Você controla tudo
✅ Grátis: Sem mensalidades

---

🆘 Problemas Comuns

❌ "Authentication failed"

Solução: Verifique usuário e senha. No Gitea, vá em Settings → Applications → Generate New Token (e use o token no lugar da senha)

❌ "Could not resolve host"

Solução: Adicione no arquivo hosts do seu computador:

# Windows: C:\Windows\System32\drivers\etc\hosts
# Linux/Mac: /etc/hosts

187.102.179.100 meurepositorio.com

❌ "SSL certificate problem"

Solução: O certificado é válido, mas se der problema:

git config --global http.sslVerify true

---

Seu Gitea está pronto para usar! Comece criando seu primeiro repositório! 🚀