sergio.correa/gitea-servidor
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
17c2f8e219205186d6bab49855c4fd3acfae5666
gitea-servidor/GUIA_CURSOR.md

7.0 KiB
Raw Blame History

🎯 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:

# 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

# 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:

# 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:

# 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

# 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:

# 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):

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

# 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 View Git Blame Copy Permalink