🚀 Instalação completa do Gitea com todos os scripts e documentação
This commit is contained in:
Admin
330
GUIA_CURSOR.md
Normal file
330
GUIA_CURSOR.md
Normal file
@@ -0,0 +1,330 @@
|
||||
# 🎯 Como Usar seu Gitea com o Cursor
|
||||
|
||||
Seu repositório Gitea funciona **exatamente como GitHub** com o Cursor!
|
||||
|
||||
---
|
||||
|
||||
## 📋 Pré-requisitos
|
||||
|
||||
1. ✅ Gitea configurado (você já tem!)
|
||||
2. ✅ Conta de usuário criada no Gitea
|
||||
3. ✅ Cursor instalado no seu computador
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Método 1: Clone via HTTPS (Mais Fácil)
|
||||
|
||||
### Passo 1: Criar repositório no Gitea
|
||||
|
||||
1. Acesse: `https://meurepositorio.com`
|
||||
2. Faça login
|
||||
3. Clique no **"+"** (canto superior direito)
|
||||
4. Selecione **"New Repository"**
|
||||
5. Preencha:
|
||||
- Nome: `meu-projeto`
|
||||
- Descrição: (opcional)
|
||||
- Privado ou Público
|
||||
6. Clique em **"Create Repository"**
|
||||
|
||||
### Passo 2: Clonar no Cursor
|
||||
|
||||
**No Cursor:**
|
||||
|
||||
1. Pressione `Ctrl+Shift+P` (ou `Cmd+Shift+P` no Mac)
|
||||
2. Digite: `Git: Clone`
|
||||
3. Cole a URL: `https://meurepositorio.com/seuusuario/meu-projeto.git`
|
||||
4. Escolha a pasta onde clonar
|
||||
5. Digite seu **usuário** e **senha** do Gitea
|
||||
|
||||
Pronto! Seu repositório está clonado e pronto para usar no Cursor! 🎉
|
||||
|
||||
### Comandos Git no Cursor
|
||||
|
||||
Depois de clonar, você pode usar Git normalmente:
|
||||
|
||||
- **Commit**: `Ctrl+Shift+G` → Digite mensagem → Clique no ✓
|
||||
- **Push**: Clique nos `...` → `Push`
|
||||
- **Pull**: Clique nos `...` → `Pull`
|
||||
- **Criar Branch**: Canto inferior esquerdo → Clique no nome da branch
|
||||
|
||||
---
|
||||
|
||||
## 🔐 Método 2: Clone via SSH (Recomendado para Uso Frequente)
|
||||
|
||||
Mais seguro e não precisa digitar senha toda vez!
|
||||
|
||||
### Passo 1: Gerar chave SSH (se ainda não tem)
|
||||
|
||||
**No seu computador:**
|
||||
|
||||
```bash
|
||||
# Linux/Mac/Windows (Git Bash)
|
||||
ssh-keygen -t ed25519 -C "seu-email@example.com"
|
||||
|
||||
# Pressione Enter para aceitar o local padrão
|
||||
# Pressione Enter para senha vazia (ou defina uma)
|
||||
```
|
||||
|
||||
### Passo 2: Copiar a chave pública
|
||||
|
||||
```bash
|
||||
# Linux/Mac
|
||||
cat ~/.ssh/id_ed25519.pub
|
||||
|
||||
# Windows (PowerShell)
|
||||
type $env:USERPROFILE\.ssh\id_ed25519.pub
|
||||
|
||||
# Windows (Git Bash)
|
||||
cat ~/.ssh/id_ed25519.pub
|
||||
```
|
||||
|
||||
Copie todo o conteúdo (começa com `ssh-ed25519 ...`)
|
||||
|
||||
### Passo 3: Adicionar no Gitea
|
||||
|
||||
1. Acesse: `https://meurepositorio.com`
|
||||
2. Faça login
|
||||
3. Clique no **avatar** (canto superior direito) → **Settings**
|
||||
4. No menu lateral: **SSH / GPG Keys**
|
||||
5. Clique em **Add Key**
|
||||
6. Cole a chave pública
|
||||
7. Dê um nome (ex: "Meu Computador")
|
||||
8. Clique em **Add Key**
|
||||
|
||||
### Passo 4: Clonar via SSH
|
||||
|
||||
**No Cursor:**
|
||||
|
||||
1. Pressione `Ctrl+Shift+P` (ou `Cmd+Shift+P`)
|
||||
2. Digite: `Git: Clone`
|
||||
3. Cole a URL SSH: `ssh://git@meurepositorio.com:222/seuusuario/meu-projeto.git`
|
||||
|
||||
⚠️ **Importante**: Note a porta **222** (não é 22!)
|
||||
|
||||
4. Escolha a pasta
|
||||
5. Não vai pedir senha! 🎉
|
||||
|
||||
---
|
||||
|
||||
## 📦 Método 3: Publicar Projeto Existente do Cursor
|
||||
|
||||
Você já tem um projeto no Cursor e quer colocar no Gitea?
|
||||
|
||||
### Passo 1: Criar repositório vazio no Gitea
|
||||
|
||||
1. Acesse o Gitea
|
||||
2. Crie um novo repositório
|
||||
3. **Importante**: NÃO marque "Initialize repository"
|
||||
4. Copie a URL que aparecer
|
||||
|
||||
### Passo 2: No Cursor
|
||||
|
||||
Abra o terminal integrado (`Ctrl+``) e execute:
|
||||
|
||||
```bash
|
||||
# Inicializar Git (se ainda não tem)
|
||||
git init
|
||||
|
||||
# Adicionar seus arquivos
|
||||
git add .
|
||||
|
||||
# Primeiro commit
|
||||
git commit -m "Primeiro commit"
|
||||
|
||||
# Adicionar o remote do Gitea
|
||||
git remote add origin https://meurepositorio.com/seuusuario/meu-projeto.git
|
||||
|
||||
# OU via SSH:
|
||||
git remote add origin ssh://git@meurepositorio.com:222/seuusuario/meu-projeto.git
|
||||
|
||||
# Push para o Gitea
|
||||
git push -u origin master
|
||||
```
|
||||
|
||||
Digite usuário e senha quando solicitado (se HTTPS).
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Workflow Diário no Cursor
|
||||
|
||||
### Fazer mudanças e enviar:
|
||||
|
||||
1. **Edite arquivos** normalmente no Cursor
|
||||
2. **Ver mudanças**: `Ctrl+Shift+G`
|
||||
3. **Stage arquivos**: Clique no `+` ao lado dos arquivos
|
||||
4. **Commit**: Digite mensagem e clique no ✓
|
||||
5. **Push**: Clique nos `...` → `Push`
|
||||
|
||||
### Baixar mudanças do servidor:
|
||||
|
||||
1. Clique nos `...` → `Pull`
|
||||
|
||||
### Criar branch:
|
||||
|
||||
1. Canto inferior esquerdo → Nome da branch
|
||||
2. `+ Create new branch...`
|
||||
3. Digite o nome
|
||||
4. Push: `...` → `Publish Branch`
|
||||
|
||||
---
|
||||
|
||||
## ⚙️ Configurações Úteis no Cursor
|
||||
|
||||
### Salvar credenciais (HTTPS)
|
||||
|
||||
Para não digitar senha toda vez:
|
||||
|
||||
```bash
|
||||
# Linux/Mac
|
||||
git config --global credential.helper store
|
||||
|
||||
# Windows
|
||||
git config --global credential.helper wincred
|
||||
```
|
||||
|
||||
Na primeira vez que fizer push/pull, digite usuário e senha.
|
||||
Depois disso, ficará salvo!
|
||||
|
||||
### Configurar Git
|
||||
|
||||
```bash
|
||||
# Seu nome
|
||||
git config --global user.name "Seu Nome"
|
||||
|
||||
# Seu email
|
||||
git config --global user.email "seu-email@example.com"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎨 Extensões Úteis do Cursor para Git
|
||||
|
||||
O Cursor já vem com Git integrado, mas você pode instalar:
|
||||
|
||||
- **GitLens**: Visualização avançada de histórico
|
||||
- **Git Graph**: Ver árvore de commits visual
|
||||
- **Git History**: Ver histórico de arquivos
|
||||
|
||||
---
|
||||
|
||||
## 🔍 Troubleshooting
|
||||
|
||||
### ❌ "Could not resolve host"
|
||||
|
||||
**Problema**: DNS não resolve `meurepositorio.com`
|
||||
|
||||
**Solução**: Aguarde propagação DNS ou adicione no arquivo hosts:
|
||||
|
||||
```bash
|
||||
# Linux/Mac: /etc/hosts
|
||||
# Windows: C:\Windows\System32\drivers\etc\hosts
|
||||
|
||||
187.102.179.100 meurepositorio.com
|
||||
```
|
||||
|
||||
### ❌ "SSL certificate problem"
|
||||
|
||||
**Problema**: Certificado SSL não confiável
|
||||
|
||||
**Solução temporária** (apenas para teste):
|
||||
```bash
|
||||
git config --global http.sslVerify false
|
||||
```
|
||||
|
||||
**Solução correta**: Aguarde certificado SSL ser reconhecido ou importe o certificado.
|
||||
|
||||
### ❌ "Connection timeout" (SSH)
|
||||
|
||||
**Problema**: Porta SSH não acessível
|
||||
|
||||
**Lembre-se**: O Gitea usa porta **222**, não 22!
|
||||
|
||||
URL SSH correta:
|
||||
```
|
||||
ssh://git@meurepositorio.com:222/usuario/repo.git
|
||||
```
|
||||
|
||||
### ❌ "Permission denied (publickey)"
|
||||
|
||||
**Problema**: Chave SSH não configurada
|
||||
|
||||
**Solução**:
|
||||
1. Verifique se a chave está no Gitea (Settings → SSH Keys)
|
||||
2. Teste conexão: `ssh -p 222 git@meurepositorio.com`
|
||||
|
||||
---
|
||||
|
||||
## 📚 URLs do Seu Gitea
|
||||
|
||||
### Clone HTTPS:
|
||||
```
|
||||
https://meurepositorio.com/seuusuario/seurepositorio.git
|
||||
```
|
||||
|
||||
### Clone SSH:
|
||||
```
|
||||
ssh://git@meurepositorio.com:222/seuusuario/seurepositorio.git
|
||||
```
|
||||
|
||||
### Web:
|
||||
```
|
||||
https://meurepositorio.com
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Exemplo Completo: Criar e Usar Repositório
|
||||
|
||||
```bash
|
||||
# 1. Criar pasta do projeto
|
||||
mkdir meu-projeto
|
||||
cd meu-projeto
|
||||
|
||||
# 2. Inicializar Git
|
||||
git init
|
||||
|
||||
# 3. Criar arquivo
|
||||
echo "# Meu Projeto" > README.md
|
||||
|
||||
# 4. Primeiro commit
|
||||
git add .
|
||||
git commit -m "Initial commit"
|
||||
|
||||
# 5. Conectar com Gitea (criar repo vazio lá primeiro!)
|
||||
git remote add origin https://meurepositorio.com/seuusuario/meu-projeto.git
|
||||
|
||||
# 6. Push
|
||||
git push -u origin master
|
||||
|
||||
# 7. Abrir no Cursor
|
||||
code .
|
||||
```
|
||||
|
||||
Pronto! Agora você pode trabalhar normalmente no Cursor! 🚀
|
||||
|
||||
---
|
||||
|
||||
## 💡 Dicas Profissionais
|
||||
|
||||
1. **Use SSH**: Mais seguro e rápido
|
||||
2. **Commits frequentes**: Pequenos e descritivos
|
||||
3. **Branches**: Use branches para features
|
||||
4. **Pull antes de Push**: Evita conflitos
|
||||
5. **.gitignore**: Não commite arquivos desnecessários
|
||||
6. **Backup**: Seu Gitea é o backup, mas faça backup do servidor também!
|
||||
|
||||
---
|
||||
|
||||
## 🎉 Vantagens do Seu Gitea Privado
|
||||
|
||||
✅ **Privacidade total**: Seus códigos não saem do seu servidor
|
||||
✅ **Sem limites**: Repos ilimitados, tamanho ilimitado
|
||||
✅ **Controle total**: Você decide as regras
|
||||
✅ **Grátis**: Sem mensalidades
|
||||
✅ **Rápido**: Na sua rede local
|
||||
|
||||
---
|
||||
|
||||
**Seu repositório Git privado está pronto para ser usado com o Cursor!** 🚀
|
||||
|
||||
|
||||
Reference in New Issue
Block a user