Actualizar acs2md

acs2md 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 acs2md v1.0.6. Si acs2md 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.


acs2md update --check        # solo informa; no cambia nada
acs2md update                # Linux
sudo acs2md 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/acs2md`
`--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 acs2md update


$ sudo acs2md update
Password:
Update acs2md v1.0.7 to the latest version? [y/N] y
→ Updating acs2md v1.0.7 → v1.0.8 (acs2md-v1.0.8-darwin-universal.pkg, 10.3 MB)
  ✓ downloaded and checksum verified
  ✓ installed to /usr/local/bin/acs2md
✅ Updated acs2md 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/acs2md, y registra un recibo que puedes ver con pkgutil --pkgs | grep climakers.
Tu licencia y tu configuración siguen siendo tuyas. Con sudo, acs2md 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 acs2md 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 acs2md --version.

Actualizar en Linux


acs2md 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 acs2md 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 acs2md 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:


$ acs2md 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 'acs2md 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 acs2md 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.
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 (acs2md 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.

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 acs2md 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 acs2md runs from …, but the macOS package installs to /usr/local/bin/acs2md`	Hay otra copia de acs2md primero en tu `PATH`	Elimina esa copia o usa `sudo acs2md 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.