Estas recetas muestran formas comunes de usar Level CLI desde una terminal. Reemplace los nombres de ejemplo como web-01, Laptops, y Disk cleanup con recursos de su cuenta de Level.
ℹ️ NOTA: Ejecute lvl auth status antes de una receta para confirmar el perfil activo y la organización de Level. Prefiera los ID de recursos cuando un nombre coincida con más de un registro.
Iniciar sesión y verificar la sesión
Iniciar el inicio de sesión basado en navegador:
lvl auth login
Confirmar la sesión activa:
lvl auth status
El comando de inicio de sesión imprime un código de un solo uso y una URL de verificación. Después de aprobar el acceso en su navegador, la CLI guarda la sesión para el perfil activo.
Listar y filtrar dispositivos
Buscar nombres de dispositivos y devolver todas las páginas coincidentes:
lvl device list --search web --limit all
Devolver los mismos resultados en formato JSON:
lvl device list --search web --limit all -o json
Usar el filtro jq integrado para seleccionar campos específicos:
lvl device list --search web --limit all --jq '.list[] | {id, name, online}'--jq implica salida en formato JSON. Los resultados de tipo cadena se imprimen como texto plano. Los objetos y otros valores se imprimen como JSON compacto, un resultado por línea.
ℹ️ NOTA: Los comandos de lista paginada devuelven hasta 100 registros de forma predeterminada. Use --limit all solo cuando necesite el conjunto de resultados completo.
Exportar dispositivos a CSV
Exportar dispositivos de un grupo:
lvl device export --group Laptops > devices.csv
La exportación escribe el CSV sin procesar en la salida estándar. Rediríjalo a un archivo en lugar de agregar -o json.
Puede usar el mismo patrón para alertas y ejecuciones de automatización:
lvl alert export --status resolved > resolved-alerts.csv
lvl run export --status error > failed-runs.csv
Ejecutar un diagnóstico de solo lectura en un dispositivo similar a Unix
El siguiente ejemplo verifica el uso del sistema de archivos en un dispositivo Linux o macOS:
lvl script run \ --device web-01 \ --command 'df -h' \ --shell bash \ --run-as current_user \ --wait \ -o json
Este comando crea una ejecución de script ad hoc. --wait sondea hasta completarse e incluye la salida de los pasos en el resultado.
Si omite --wait, la CLI devuelve los ID de ejecución descubiertos. Compruebe una ejecución más tarde con:
lvl run get RUN_ID --wait -o json
⚠️ ADVERTENCIA: Confirme el sistema operativo de destino antes de ejecutar un comando ad hoc. La creación de scripts y las ejecuciones ad hoc utilizan de forma predeterminada la configuración SYSTEM configuración de ejecución como a menos que especifique otro valor.
Crear y reutilizar un script de diagnóstico guardado
Si ya tiene un script Bash revisado en os-info.sh, guárdelo en Level:
lvl script create \ --name 'OS info' \ --file ./os-info.sh \ --shell bash \ --run-as current_user \ -o json
Ejecutar el script guardado por nombre:
lvl script run 'OS info' --device web-01 --wait -o json
Un script guardado conserva su shell configurado, el tiempo de espera y la configuración de ejecución como. Cuando ejecute un script guardado por nombre o ID, no agregue sobreescrituras de shell o de ejecución como.
Use un ID de script cuando más de un script tenga el mismo nombre.
Previsualizar una especificación de automatización
Exportar una automatización existente como YAML:
lvl automation spec 'Disk cleanup' > disk-cleanup.yaml
Previsualizar cómo esa especificación cambiaría la automatización en vivo:
lvl automation apply -f disk-cleanup.yaml --dry-run -o json
Una ejecución de prueba imprime los cambios planificados sin aplicarlos.
Después de revisar el archivo y el resultado de la prueba, aplíquelo con:
lvl automation apply -f disk-cleanup.yaml
⚠️ ADVERTENCIA: Aplicar una especificación reconcilia la automatización en vivo con el archivo. Los disparadores o acciones existentes que no estén en el archivo pueden eliminarse. Los cambios se aplican en secuencia, por lo que un error puede dejar los cambios anteriores en su lugar. Mantenga una exportación actualizada y ejecute --dry-run antes de cada aplicación.
Inspeccionar políticas de monitor
Listar políticas de monitor:
lvl monitor policy list --limit all
Obtener una política por ID o nombre:
lvl monitor policy get 'Server health' -o json
Exportar su especificación:
lvl monitor policy spec 'Server health' > server-health.yaml
Previsualizar una especificación antes de aplicarla:
lvl monitor policy apply -f server-health.yaml --dry-run -o json
Al igual que la aplicación de automatización, la aplicación de política de monitor reconcilia el recurso en vivo y no es transaccional.
Usar referencias calificadas por grupo
Las referencias de dispositivos pueden usar un ID, nombre de host, nombre, apodo o un nombre de host calificado por grupo:
lvl device get 'Servers/web-01'
Las referencias calificadas por grupo ayudan cuando distintos grupos de dispositivos contienen el mismo nombre de host. Si una referencia sigue siendo ambigua, la CLI se detiene y muestra las coincidencias en lugar de elegir una.
Inspeccionar indicadores exactos y formas de salida
Mostrar la ayuda normal del comando:
lvl script run --help
Mostrar la referencia generada, incluida la forma de salida JSON:
lvl skill describe script run
Mostrar todos los comandos bajo un grupo:
lvl skill describe update
La CLI instalada es la fuente de verdad para sus indicadores actuales y definiciones de salida.
Lista de verificación de seguridad
Antes de ejecutar un comando que modifique Level o un dispositivo administrado:
Confirme la organización activa con
lvl auth status.Confirme cada destino por ID, nombre o referencia calificada por grupo.
Revise los scripts y las especificaciones JSON o YAML en su totalidad.
Compruebe si el comando tiene como valor predeterminado
SYSTEM, instala actualizaciones, reinicia un dispositivo o reemplaza un archivo.Use
--dry-rundonde esté disponible.Use
--yessolo después de revisar el conjunto completo de recursos seleccionados.Compruebe el historial de ejecuciones o los registros de actualizaciones para ver los resultados asíncronos.
Los comandos de eliminación permanente requieren confirmación en una terminal interactiva y requieren --yes en la ejecución no interactiva. Algunos comandos, incluidos el reinicio y el apagado de dispositivos, ejecutan la acción de inmediato sin solicitar confirmación.
