Comandos de configuración

El grupo config te permite inspeccionar y gestionar la configuración activa de acs2md sin editar YAML a mano.

Estos comandos son útiles para preparar estaciones de trabajo repetibles, pipelines de CI y escenarios de soporte donde necesitas un rastro claro de los cambios de configuración.

config create

Crea un nuevo archivo de configuración en la ubicacion predeterminada, rellenado con todos los ajustes disponibles y sus valores por defecto.


acs2md config create

Si ya existe un archivo de configuración, el comando no lo sobrescribira. Eliminalo primero si quieres volver a los valores por defecto.

config where

Muestra la ruta completa al archivo de configuración activo.


acs2md config where

Ejemplo de salida:


/Users/alice/Library/Application Support/acs2md/config.yaml

config list

Muestra todos los valores de configuración actuales, incluidos los cargados desde variables de entorno y flags de CLI.


acs2md config list

Usalo cuando necesites inspeccionar la configuración efectiva y no solo los valores escritos en disco.

Ejemplo de salida


confluence:
    api_token: AT************************************************************3D
    domain: <tenant>.atlassian.net
    type: cloud
    username: <user>@<domain>
debug:
    dir: debug
    enabled: false
http:
    client:
        base_timeout: 10ms
        max_retries: 3
        max_timeout: 100ms
        proxy: ""
image:
    cache_dir: ./images_cache
    max_size_bytes: 10485760
log:
    file: ""
    format: text
    level: info

El token API se anonimiza automáticamente en la salida. El resto de valores se muestran tal cual.

config get

Recupera el valor de una unica clave de configuración.


acs2md config get KEY

Ejemplos


acs2md config get confluence.domain
acs2md config get log.level
acs2md config get http.client.max_retries

config set

Define un valor de configuración y lo guarda en el archivo de configuración.


acs2md config set KEY VALUE

Ejemplos


# Credenciales de Confluence
acs2md config set confluence.domain mycompany.atlassian.net
acs2md config set confluence.username you@example.com
acs2md config set confluence.api_token YOUR_API_TOKEN
 
# Logging
acs2md config set log.level debug
acs2md config set log.format json
acs2md config set log.file /var/log/acs2md.log
 
# HTTP
acs2md config set http.client.max_retries 5
acs2md config set http.client.proxy "http://proxy.corp.example.com:8080"
 
# Imagenes
acs2md config set image.cache_dir /tmp/acs2md-cache
acs2md config set image.max_size_bytes 20971520

Claves de configuración disponibles

Clave	Descripcion
`confluence.domain`	Dominio de la instancia de Confluence
`confluence.username`	Correo de la cuenta de Atlassian
`confluence.api_token`	API token de Confluence
`http.client.max_retries`	Numero de reintentos HTTP
`http.client.base_timeout`	Timeout base de petición (ej. `10ms`)
`http.client.max_timeout`	Timeout máximo de petición (ej. `100ms`)
`http.client.proxy`	URL del proxy HTTP
`log.level`	Nivel de log: `debug`, `info`, `warn`, `error`
`log.format`	Formato del log: `text`, `json`
`log.file`	Salida del log: `stdout`, `stderr` o una ruta de archivo
`debug.enabled`	Activa el modo debug (`true` / `false`)
`image.cache_dir`	Directorio para cachear imagenes descargadas
`image.max_size_bytes`	Tamano máximo de imagen en bytes

Flujo recomendado

ejecuta acs2md config create
define los valores de conexion con Confluence usando config set
compruebalos con config get o config list
ejecuta acs2md doctor