diff --git a/Manual-Procedimiento-Respaldo-Completo-GIS-GEOSERVER.txt b/Manual-Procedimiento-Respaldo-Completo-GIS-GEOSERVER.txt new file mode 100644 index 0000000..51fa910 --- /dev/null +++ b/Manual-Procedimiento-Respaldo-Completo-GIS-GEOSERVER.txt @@ -0,0 +1,69 @@ +================================================================================ +MANUAL DE PROCEDIMIENTO: RESPALDO Y RECUPERACIÓN COMPLETA - SIGEM-GIS-GEOSERVER +================================================================================ +Version 1.0 (Abril 2026) +Responsable: Senior Fullstack Developer (IA Antigravity) +Entorno: Servidor 192.168.1.123 +Ubicacion: /yvyape/proyectos/sigem-gis/ +================================================================================ + +1. POLÍTICA DE RESPALDO (HITOS) +-------------------------------------------------------------------------------- +Los respaldos se ejecutarán única y exclusivamente BAJO PEDIDO Y AUTORIZACIÓN +del usuario al alcanzar un Hito de Despliegue Exitoso. Esto garantiza que +todas las versiones guardadas sean estados de sistema válidos y estables. + +2. PROCEDIMIENTO DE RESPALDO (GENERACIÓN) +-------------------------------------------------------------------------------- +Cada respaldo consta de un tríptico de acciones atómicas: + +PASO 1: Identificación (Hito) +Actualización del archivo VERSION.txt con: +- Marca de tiempo completa (YYYY.MM.DD.HH.MM.SS) +- ID del Contenedor Docker actualmente en ejecución (ID DOCKER). +- Observación detallada del logro alcanzado. + +PASO 2: Sincronización de Código (Git) +Ejecución de commit y push hacia el servidor Institucional 192.168.1.100: +$ git add . +$ git commit -m "Hito: [Descripcion]" +$ git push origin main + +PASO 3: Snapshot de Infraestructura (Servidor .123) +Creación de carpeta cronológica en /publico/ y generación de archivos binarios: +$ mkdir -p /publico/backup-geoserver-YYYYMMDDHHMM +$ docker exec proyecto-postgres-1 pg_dump -U sigem_user sigem > /publico/backup-geoserver-YYYYMMDDHHMM/sigem_postgres_dump.sql +$ cd /yvyape/proyectos/sigem-gis && tar -czvf /publico/backup-geoserver-YYYYMMDDHHMM/geoserver-data_dir.tar.gz geoserver-data + +3. PROCEDIMIENTO DE RECUPERACIÓN TOTAL (DRP) +-------------------------------------------------------------------------------- +En caso de fallo catastrófico del servidor, siga estos pasos estrictamente: + +FASE A: Restauración del Entorno +1. Clonar el repositorio desde el servidor central a la carpeta de trabajo: + $ cd /yvyape/proyectos/ + $ git clone http://192.168.1.100/geo/gis-geoserver.git sigem-gis + +2. Iniciar los contenedores base (Postgres y GeoServer): + $ cd /yvyape/proyectos/sigem-gis + $ docker compose up -d postgres geoserver + +FASE B: Restauración de Datos (PostGIS) +Inyectar el volcado SQL al contenedor de base de datos recién creado: +$ cat /publico/backup-geoserver-VERSION/sigem_postgres_dump.sql | docker exec -i proyecto-postgres-1 psql -U sigem_user -d sigem + +FASE C: Restauración de Capas y Estilos (GeoServer) +Descomprimir las configuraciones de GeoServer en su volumen de datos: +1. Detener geoserver: $ docker compose stop geoserver +2. Borrar data antigua: $ rm -rf geoserver-data/* +3. Extraer backup: $ tar -xzvf /publico/backup-geoserver-VERSION/geoserver-data_dir.tar.gz -C /yvyape/proyectos/sigem-gis/ +4. Reiniciar: $ docker compose up -d geoserver + +FASE D: Despliegue del Binario Java +Recompilar e iniciar el backend: +$ ./mvnw clean package -DskipTests +$ docker compose restart backend-java + +================================================================================ +FIN DEL MANUAL +================================================================================