Saltar al contenido principal

Gitea

Gitea es un servidor Git ligero y auto-hospedado. Es una alternativa más liviana a GitLab, ideal para equipos pequeños o proyectos personales.

Primeros Pasos​

1. Acceder a Gitea​

Después de que tu deployment esté listo:

  1. Visita tu URL: https://tu-subdominio.deployalo.com
  2. Verás la pantalla de configuración inicial

2. Configuración Inicial​

La primera vez que accedas, Gitea te mostrará un asistente de configuración:

  1. Database Settings: Ya está preconfigurado (PostgreSQL)

  2. General Settings: Revisa el Site Title

  3. Admin Account: Crea tu cuenta de administrador

    • Username: elige uno (ej: admin)
    • Password: elige una contraseña segura
    • Email: tu email

  4. Click "Install Gitea"

3. Primer Login​

Después de la instalación, inicia sesión con las credenciales que creaste.

Configuración​

Crear tu Primer Repositorio​

  1. Click en "+" → "New Repository"
  2. Ingresa nombre y descripción
  3. Elige visibilidad (Public o Private)
  4. Click "Create Repository"

Configurar SSH​

  1. Ve a Settings → SSH / GPG Keys
  2. Click "Add Key"
  3. Pega tu clave pública SSH
  4. Click "Add Key"

Para clonar repositorios:

git clone ssh://git@tu-subdominio.deployalo.com:2222/usuario/proyecto.git

Crear una Organización​

  1. Click en "+" → "New Organization"
  2. Ingresa nombre de la organización
  3. Configura visibilidad y permisos
  4. Invita miembros

Características​

  • Repositorios Git ilimitados
  • Pull Requests con code review
  • Issues y milestones
  • Wiki por repositorio
  • Actions (CI/CD similar a GitHub Actions)
  • Packages (registry para npm, Docker, etc.)

Gitea Actions (CI/CD)​

Gitea soporta workflows compatibles con GitHub Actions:

  1. Crea .gitea/workflows/ci.yml:
name: CI
on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Run tests
        run: echo "Running tests..."

Migrar desde GitHub/GitLab​

  1. Ve a "+" → "New Migration"
  2. Selecciona la plataforma origen
  3. Ingresa la URL del repositorio
  4. Gitea importará código, issues, PRs, etc.

Recursos​