Comandos de configuración

El grupo config te permite inspeccionar y gestionar la configuración activa de acp2md sin editar YAML manualmente.

Estos comandos son especialmente útiles en estaciones gestionadas, runners de CI o sesiones de soporte donde quieres pasos repetibles y un flujo de configuración auditable.

config create

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


acp2md config create

Si ya existe un archivo de configuración, el comando no lo sobrescribira. Elimina primero el archivo existente si quieres restablecer los valores por defecto.

config where

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


acp2md config where
 
# Escapado para el shell, listo para pegar en bash, zsh o cmd
acp2md config where --shell-escape

Usa --shell-escape cuando la ruta vaya a un script: entrecomilla una ruta con espacios para que el shell la lea como un solo argumento.

Ejemplo de salida:


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

Usa este comando para localizar el archivo y abrirlo en tu editor.

config list

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


acp2md config list

Usalo cuando necesites entender la configuración efectiva y no solo los valores almacenados en config.yaml.

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: 7
        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 clave concreta de configuración.


acp2md config get KEY

Ejemplos


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

config set

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


acp2md config set KEY VALUE

Ejemplos


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

Claves de configuración disponibles

Clave	Descripción
`confluence.domain`	Dominio de la instancia de Confluence
`confluence.username`	Correo de la cuenta de Atlassian
`confluence.api_token`	Token API de Confluence
`http.client.max_retries`	Número de reintentos HTTP
`http.client.base_timeout`	Tiempo de espera base de la petición (por ejemplo `10ms`)
`http.client.max_timeout`	Tiempo de espera máximo (por ejemplo `100ms`)
`http.client.proxy`	URL del proxy HTTP
`log.level`	Nivel de logging: `debug`, `info`, `warn`, `error`
`log.format`	Formato del logging: `text`, `json`
`log.file`	Salida del logging: `stdout`, `stderr` o una ruta de archivo
`debug.enabled`	Activa el modo debug (`true` / `false`)
`image.cache_dir`	Directorio para cachear imágenes descargadas
`image.max_size_bytes`	Tamaño máximo de imagen en bytes

Flujo recomendado

ejecuta acp2md config create
define los valores de conexion con Confluence con config set
confirnalos con config get o config list
ejecuta acp2md doctor