Antes de empezar
- Permiso para exportar el contenido del grupo correspondiente y la información personal.
- Documentación de la aplicación de origen, el formato de exportación y el destino previsto.
- Un destino de prueba separado con las notificaciones salientes y las integraciones externas contenidas.
1. Decide qué debe permitirte hacer el paquete.
Escribe el resultado previsto antes de seleccionar un botón de exportación. Una copia legible para un miembro que se va, un traslado a otra aplicación y una recuperación completa del servicio existente necesitan material distinto. Una exportación puede servir bien al primer propósito y fallar en los otros dos.
BookStack establece esta distinción de forma explícita: sus herramientas de exportación e importación de contenido no están pensadas como copia de seguridad y restauración. Una copia legible en HTML o PDF es útil, pero no debería sustituir silenciosamente el conjunto de recuperación de la aplicación. Exportar e importar contenido en BookStack.
Para un grupo de taller hipotético, el objetivo inicial es modesto: que otro mantenedor autorizado pueda leer el manual de funcionamiento e importar una sección representativa, incluidos sus diagramas, en una instancia de prueba separada.
2. Registra el formato y las carencias.
Crea una matriz que describa qué necesitas conservar y cómo vas a demostrarlo. No pongas «completo» en una celda hasta que hayas comprobado el destino.
| Material | Resultado candidato | Pregunta a resolver |
|---|---|---|
| Páginas wiki | HTML legible más paquete de importación compatible | ¿Se conservan los encabezados, los enlaces y los diagramas? |
| Archivos adjuntos | Archivos originales y un manifiesto | ¿Puede cada referencia importante encontrar su archivo? |
| Calendario | Archivo de intercambio de calendario compatible | ¿Se comportan la recurrencia y la zona horaria como se espera? |
| Membresía y permisos | Notas de mapeo de roles controlado | ¿Qué reglas de acceso deben recrearse manualmente? |
| Recuperación de la aplicación | Conjunto de copia de seguridad específico de la versión | ¿Qué configuración y base de datos siguen siendo necesarias? |
BookStack documenta un formato ZIP portátil que contiene datos de contenido, archivos adjuntos e imágenes y que puede reimportarse en BookStack. Eso no establece compatibilidad con otro wiki ni la conservación de todas las opciones a nivel de servicio. Formatos de exportación de BookStack.
3. Dale al paquete un punto de partida humano.
Añade un breve archivo léeme con la aplicación y versión de origen, la fecha y zona horaria de exportación, el alcance seleccionado, el rol de quien exporta, la lista de archivos y el destino previsto. Usa nombres de carpeta descriptivos como readable-content, attachments y import-package. Guarda las credenciales en otro lugar; escribe únicamente el procedimiento de recuperación aprobado para los mantenedores autorizados.
El manual hipotético contiene una lista de comprobación inicial, una página de cuidado de la máquina, un diagrama y una hoja de cálculo enlazada. Su manifiesto registra esos cuatro elementos, sus rutas relativas y la relación entre la página y su archivo adjunto. Registra también una página restringida como excluida deliberadamente, para que una ausencia no se confunda más tarde con una pérdida accidental.
Una suma de comprobación puede ayudar a identificar un archivo sin cambios durante la transferencia. No demuestra que la exportación fuera completa, tuviera los permisos correctos o fuera legible.
4. Inspecciona una muestra representativa.
Abre la copia legible sin depender de una sesión activa en la aplicación original. Sigue un enlace, inspecciona una imagen incrustada y abre el archivo adjunto enlazado. Busca referencias que sigan conduciendo al servicio de origen. Registra qué enlaces son intencionadamente externos y cuáles se romperían tras un traslado.
Para los calendarios, elige una muestra que incluya un evento recurrente, una excepción y un evento con una zona horaria relevante. Nextcloud documenta la exportación de calendario y la importación compatible con iCalendar .ics . Eso establece una vía de intercambio compatible, no la prueba de que tu destino conserve todas las funciones elegidas. Importación y exportación de calendario de Nextcloud.
Consulta la documentación de la versión instalada antes de seguir las etiquetas de la interfaz; el manual continuo enlazado puede describir una versión diferente.
5. Importa en un destino separado y controlado.
Usa un destino de prueba vacío o una colección de prueba aprobada explícitamente. Mantén intactos el servicio en funcionamiento y sus datos originales. Desactiva las notificaciones salientes y limita las conexiones externas antes de iniciar la aplicación importada; el propósito es evaluar los datos, no reenviar eventos históricos a los miembros.
Haz que el segundo mantenedor siga el archivo léeme sin depender de instrucciones no documentadas de quien exportó. Compara los elementos esperados con el resultado importado. Verifica el diagrama, el enlace a la hoja de cálculo, la estructura de las páginas y los permisos de miembros previstos. Registra cualquier mapeo de roles que requiera trabajo manual. Si un formato carece de una función necesaria, decide si reconstruirla, elegir otro método de exportación o conservar un archivo legible junto al nuevo servicio.
6. Haz que los errores sean informativos.
Si faltan archivos, compara el alcance de la exportación y los permisos de quien exportó antes de generar repetidamente archivos más grandes. Si los enlaces se rompen, determina si hacen referencia al servicio antiguo o a un archivo ausente del paquete. Si la importación crea duplicados inesperados, detente e inspecciona sus reglas de coincidencia antes de volver a importar el mismo paquete.
Para el ejemplo del taller, la aceptación significa que el segundo mantenedor puede leer y editar las páginas seleccionadas, recuperar cada archivo incluido y demostrar que un miembro normal no puede acceder al material excluido. Registra cada resultado y quién lo revisó. «La importación terminó» es solo una observación. Mantén las diferencias sin resolver listadas junto al paquete para que el grupo pueda tomar una decisión deliberada sobre ellas.
7. Mantén las exportaciones y la recuperación en carriles separados.
Guarda un paquete aceptado en una ubicación controlada e independiente del servicio de origen y acuerda cuándo actualizarlo. Vuelve a revisarlo tras cambios en formatos importantes, permisos o versiones de la aplicación. Los archivos exportados pueden contener contenido privado incluso cuando el destino es solo temporal, así que asígnales también un acceso y una decisión de retención.
Mantén el conjunto de recuperación de la aplicación por separado: la documentación de recuperación de BookStack, por ejemplo, requiere base de datos y archivos más allá de una exportación legible de documentos. Requisitos de copia de seguridad y restauración de BookStack.
Continúa con la simulacro de restauración para la recuperación del servicio, la hoja de trabajo de almacenamiento para el espacio de trabajo de exportación y la inventario de servicios para las dependencias. La portabilidad es algo que hay que demostrar con tu paquete, no dar por supuesto a partir de una extensión de archivo.
Documentación detrás de esta nota
Usa la documentación de la versión que realmente ejecutas. Estos ejemplos son material de planificación, no un registro de una prueba en un VPS Hoszen.