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 de 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 árbol resultante ya es útil 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 preservación más que un espejo exacto.


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

Por qué es útil:

las páginas eliminadas en Confluence se conservan localmente
en ejecuciones posteriores solo se reprocesa lo que cambia
la salida se comporta más como un archivo histórico que como un espejo vivo

Preparar una migración de plataforma

Usa este flujo cuando el equipo necesita un árbol documental portable antes de mover contenido a un sitio estático 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 migración
la estructura de directorios es mucho más sencilla de mapear al sistema destino

Exportación nativa para ingeniería de migración

Usa este flujo cuando el equipo necesita cargas nativas de Confluence para transformación personalizada, depuración de migración o análisis de ingeniería antes de decidir cómo gestionar la conversión a Markdown.


acs2md space get by-key DOCS \
  --format atlas_doc_format \
  --output-dir ./native/docs

Por qué es útil:

la exportación nativa preserva la representación de origen sin convertirla primero
los equipos de ingeniería pueden inspeccionar salida ADF o Storage antes de definir reglas personalizadas de migración
el mismo binario sigue sirviendo para la conversión masiva a Markdown cuando el flujo esté listo para avanzar

Generar un corpus amplio para RAG o búsqueda empresarial

Usa este flujo cuando el cliente necesita contenido repetible a escala para IA o indexación.


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 exportación debe ejecutarse de forma periódica con muy poca intervención 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 imágenes embebidas ayudan o perjudican al uso posterior
tratar permisos y propiedades como parte del programa de exportación cuando la gobernanza importe

Usa acs2md cuando la necesidad real es 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.