Comprobar frente a una copia de seguridad
space check compara una copia de seguridad tomada con space get con el espacio tal como lo tiene Confluence ahora, e informa de la diferencia página a página. Solo lee: no cambia nada ni en Confluence ni en la copia de seguridad.
Úsalo para verificar que una copia de seguridad sigue siendo una copia fiel, para ver qué recuperaría una restauración antes de ejecutarla, o para que una tarea programada falle cuando un espacio gobernado se desvía de su copia de referencia.
Disponible desde acs2md v1.0.12.
Comprobar por clave
acs2md space check by-key SPACE_KEY --backup-dir DIR [flags]Aliases: key, k — el propio comando check responde también a verify y diff.
--backup-dir es el directorio en el que escribió space get: su --output-dir, o <output-dir>/<space-key>.
Ejemplos
# Compara el espacio en vivo con su copia de seguridad
acs2md space check by-key DEVOPS --backup-dir ./backups
# Compara también los cuerpos de página, no solo las versiones (una llamada API por página)
acs2md space check by-key DEVOPS --backup-dir ./backups --deep
# Todas las páginas en JSON, para un informe o un script
acs2md space check by-key DEVOPS --backup-dir ./backups --all -f json > check.json
# Hace fallar una tarea programada cuando el espacio se desvió de la copia de seguridad
acs2md space check by-key DEVOPS --backup-dir ./backups --fail-on-driftFlags
| Flag | Short | Predeterminado | Descripción |
|---|---|---|---|
--backup-dir | — | — | Copia de seguridad con la que comparar: el --output-dir de space get |
--deep | — | false | Compara también los cuerpos de página (una llamada API por página) |
--all | — | false | Lista también las páginas que coinciden con la copia de seguridad |
--format | -f | table | Formato de salida: table o json |
--fail-on-drift | — | false | Termina con error cuando algo difiere |
--concurrency | — | 4 | Consultas simultáneas (llamadas API adicionales) |
Salida de ejemplo
🧾 Backup: ./backups/DEVOPS (manifest, storage, last updated 2026-10-31 10:17)
🌐 Live: DevOps (DEVOPS) on mycompany.atlassian.net
📄 Pages: 300 in the backup — 1 missing, 1 trashed, 1 archived, 1 changed, 1 renamed, 1 extra, 295 ok
📁 Folders: 15 in the backup — 1 renamed, 14 ok
┌──────────┬────────┬────────────┬──────────────────────┬────────┬──────┬───────────────────────────────────┐
│ STATE │ KIND │ ID │ TITLE │ BACKUP │ LIVE │ DETAIL │
├──────────┼────────┼────────────┼──────────────────────┼────────┼──────┼───────────────────────────────────┤
│ missing │ page │ 3134096570 │ Legacy Deploy Notes │ v11 │ │ not in Confluence: purged, or … │
│ trashed │ page │ 3134096571 │ Update DataLake │ v13 │ v4 │ in the space's trash │
│ archived │ page │ 3134096572 │ Environment Variables│ v28 │ v11 │ archived │
│ changed │ page │ 3134096573 │ Ingestion Flow │ v66 │ v67 │ live v67 is newer than backup v66 │
│ renamed │ page │ 3134096574 │ Release Checklist │ v6 │ v6 │ now titled "Release Checklist v2" │
│ extra │ page │ 3134096575 │ Firehose Workflow │ │ v7 │ not in the backup │
│ renamed │ folder │ 5989695572 │ Explanation │ │ │ now titled "Explanations" │
└──────────┴────────┴────────────┴──────────────────────┴────────┴──────┴───────────────────────────────────┘
⚠️ 7 difference(s) between the backup and Confluence.Los mensajes de progreso van por stderr, así que la salida de -f json puede canalizarse tal cual.
Comprobar por ID
acs2md space check by-id SPACE_ID --backup-dir DIR [flags]Aliases: id
Los flags y el comportamiento son equivalentes a space check by-key.
Estados de página
Una página puede estar en más de un estado a la vez, por ejemplo cambiada y renombrada.
| Estado | Significado |
|---|---|
ok | Confluence tiene la misma versión que la copia de seguridad |
changed | La versión en vivo es distinta. Con --deep, también una página cuya versión es la misma pero cuyo cuerpo no lo es |
renamed | El título en vivo es distinto |
moved | El padre en vivo es distinto (requiere una copia de seguridad con manifiesto) |
trashed | La página está en la papelera del espacio |
archived | La página está archivada |
elsewhere | La página está ahora en otro espacio |
missing | Confluence ya no la tiene: purgada, o no visible para estas credenciales. La API de Confluence no permite distinguir entre ambos casos |
extra | Una página en vivo que la copia de seguridad no contiene |
Las carpetas se comparan del mismo modo, y también el nombre y la página de inicio del espacio.
Copias de seguridad antiguas
Una copia de seguridad con .backup-manifest.json —todas las que toma space get a partir de v1.0.12— se compara por completo. Las copias de seguridad anteriores se siguen comparando, en la medida en que lo permiten:
- Con un
.get-sync-state.json(el modo--incrementalpor defecto): las páginas se emparejan por ID y versión. Los padres se deducen de la estructura de carpetas, así que no se informa de los movimientos. - Solo con archivos de página: las páginas se emparejan por el nombre de archivo que
space getderiva de cada título, así que no se pueden detectar los cambios de nombre.
El informe indica qué tipo de copia de seguridad leyó y qué no pudo registrar esa copia.
Después de una restauración
Una página que space restore volvió a crear tiene un ID nuevo. space check lee el archivo de progreso de la restauración en la copia de seguridad, de modo que las páginas y carpetas restauradas se emparejan con sus originales y se informan como ok, con “restored as page …” en el detalle.
Casos de uso
- Verificación de copias de seguridad: confirma después de un
space getprogramado que la copia está completa y al día. - Triaje de incidentes: ve qué se eliminó, se envió a la papelera o se editó desde la última copia de seguridad buena antes de decidir si restaurar.
- Gobernanza y alertas de desviación: ejecútalo cada noche con
--fail-on-driftfrente a una copia de seguridad de referencia de un espacio controlado. - Vista previa de la restauración: las páginas que
space checkinforma como missing, trashed o archived son las quespace restorerecupera por defecto.