Files
GITCUBO/COMPARACAO_GITEA_PROJETOS.md
Sergio Correa 6a483b26a0 📚 Documentação inicial do projeto GITCUBO
- Mapeamento completo de portas do servidor
- Comparação entre meurepositorio.com e gitcubo.com
- Resumo executivo com próximos passos
- Índice de documentação
- Guia de implementação completo

Status: Fase 1 (Preparação) concluída 
Próximo: Criar estrutura de diretórios e Docker Compose
2025-11-21 22:23:42 +00:00

4.0 KiB

🔄 Comparação: meurepositorio.com vs gitcubo.com

📊 Tabela Comparativa

Aspecto meurepositorio.com (Existente) gitcubo.com (Novo)
Domínio meurepositorio.com gitcubo.com
IP 187.102.179.100 187.102.179.100
Porta Web 3001 3002
Porta SSH 222 223
Localização /root/gitea/ /root/gitcubo/
PostgreSQL Porta 5432 (compartilhado) Porta 5433 (dedicado) ou 5432 (compartilhado)
Container Gitea gitea gitcubo
Container DB gitea_db_1 gitcubo_db (se dedicado)
Status DNS Configurado Configurado
Status SSL Ativo A configurar

🎯 Estratégia de Implementação

Opção 1: PostgreSQL Compartilhado (Recomendado)

Vantagens:

  • Menos recursos utilizados
  • Mais fácil de gerenciar
  • Backup centralizado

Configuração:

  • Criar novo database no PostgreSQL existente (porta 5432)
  • Novo usuário: gitcubo_user
  • Novo database: gitcubo_db

Opção 2: PostgreSQL Dedicado

Vantagens:

  • Isolamento completo
  • Configurações independentes
  • Sem risco de conflito

Configuração:

  • Novo container PostgreSQL na porta 5433
  • Usuário e database próprios

📁 Estrutura de Diretórios Proposta

/root/gitcubo/
├── docker-compose.yml          # Configuração Docker
├── data/
│   ├── gitea/                  # Dados do Gitea
│   │   ├── conf/
│   │   │   └── app.ini        # Configuração principal
│   │   ├── log/
│   │   ├── sessions/
│   │   └── ...
│   ├── git/                    # Repositórios Git
│   │   └── repositories/
│   └── ssh/                    # Chaves SSH
├── postgres/                   # Se usar PostgreSQL dedicado
├── scripts/
│   ├── backup.sh
│   ├── restore.sh
│   └── manage.sh
└── README.md

🔧 Diferenças Técnicas

Configuração Docker Compose

meurepositorio.com:

services:
  gitea:
    ports:
      - "3001:3001"
      - "222:22"

gitcubo.com:

services:
  gitcubo:
    ports:
      - "3002:3002"
      - "223:22"

Configuração Nginx

meurepositorio.com:

server_name meurepositorio.com www.meurepositorio.com;
proxy_pass http://localhost:3001;

gitcubo.com:

server_name gitcubo.com www.gitcubo.com;
proxy_pass http://localhost:3002;

🚀 Checklist de Implementação

Fase 1: Preparação

  • Verificar portas disponíveis
  • Confirmar DNS configurado
  • Decidir estratégia de banco de dados
  • Criar estrutura de diretórios

Fase 2: Instalação

  • Criar docker-compose.yml
  • Configurar PostgreSQL (novo ou existente)
  • Configurar Gitea
  • Testar acesso local (porta 3002)

Fase 3: Configuração Web

  • Configurar Nginx
  • Obter certificado SSL (Let's Encrypt)
  • Testar acesso HTTPS
  • Configurar SSH (porta 223)

Fase 4: Finalização

  • Criar primeiro usuário admin
  • Configurar backup automático
  • Documentar configurações
  • Testar operações Git (clone, push, pull)

📝 Notas Importantes

  1. Isolamento Total: Os dois projetos Gitea serão completamente independentes
  2. Sem Conflitos: Portas diferentes garantem que não haverá conflito
  3. Mesmo Servidor: Ambos rodam no mesmo servidor físico (187.102.179.100)
  4. Nginx Compartilhado: O mesmo Nginx fará proxy reverso para ambos
  5. SSL Independente: Cada domínio terá seu próprio certificado SSL

⚠️ Cuidados

  • Não confundir os diretórios dos dois projetos
  • Sempre verificar em qual Gitea está trabalhando
  • Fazer backup antes de qualquer alteração
  • Manter documentação atualizada
  • Monitorar uso de recursos (RAM, CPU, Disco)

🔐 Segurança

  • Usuários separados em cada Gitea
  • Bancos de dados isolados (mesmo se no mesmo PostgreSQL)
  • Chaves SSH diferentes
  • Logs independentes
  • Backups separados