Configuración

Este modelo de configuración aplica solo a Atlassian Confluence Cloud. acs2md no es compatible con Confluence Server ni Confluence Data Center.

Las versiones publicadas están disponibles actualmente solo para macOS y Linux. No hay artefactos publicados para Windows en la versión actual.

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

Prioridad	Fuente	Ejemplo
1 (mas baja)	Valores predeterminados integrados
2	Archivo de configuración	(ver mas abajo)
3	Variables de entorno	`ACS2MD_CONFLUENCE_DOMAIN`
4 (mas alta)	Flags de CLI	`--log-level debug`

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

macOS

~/Library/Application Support/acs2md/

- - - - config.yaml
      - license.bin

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 debug detallada
  dir: debug # Directorio para artefactos de debug
 
# Gestion de imagenes
image:
  cache_dir: "" # Directorio para cachear imagenes descargadas
  max_size_bytes: 10485760 # Tamano máximo por imagen (10 MB por defecto)

Variables de entorno

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

Variable de entorno	Clave de configuración	Descripcion
`ACS2MD_CONFLUENCE_DOMAIN`	`confluence.domain`	Dominio de la instancia de Confluence
`ACS2MD_CONFLUENCE_USERNAME`	`confluence.username`	Correo de la cuenta de Atlassian
`ACS2MD_CONFLUENCE_API_TOKEN`	`confluence.api_token`	API token de Confluence
`ACS2MD_HTTP_CLIENT_MAX_RETRIES`	`http.client.max_retries`	Numero de reintentos
`ACS2MD_HTTP_CLIENT_BASE_TIMEOUT`	`http.client.base_timeout`	Timeout base de la petición
`ACS2MD_HTTP_CLIENT_MAX_TIMEOUT`	`http.client.max_timeout`	Timeout máximo de la petición
`ACS2MD_HTTP_CLIENT_PROXY`	`http.client.proxy`	URL del proxy HTTP
`ACS2MD_LOG_LEVEL`	`log.level`	Nivel de log
`ACS2MD_LOG_FORMAT`	`log.format`	Formato del log
`ACS2MD_LOG_FILE`	`log.file`	Archivo de salida del log
`ACS2MD_DEBUG_ENABLED`	`debug.enabled`	Activa el modo debug
`ACS2MD_IMAGE_CACHE_DIR`	`image.cache_dir`	Directorio de cache de imagenes
`ACS2MD_IMAGE_MAX_SIZE_BYTES`	`image.max_size_bytes`	Tamano máximo de imagen

Flags globales de CLI

Estos flags están disponibles en todos los comandos:

Flag	Predeterminado	Descripcion
`--config-file`	(ver `config where`)	Ruta a un archivo de configuración personalizado
`--log-level`	`info`	Verbosidad del log: `debug`, `info`, `warn`, `error`
`--log-format`	`text`	Formato del log: `text` o `json`
`--log-file`	(descartar)	Escribe logs en `stdout`, `stderr` o una ruta de archivo
`--debug`	`false`	Atajo de `--log-level=debug`
`--image-cache-dir`	(ninguno)	Directorio para cachear imagenes descargadas
`--image-max-size-bytes`	`10485760`	Tamano máximo en bytes para imagenes cacheadas

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"

Evita almacenar credenciales del proxy en el archivo de configuración si se comparte o esta versionado. Usa en su lugar la variable de entorno ACS2MD_HTTP_CLIENT_PROXY.

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