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 | +================================================================================ | ... | ... |