Commit cf495e9ced803235c893596841a358edd76ed1f9
1 parent
a13b84d3
Documentación: Agregado de manual de procedimientos de respaldo y recuperación.
Showing
1 changed file
with
69 additions
and
0 deletions
Manual-Procedimiento-Respaldo-Completo-GIS-GEOSERVER.txt
0 → 100644
| 1 | +================================================================================ | ||
| 2 | +MANUAL DE PROCEDIMIENTO: RESPALDO Y RECUPERACIÓN COMPLETA - SIGEM-GIS-GEOSERVER | ||
| 3 | +================================================================================ | ||
| 4 | +Version 1.0 (Abril 2026) | ||
| 5 | +Responsable: Senior Fullstack Developer (IA Antigravity) | ||
| 6 | +Entorno: Servidor 192.168.1.123 | ||
| 7 | +Ubicacion: /yvyape/proyectos/sigem-gis/ | ||
| 8 | +================================================================================ | ||
| 9 | + | ||
| 10 | +1. POLÍTICA DE RESPALDO (HITOS) | ||
| 11 | +-------------------------------------------------------------------------------- | ||
| 12 | +Los respaldos se ejecutarán única y exclusivamente BAJO PEDIDO Y AUTORIZACIÓN | ||
| 13 | +del usuario al alcanzar un Hito de Despliegue Exitoso. Esto garantiza que | ||
| 14 | +todas las versiones guardadas sean estados de sistema válidos y estables. | ||
| 15 | + | ||
| 16 | +2. PROCEDIMIENTO DE RESPALDO (GENERACIÓN) | ||
| 17 | +-------------------------------------------------------------------------------- | ||
| 18 | +Cada respaldo consta de un tríptico de acciones atómicas: | ||
| 19 | + | ||
| 20 | +PASO 1: Identificación (Hito) | ||
| 21 | +Actualización del archivo VERSION.txt con: | ||
| 22 | +- Marca de tiempo completa (YYYY.MM.DD.HH.MM.SS) | ||
| 23 | +- ID del Contenedor Docker actualmente en ejecución (ID DOCKER). | ||
| 24 | +- Observación detallada del logro alcanzado. | ||
| 25 | + | ||
| 26 | +PASO 2: Sincronización de Código (Git) | ||
| 27 | +Ejecución de commit y push hacia el servidor Institucional 192.168.1.100: | ||
| 28 | +$ git add . | ||
| 29 | +$ git commit -m "Hito: [Descripcion]" | ||
| 30 | +$ git push origin main | ||
| 31 | + | ||
| 32 | +PASO 3: Snapshot de Infraestructura (Servidor .123) | ||
| 33 | +Creación de carpeta cronológica en /publico/ y generación de archivos binarios: | ||
| 34 | +$ mkdir -p /publico/backup-geoserver-YYYYMMDDHHMM | ||
| 35 | +$ docker exec proyecto-postgres-1 pg_dump -U sigem_user sigem > /publico/backup-geoserver-YYYYMMDDHHMM/sigem_postgres_dump.sql | ||
| 36 | +$ cd /yvyape/proyectos/sigem-gis && tar -czvf /publico/backup-geoserver-YYYYMMDDHHMM/geoserver-data_dir.tar.gz geoserver-data | ||
| 37 | + | ||
| 38 | +3. PROCEDIMIENTO DE RECUPERACIÓN TOTAL (DRP) | ||
| 39 | +-------------------------------------------------------------------------------- | ||
| 40 | +En caso de fallo catastrófico del servidor, siga estos pasos estrictamente: | ||
| 41 | + | ||
| 42 | +FASE A: Restauración del Entorno | ||
| 43 | +1. Clonar el repositorio desde el servidor central a la carpeta de trabajo: | ||
| 44 | + $ cd /yvyape/proyectos/ | ||
| 45 | + $ git clone http://192.168.1.100/geo/gis-geoserver.git sigem-gis | ||
| 46 | + | ||
| 47 | +2. Iniciar los contenedores base (Postgres y GeoServer): | ||
| 48 | + $ cd /yvyape/proyectos/sigem-gis | ||
| 49 | + $ docker compose up -d postgres geoserver | ||
| 50 | + | ||
| 51 | +FASE B: Restauración de Datos (PostGIS) | ||
| 52 | +Inyectar el volcado SQL al contenedor de base de datos recién creado: | ||
| 53 | +$ cat /publico/backup-geoserver-VERSION/sigem_postgres_dump.sql | docker exec -i proyecto-postgres-1 psql -U sigem_user -d sigem | ||
| 54 | + | ||
| 55 | +FASE C: Restauración de Capas y Estilos (GeoServer) | ||
| 56 | +Descomprimir las configuraciones de GeoServer en su volumen de datos: | ||
| 57 | +1. Detener geoserver: $ docker compose stop geoserver | ||
| 58 | +2. Borrar data antigua: $ rm -rf geoserver-data/* | ||
| 59 | +3. Extraer backup: $ tar -xzvf /publico/backup-geoserver-VERSION/geoserver-data_dir.tar.gz -C /yvyape/proyectos/sigem-gis/ | ||
| 60 | +4. Reiniciar: $ docker compose up -d geoserver | ||
| 61 | + | ||
| 62 | +FASE D: Despliegue del Binario Java | ||
| 63 | +Recompilar e iniciar el backend: | ||
| 64 | +$ ./mvnw clean package -DskipTests | ||
| 65 | +$ docker compose restart backend-java | ||
| 66 | + | ||
| 67 | +================================================================================ | ||
| 68 | +FIN DEL MANUAL | ||
| 69 | +================================================================================ |