Flujos y comandos

Esta página reúne flujos operativos de acs2md para clientes que necesitan operaciones repetibles a escala de espacio, no solo ejemplos aislados de comandos.

Si todavía no has completado la configuración inicial, empieza por Instalación y configuración inicial. Vuelve aquí cuando el puesto, la licencia y el acceso a Confluence ya estén validados.

Copia de continuidad de un espacio vivo

Usa este flujo cuando el cliente quiere mantener una copia actualizada del espacio fuera de la plataforma origen.


acs2md space convert by-key DOCS \
  --output-dir ./continuity/docs \
  --sync

Por qué es útil:

--sync mantiene la salida alineada con el espacio vivo
el arbol resultante ya es util fuera de Confluence
el cliente obtiene una copia de continuidad que puede revisar, respaldar o republicar

Exportación orientada a archivo que conserva borrados

Usa este flujo cuando el objetivo es preservacion mas que espejo exacto.


acs2md space convert by-key DOCS \
  --output-dir ./archive/docs \
  --incremental

Por qué es útil:

las paginas eliminadas en Confluence se conservan localmente
en ejecuciones posteriores solo se reprocesa lo que cambia
la salida se comporta mas como un archivo historico que como un espejo vivo

Preparar una migración de plataforma

Usa este flujo cuando el equipo necesita una arbol documental portable antes de mover contenido a un sitio estatico o a un repositorio.


acs2md space pages by-key DOCS --tree
acs2md space convert by-key DOCS \
  --include-metadata \
  --output-dir ./migration/docs

Por qué es útil:

space pages --tree permite validar el alcance antes de convertir
los metadatos ayudan a conservar referencias durante la migracion
la estructura de directorios es mucho mas sencilla de mapear al sistema destino

Generar un corpus amplio para RAG o búsqueda empresarial

Usa este flujo cuando el cliente necesita contenido repetible a escala para IA o indexacion.


acs2md space convert by-key KB \
  --exclude-marks \
  --embed-images=false \
  --output-dir ./rag/kb

Por qué es útil:

todo el espacio se convierte en un corpus Markdown coherente
la salida orientada a texto es más fácil de fragmentar e indexar
las ejecuciones recurrentes actualizan el corpus sin reprocesar todo

Revisión de gobernanza y accesos

Usa este flujo cuando permisos y metadatos son tan importantes como el contenido.


acs2md space list --format json > governance/spaces.json
acs2md space properties by-key DOCS --format json > governance/docs-properties.json
acs2md space permissions by-key DOCS --resolve-users --format json > governance/docs-permissions.json

Por qué es útil:

inventario, metadatos y permisos quedan recogidos juntos
--resolve-users hace la salida más legible para revisión con negocio
es un flujo válido para auditoría, limpieza o preparación de migración

Exportación programada para operaciones

Usa este flujo cuando la exportacion debe ejecutarse de forma periodica con muy poca intervencion manual.


export ACS2MD_CONFLUENCE_DOMAIN=mycompany.atlassian.net
export ACS2MD_CONFLUENCE_USERNAME=$CONFLUENCE_USER
export ACS2MD_CONFLUENCE_API_TOKEN=$CONFLUENCE_TOKEN
 
acs2md space convert by-key DOCS \
  --output-dir ./scheduled/docs \
  --sync \
  --log-file acs2md.log

Por qué es útil:

las variables de entorno evitan exponer secretos en el historial
el comportamiento de sincronización es explícito y predecible
el log deja una pista operativa de las ejecuciones recurrentes

Secuencia recomendada para una ejecución con cliente

confirmar el puesto con doctor
descubrir el alcance con space list y space pages
decidir si la salida debe comportarse como espejo o como archivo
evaluar si la reescritura de enlaces y las imagenes embebidas ayudan o perjudican al uso posterior
tratar permisos y propiedades como parte del programa de exportacion cuando la gobernanza importe

Usa acs2md cuando la necesidad real sea escala, repetibilidad y gestión de un patrimonio documental. Si el requisito es una sola página exacta, acp2md sigue siendo la opción más afinada.