Configuración

acs2md aplica la configuración desde cuatro fuentes, en orden de prioridad ascendente:

En la practica, esto permite a los equipos separar valores persistentes de la estacion de trabajo, ajustes puntuales por ejecución y gestion de secretos especifica de la automatizacion.

Ubicacion del archivo de configuración

La ubicacion predeterminada del archivo de configuración depende del sistema operativo. Ejecuta:

acs2md config where

Uso recomendado:

• guarda los valores no secretos en el archivo de configuración
• inyecta secretos mediante variables de entorno cuando sea posible
• reserva los flags de CLI para overrides puntuales y depuracion

Para crear un archivo de configuración con todos los valores por defecto rellenados:

acs2md config create

Referencia completa del archivo de configuración

# Conexion con Confluence
confluence:
  domain: mycompany.atlassian.net # Dominio de tu instancia de Confluence
  username: you@example.com # Correo de tu cuenta de Atlassian
  api_token: YOUR_API_TOKEN # API token de id.atlassian.com
 
# Comportamiento del cliente HTTP
http:
  client:
    max_retries: 3 # Numero de reintentos tras un fallo
    base_timeout: 10ms # Timeout inicial de la petición
    max_timeout: 100ms # Timeout máximo despues de reintentos
    proxy: "" # URL del proxy HTTP (ej. http://proxy.corp:8080)
 
# Logging
log:
  level: info # debug | info | warn | error
  format: text # text | json
  file:
    "" # Ruta del log; stdout | stderr | /path/to/file.log
    # Cada ejecución trunca el archivo
 
# Modo debug
debug:
  enabled: false # Activa salida de depuración detallada
  dir: debug # Directorio para artefactos de depuración
 
# Gestión de imágenes
image:
  cache_dir: "" # Define esto solo si quieres fijar una caché compartida
  max_size_bytes: 10485760 # Tamaño máximo por imagen (10 MB por defecto)

Cuando image.cache_dir queda sin definir, las configuraciones generadas suelen omitir la clave para mantener el comportamiento por defecto orientado a la salida. En ese modo, acs2md ancla la caché en <output-dir>/<space-key>/.image_cache junto al archivo de estado, o en ./.image_cache cuando escribe en stdout. La clave del espacio siempre se añade a --output-dir. Define image.cache_dir explícitamente solo cuando necesites una ubicación fija de caché compartida entre exportaciones.

Variables de entorno

Cada clave de configuración puede definirse con una variable de entorno añadiendo el prefijo ACS2MD_ y sustituyendo . por _:

Flags globales de CLI

Estos flags están disponibles en todos los comandos:

Practicas seguras de configuración

• Prefiere variables de entorno para API tokens en sistemas compartidos o gestionados.
• Usa config create para establecer la estructura esperada del archivo antes de editarlo manualmente.
• Ejecuta doctor despues de cambios de configuración para validar juntos licencia, credenciales y conectividad.
• Usa un --config-file personalizado cuando necesites configuraciones aisladas de prueba y produccion en la misma máquina.

Detras de un proxy corporativo

acs2md config set http.client.proxy "http://proxy.corp.example.com:8080"

Con autenticación:

acs2md config set http.client.proxy "http://user:password@proxy.corp.example.com:8080"

Escribir logs en un archivo

acs2md space convert by-key MYSPACE --log-file acs2md.log

Cada ejecución trunca el archivo de log, por lo que siempre contiene solo la salida de la ejecución mas reciente. Usa stdout o stderr para enviar logs directamente a tu terminal:

acs2md space convert by-key MYSPACE --log-file stdout