Saltar al contenido principal

Logto CLI

Logto CLI proporciona una forma conveniente de instalar, mantener y actualizar tu instancia de Logto sin tener que manejar manualmente esas tareas técnicas aburridas.

nota:

Actualmente no proporcionamos binarios, por lo que se requiere Node.js ^18.12.0 en el entorno.

Instalar CLI globalmente​

Instala mediante tu gestor de paquetes preferido para usar el comando logto globalmente:

npm i @logto/cli -g

Siempre puedes añadir --help para mostrar la información de ayuda de cada comando:

logto --help
logto db seed --help

CLI local​

Una versión incorporada de CLI se incluye con cada versión de Logto desde la v1.0.0-beta.11. Supón que ya tienes una instancia de Logto en ~/logto, entonces puedes ejecutar los siguientes comandos:

cd ~/logto
npm run cli # Invoca el CLI local

Ten en cuenta que si deseas ejecutar con opciones, necesitas anteponer un -- ANTES de las opciones para Logto CLI, por ejemplo:

npm run cli db seed -- --db-url postgresql://your-database-url

Usar CLI con npx​

Otra forma de usar Logto CLI es con npx, que puede ejecutar un paquete sin instalación.

npx @logto/cli

Esto será útil para invocaciones puntuales, por ejemplo:

npx @logto/cli db seed --db-url postgresql://your-database-url

Sembrar para despliegues aislados o sin conexión​

Desde Logto v1.40.0, tanto los comandos init (instalación) como db seed aceptan una bandera extra para entornos que no pueden acceder a internet público durante la instalación:

--disable-admin-pwned-password-check, --dapc

Cuando se activa, la política de contraseñas sembrada en el tenant administrador desactiva por defecto la comprobación de brechas de Have I Been Pwned (HIBP). Esto significa que crear el administrador inicial desde la página de bienvenida ya no se queda colgado cuando api.pwnedpasswords.com no es accesible (por ejemplo, en centros de datos aislados o detrás de firewalls de salida estrictos).

La bandera solo afecta al tenant administrador. La política de contraseñas del tenant por defecto no se modifica y permanece bajo tu control a través de Admin Console > Experiencia de inicio de sesión > Política de contraseñas después de que el primer administrador inicie sesión.

Instalación en un solo paso (recomendado para despliegues OSS nuevos):

logto init --disable-admin-pwned-password-check

Sembrar una base de datos existente (cuando Logto ya está extraído, o al volver a sembrar):

logto db seed --disable-admin-pwned-password-check

--dapc y --disable-admin-pwned-password-check son alias; cualquiera de los dos funciona.