Licencia
acp2md requiere una licencia válida para ejecutar comandos de conversión. La gestión de la licencia se realiza mediante el grupo de comandos license.
Esta es la primera dependencia operativa que debe validarse en una máquina nueva. No esperes a que una exportación real falle para descubrir un problema de licencia.
Compra acp2md en la página del producto acp2md o revisa todos los planes activos en store.climakers.com, la tienda de Climakers en Lemon Squeezy. La licencia está vinculada a la máquina donde se activa.
Descripción general
acp2md admite dos caminos de licencia:
- Activación comercial en línea a través de LemonSqueezy con una máquina conectada a Internet
- Activación local sin conexión con un archivo de licencia vinculado a la máquina para entornos restringidos o aislados
Esta flexibilidad permite estandarizar acp2md tanto en un entorno conectado convencional como en una red estrictamente controlada.
license activate
Activa acp2md con una clave de licencia comprada o con un archivo de licencia local para uso sin conexión.
Usa la activación en línea cuando la máquina pueda alcanzar el servicio de licencias de Lemon Squeezy. Usa la activación mediante archivo local cuando la máquina esté aislada, restringida por el cliente o funcione en una red donde la validación en línea no sea práctica.
# Activación comercial en línea
acp2md license activate --license-key YOUR_LICENSE_KEY
# Activación local sin conexión
acp2md license activate --license-file ./license.binValida el resultado inmediatamente después de activar:
acp2md license validateLos comandos de diagnóstico y recuperación como config,
doctor, license, tree,
support y completion siguen disponibles incluso
cuando los comandos de exportación de páginas están bloqueados por la
licencia. Eso permite recuperar el entorno sin reinstalar la herramienta.
license validate
Comprueba si la licencia instalada actualmente está activa y es utilizable en la máquina actual.
Ejecuta este comando después de la activación, antes de la primera exportación real y antes de cualquier ejecución programada o de cara al cliente en la que un fallo de licencia resultaría costoso.
acp2md license validateMotivos habituales para ejecutar license validate:
- inmediatamente después de activar una máquina nueva
- antes de que arranque un flujo recurrente de exportación o de cumplimiento
- después de restaurar una máquina desde copia de seguridad o tras migrar el perfil
- cuando una activación anterior se desactivó o podría haber caducado
Comportamiento de validación por plan
acp2md valida automáticamente las licencias instaladas de LemonSqueezy antes de cada comando no exento, pero una validación en línea contra la API no se dispara en cada ejecución. Para licencias en línea, la validación a través de la API se produce cuando se alcanza cualquiera de los siguientes umbrales, lo que ocurra primero.
Licencias en línea de LemonSqueezy
| Variante | Umbral de tiempo | Umbral de comandos |
|---|---|---|
| Trial | 2 días | 50 comandos |
| Hobbyist | 6 días | 50 comandos |
| Multiple Seats | 7 días | 25 comandos |
La variante Trial es una evaluación gratuita de 14 días. Además de los umbrales anteriores, tiene una fecha absoluta de expiración a los 14 días desde la compra.
Si la máquina está sin conexión cuando toca validar mediante la API, acp2md recurre a la validación local y sigue funcionando con normalidad. La comprobación en línea se reintenta en una ejecución posterior cuando vuelva la conectividad. Ejecuta acp2md license validate cuando quieras forzar la comprobación en línea de inmediato.
Licencias locales sin conexión
Las licencias sin conexión se validan por completo en la propia máquina y no requieren acceso de red. El archivo de licencia puede imponer estas restricciones:
| Restricción | Descripción |
|---|---|
| Límite de comandos | Número máximo de comandos permitidos (0 significa ilimitado) |
| Intervalo de validación | Ventana temporal de validez, como 24h, 7d o 1y |
| Fecha de expiración | Fecha absoluta de caducidad incorporada al archivo generado |
license list
Muestra los detalles de licencia almacenados que conoce la instalación local.
acp2md license listÚsalo cuando necesites un resumen operativo rápido del estado actual de la licencia sin abrir el archivo bruto.
license where
Muestra la ubicación en disco del archivo de licencia cifrado.
acp2md license whereEs útil cuando necesitas confirmar la ubicación de la licencia vinculada a la máquina antes de una copia de seguridad, una restauración o una incidencia de soporte.
license export
Exporta el archivo de licencia actual a una ubicación de respaldo.
Úsalo antes de sustituir una estación de trabajo, reconstruir una imagen de runner o transferir la custodia operativa a otro miembro del equipo.
acp2md license export --output ./acp2md-license-backup.binTrata las licencias exportadas como activos sensibles vinculados a máquina. Guárdalas en los mismos entornos protegidos que usarías para otros secretos operativos y materiales de recuperación.
license import
Importa desde una ruta de respaldo un archivo de licencia exportado previamente.
acp2md license import --license-file ./acp2md-license-backup.binÚsalo cuando estés restaurando una activación local conocida y válida a la ubicación esperada de la aplicación después de una reconstrucción o una recuperación.
license deactivate
Desactiva la instancia de licencia vinculada a la máquina actual.
acp2md license deactivateEjecuta este comando antes de retirar una máquina, reconstruirla o mover deliberadamente la licencia operativa a otra estación de trabajo. Una desactivación limpia es más segura que descubrir activaciones obsoletas durante una exportación urgente de una página.
license terms
Muestra el acuerdo de licencia del software en la terminal.
acp2md license termsÚsalo cuando compras, legal o compliance necesiten revisar el texto de licencia aplicable desde la herramienta instalada. El mismo texto legal también está disponible en la página de Términos de Licencia.
Flujo Operativo Recomendado
Para una máquina o runner nuevos, la secuencia más segura es:
- activar la licencia con
acp2md license activate - confirmar la activación con
acp2md license validate - registrar la ubicación instalada con
acp2md license where - ejecutar
acp2md doctorpara validar el estado completo del puesto - exportar una copia de respaldo con
acp2md license exportcuando la máquina pase a formar parte de un flujo de producción
Esto mantiene activación, verificación, diagnóstico y capacidad de recuperación dentro del mismo flujo operativo en lugar de tratar la licencia como un detalle aislado de setup.
Entornos Sin Conexión O Restringidos
Para entornos aislados o con restricciones de red, usa el flujo complementario de licensegen para producir un archivo local license.bin y actívalo con --license-file.
Este camino está pensado para:
- laboratorios aislados de clientes
- entornos regulados sin acceso saliente
- entornos de disaster recovery donde el acceso a internet está deshabilitado a propósito
Después de la activación local, usa las mismas comprobaciones operativas que con una activación en línea:
acp2md license validate
acp2md doctor¿Necesitas Ayuda?
Si la activación o la validación de licencia fallan:
- vuelve a ejecutar
acp2md license validate - confirma la ubicación instalada con
acp2md license where - ejecuta
acp2md doctor - genera un paquete de soporte con
acp2md support --output acp2md-support.txt
Esa secuencia aporta a soporte el contexto de licencia, entorno y diagnóstico necesario para resolver el problema con rapidez.