Flujo git y despliegue manual

Rama principal de desarrollo

No se trabaja en main. La rama de desarrollo es serconsa-react.

git checkout serconsa-react
# trabajar...
git add .
git commit -m "tipo(scope): descripcion"
git push origin serconsa-react

Deploy a desarrollo (local)

serconsa.ovlicuo.com es esta misma máquina. No hay CI/CD para serconsa-react.

Backend

El contenedor monta ./backend/app con --reload, así que los cambios se recargan solos.

Para aplicar migraciones nuevas:

docker exec -w /app serconsa-backend sh -c "PYTHONPATH=/app alembic upgrade head"

Frontend

Reconstruir y levantar:

docker compose build frontend
docker compose up -d frontend

Merge a producción

Tras validar en desarrollo:

git checkout main
git merge --ff-only serconsa-react
git push origin main

El push a main dispara el pipeline de GitLab CI/CD que despliega en serconsa.dlmapp.net (servidor 146.59.171.101).

Volver siempre a serconsa-react:

git checkout serconsa-react

Cherry-pick

Si una feature necesita aplicarse selectivamente:

git checkout serconsa-react
git cherry-pick <commit-de-main>

Resuelve conflictos, commitea y pushea.

CI/CD

Configurado en .gitlab-ci.yml:

stages:
  - lint
  - build-backend
  - build-frontend
  - deploy

Jobs:

• backend-lint: ruff check app.
• frontend-lint: npm run lint || true.
• build-backend: construye imagen Docker y la publica en el registry.
• build-frontend: construye imagen Docker y la publica en el registry.
• deploy: copia docker-compose.prod.yml al servidor vía SSH y ejecuta docker compose up -d.

Solo se ejecuta en pushes a main.

Entornos

Entorno	URL	Servidor	Cómo se despliega
Desarrollo	https://serconsa.ovlicuo.com	Local	Manual (docker compose)
Producción	https://serconsa.dlmapp.net	146.59.171.101	GitLab CI/CD

serconsa.ovlicuo.com es desarrollo, nunca producción.

Resumen del flujo

serconsa-react → validar en dev (local) → merge --ff-only a main → CI/CD → prod