Actualizar acp2md

acp2md update instala la versión más reciente que incluye tu licencia, desde la propia herramienta. Después de la primera instalación ya no descargas un paquete por cada versión: un solo comando comprueba, descarga, verifica e instala.

Disponible desde acp2md v1.0.6. Si acp2md update responde “unknown command”, instala una vez v1.0.6 o posterior desde tu página de pedido; a partir de ahí, cada versión nueva llega con update.


acp2md update --check        # solo informa; no cambia nada
acp2md update                # Linux
sudo acp2md update           # macOS

Alias: upgrade, self-update

La actualización se descarga de Climakers usando tu licencia activada, se verifica con la suma SHA-256 generada al compilar la versión y se instala en lugar del binario en ejecución. Solo se envían las credenciales de tu licencia, y solo a Climakers; no necesitas cuenta de GitHub ni ningún otro acceso.

Opciones

Opción	Qué hace
`--check`	Informa si existe una versión más reciente; no cambia nada
`--version`	Instala esta versión, por ejemplo `v1.0.7` — también sirve para volver a una anterior
`--yes`	Instala sin pedir confirmación (obligatorio en CI y scripts)
`--force`	Vuelve a consultar en lugar de usar la caché de 6 horas, reinstala la misma versión o instala el paquete de macOS aunque el binario en ejecución no sea `/usr/local/bin/acp2md`
`--format`	`text` (por defecto) o `json` para scripts

Actualizar en macOS

En macOS la actualización es el mismo paquete .pkg firmado y notarizado con el que instalaste, aplicado con el installer de Apple. Instalar un paquete requiere permisos de administrador, así que ejecuta:


sudo acp2md update


$ sudo acp2md update
Password:
Update acp2md v1.0.7 to the latest version? [y/N] y
→ Updating acp2md v1.0.7 → v1.0.8 (acp2md-v1.0.8-darwin-universal.pkg, 10.3 MB)
  ✓ downloaded and checksum verified
  ✓ installed to /usr/local/bin/acp2md
✅ Updated acp2md to v1.0.8

Qué hace sudo, y qué no hace:

Solo ejecuta el instalador de Apple. El paquete instala un único archivo, /usr/local/bin/acp2md, y registra un recibo que puedes ver con pkgutil --pkgs | grep climakers.
Tu licencia y tu configuración siguen siendo tuyas. Con sudo, acp2md lee tu licencia desde tu propia carpeta personal y no escribe nada en ella, así que ningún archivo cambia de propietario.
Olvidar sudo no causa problemas. El comando se detiene antes de descargar nada e indica el comando exacto que debes ejecutar.
Sin avisos de Gatekeeper. El paquete está notarizado por Apple.
Una única ubicación. Si acp2md se ejecuta desde otro lugar que no sea /usr/local/bin (por ejemplo, una copia en tu carpeta personal), la actualización se niega, porque el paquete dejaría esa copia sin cambios. Elimina la otra copia o usa --force para instalar igualmente en /usr/local/bin.

Comprueba el resultado con acp2md --version.

Actualizar en Linux


acp2md update

El binario se reemplaza en su sitio con un único renombrado atómico, así que nunca queda a medio escribir, y un comando de acp2md que ya esté en ejecución sigue usando el binario anterior hasta que termina.

La actualización nunca usa sudo en Linux. El directorio que contiene acp2md debe poder ser escrito por ti. Si instalaste en /usr/local/bin como root, instala una vez más en un directorio propio, como ~/.local/bin (consulta Instalación y configuración inicial); a partir de ahí las actualizaciones funcionan sin sudo.

Windows no tiene versión publicada, así que update lo indica como no compatible.

Tu suscripción y las versiones anteriores

Mientras tu suscripción está activa, se incluye cada nueva versión. Cuando termina, conservas la versión que tienes y puedes seguir instalando cualquier versión publicada antes de la fecha de finalización:


$ acp2md update
❌ Error: your subscription ended on 2026-06-01; this release was published after that

Hint: The last version your license includes is v1.0.7: run 'acp2md update --version v1.0.7'. Renew your subscription to receive every new release.

Las licencias locales (sin conexión) también se actualizan, siempre que el archivo de licencia se haya emitido firmado. El servicio de actualización verifica esa firma sin ninguna cuenta de la tienda, y estas licencias descargan desde el almacenamiento de versiones de Climakers. Un archivo emitido antes de que existiera la firma se rechaza con “this local license is not signed”: pide un archivo reemitido y actívalo con acp2md license activate --license-file <ruta>. Consulta Licencia.

Comprobaciones, límites y CI

--check responde desde una caché local durante 6 horas. Añade --force para volver a consultar, por ejemplo justo después de que se anuncie una versión.
Las solicitudes están limitadas por licencia (5 instalaciones por hora). El uso normal — una comprobación al día y una instalación por versión — nunca alcanza el límite. Si ocurre, el comando indica cuánto esperar y no envía nada hasta entonces.
Una actualización descargada se conserva 24 horas, así que repetir tras una instalación fallida no la descarga de nuevo.
La tienda permite descargar cada archivo de versión diez veces al día. Cuando se alcanza ese límite, acp2md update descarga la misma versión desde el almacenamiento de versiones propio de Climakers, una vez al día por instalación. Disponible desde v1.0.10.
En CI nadie puede responder a la confirmación, así que update se niega sin --yes. Es preferible fijar la versión que instala tu pipeline (acp2md update --version v1.0.8 --yes) en lugar de actualizar en cada ejecución.

Para scripts, --format json imprime el resultado:


{
  "changed": false,
  "checked_at": "2026-09-19T12:00:00Z",
  "current": "v1.0.7",
  "latest": "v1.0.8",
  "update_available": true
}

update no necesita credenciales de Confluence y no cuenta para el límite de comandos de tu licencia. La dirección del servicio es la clave de configuración update.endpoint; cámbiala solo si el soporte de Climakers te lo pide.

El aviso diario de nueva versión

Cuando termina un comando ordinario, acp2md comprueba como máximo una vez al día si hay publicada una versión más reciente y, si la hay, imprime una línea en stderr:


ℹ️  A new version of acp2md is available: v1.0.10 → v1.0.12. Run: sudo acp2md update
  ➜ Turn this notice off with: acp2md config set update.notice false

La comprobación espera como máximo 2 segundos, no envía datos de licencia y no dice nada si falla o si no hay conexión.
Nunca se ejecuta en CI, bajo sudo, cuando stderr no es un terminal (por ejemplo, con la salida redirigida a un archivo) ni después de update, license, doctor o config.
Comparte su marca de tiempo diaria con update --check.
Desactívalo con acp2md config set update.notice false, o define ACP2MD_UPDATE_NOTICE=false en el entorno.

acp2md doctor muestra la misma información en su fila Latest version, y nunca hace fallar un diagnóstico por ello. Disponible desde v1.0.10.

Si algo falla

Mensaje	Causa	Solución
`installing the macOS package requires administrator rights`	Los paquetes de macOS se instalan con el instalador de Apple, que requiere root	`sudo acp2md update`; todavía no se descargó nada
`… is not writable by the current user` (Linux)	El binario está en un directorio propiedad de root	Instala una vez en un directorio propio, como `~/.local/bin`
`this acp2md runs from …, but the macOS package installs to /usr/local/bin/acp2md`	Hay otra copia de acp2md primero en tu `PATH`	Elimina esa copia o usa `sudo acp2md update --force`
`too many update requests; try again in …`	Se alcanzó el límite por licencia	Espera el tiempo indicado; en CI fija una versión en lugar de actualizar en cada ejecución
`your subscription ended on …`	La versión se publicó después de que terminara tu suscripción	Instala la versión que indica el mensaje con `--version`, o renueva
`this local license is not signed`	El archivo de licencia es anterior a la firma de licencias	Pide un archivo reemitido y actívalo con `--license-file`
`the update service is unavailable`	Una interrupción temporal	No se cambió nada; inténtalo más tarde

¿Sigues con problemas? Ejecuta el comando con --debug y consulta Soporte.