331 lines
7.0 KiB
Markdown
331 lines
7.0 KiB
Markdown
# 🎯 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!** 🚀
|
|
|
|
|