Restaurar páginas

page restore devuelve una página a Confluence desde una copia de seguridad, y page check te dice antes si hace falta. La copia de seguridad es un archivo escrito por page get —idealmente con --attachments-dir, para que también vuelvan los archivos de la página— o una página de una copia de seguridad de espacio tomada con acs2md space get.

Hacer una copia de seguridad de una página

# La página con sus metadatos, y sus adjuntos al lado
acp2md page get by-id 2973106197 -o ./backups/page.json --attachments-dir ./backups/attachments

atlas_doc_format (el formato por defecto de page get) conserva en el JSON el título, el padre, la versión y las etiquetas de la página, que es lo que necesita una restauración.

page check

Compara una página respaldada con la página que Confluence tiene ahora. No cambia nada.

acp2md page check --file PAGE_FILE [--attachments-dir DIR] [flags]
acp2md page check --backup-dir SPACE_BACKUP --page-id PAGE_ID [flags]

Aliases: verify, diff

El informe da el estado de la página —ok, cambiada, renombrada, movida, en la papelera, archivada, en otro espacio o desaparecida—, las versiones respaldada y en vivo, si el cuerpo es el mismo, y los adjuntos y etiquetas respaldados que la página ya no tiene.

acp2md page check --file ./backups/page.json --attachments-dir ./backups/attachments

page restore

acp2md page restore --file PAGE_FILE [--attachments-dir DIR] [flags]
acp2md page restore --backup-dir SPACE_BACKUP --page-id PAGE_ID [flags]

Aliases: recover

Ejemplos

# Ve primero qué ocurriría
acp2md page restore --file ./backups/page.json --attachments-dir ./backups/attachments --dry-run
 
# Restaura la página, con sus adjuntos
acp2md page restore --file ./backups/page.json --attachments-dir ./backups/attachments
 
# Restaura una página de una copia de seguridad de espacio, sin intervención
acp2md page restore --backup-dir ./backups/DEVOPS --page-id 3134096561 --yes
 
# Restaura con otro título, en otro espacio
acp2md page restore --file ./backups/page.json --space-key ARCHIVE --title "Runbook (2025)"

Flags

Primero, el plan

♻️  Restore "Release Checklist" from ./backups/page.json
   Target space:  DevOps (DEVOPS)
   In Confluence: trashed
   Page:          create a new page under "2 - Operations" (3133376085)
   Attachments:   upload 3 (412.0 KB)
   Labels:        add release, ops
   Properties:    add the 2 backed-up ones the new page lacks
   Note:          the original page is trashed; the restore is a new page with a new ID

Restore this page? [y/N]

En un terminal, page restore pregunta antes de escribir. En un script, pasa --yes; sin él, el comando se detiene antes de escribir nada. --dry-run muestra el plan y no escribe nada.

Qué hace

--mode create siempre crea una página nueva; --mode update solo actualiza una página que esté vigente en el espacio.

Adjuntos, etiquetas y propiedades. Los adjuntos respaldados que la página no tiene se suben con sus nombres originales, y se añaden las etiquetas y propiedades de contenido que faltan. No se quita nada de lo que la página ya tiene. Una propiedad con un valor distinto se conserva —las aplicaciones guardan su estado en propiedades, como el estado de aprobación de un sistema de control documental— salvo que pases --overwrite-properties. Las imágenes de un cuerpo atlas_doc_format pasan a apuntar a los archivos subidos.

Dónde va una página creada. Bajo --parent-id cuando se indica; bajo su padre respaldado cuando esa página o carpeta sigue en el espacio; si no, en el nivel superior del espacio.

Títulos. Un espacio no puede contener dos páginas vigentes con el mismo título; una página en la papelera no retiene su título, así que una página que estaba en la papelera vuelve con el suyo. Cuando una página en vivo ya tiene ese título, la restauración se detiene e indica qué página es: cámbiale el nombre o pasa --title.

Si se cae la conexión. Cuando se pierde la respuesta a la creación de una página, antes de hacer nada más se busca la página por su título, de modo que un reintento nunca crea un duplicado.

Lo que no se puede recuperar

Una página creada es una página nueva: su ID, sus autores, su fecha de creación y su historial de versiones son nuevos, y los enlaces de otras páginas que apuntaban al ID antiguo siguen apuntando allí. La versión que escribe una restauración dice “Restored by acp2md from a backup taken” seguido de la fecha de la copia de seguridad; nunca menciona una ruta local.

Permisos

Restaurar requiere los permisos de Confluence para añadir y editar páginas en el espacio, añadir adjuntos y añadir etiquetas.