Files
gitea-servidor/PRIMEIRO_REPOSITORIO.md

162 lines
3.7 KiB
Markdown

# 🎯 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:
```markdown
# 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):
```bash
# 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
```bash
# 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:
```bash
git config --global http.sslVerify true
```
---
**Seu Gitea está pronto para usar! Comece criando seu primeiro repositório!** 🚀