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 en Level. Prefiera los ID de recursos cuando un nombre coincida con más de un registro.
Iniciar sesión y verificar la sesión
Inicie el inicio de sesión basado en el navegador:
lvl auth login
Confirme 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 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 paginados 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 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 espera la finalización e incluye la salida del paso en el resultado.
Si omite --wait, la CLI devuelve los ID de ejecución descubiertos. Consulte 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 usan de forma predeterminada la configuración de SYSTEM 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
Anular los valores de variables guardados para una ejecución:
lvl script run 'Repair Chrome' --device web-01 --variable channel=stable --variable version=129 --wait -o json
--variable solo está disponible cuando ejecuta un script guardado. Repita --variable <name>=<value> para cada anulación. Puede identificar una variable por nombre, ID o {{reference}}. Las variables que no especifique usarán sus valores predeterminados guardados. Cada valor se conserva exactamente, incluido un valor vacío, comas y signos adicionales de = signos.
Un script guardado conserva su shell, tiempo de espera y configuración de ejecución configurados. Cuando ejecute un script guardado por nombre o ID, no agregue anulaciones de shell ni de ejecución.
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 activa:
lvl automation apply -f disk-cleanup.yaml --dry-run -o json
Una ejecución en seco imprime los cambios planificados sin aplicarlos.
Después de revisar el archivo y el resultado de la ejecución en seco, aplíquelo con:
lvl automation apply -f disk-cleanup.yaml
⚠️ ADVERTENCIA: Aplicar una especificación reconcilia la automatización activa 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 vigor. Mantenga una exportación actualizada y ejecute --dry-run antes de cada aplicación.
Inspeccionar políticas de monitores
Listar políticas de monitores:
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 al aplicar automatizaciones, aplicar una política de monitor reconcilia el recurso activo y no es transaccional.
Usar referencias calificadas por grupo
Las referencias a 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 son útiles cuando distintos grupos de dispositivos contienen el mismo nombre de host. Si una referencia sigue siendo ambigua, la CLI se detiene y lista las coincidencias en lugar de elegir una.
Inspeccionar indicadores exactos y formatos de salida
Mostrar la ayuda normal del comando:
lvl script run --help
Mostrar la referencia generada, incluido el formato de salida JSON:
lvl skill describe script run
Mostrar todos los comandos de un grupo:
lvl skill describe update
La CLI instalada es la fuente de verdad para sus indicadores y definiciones de salida actuales.
Lista de verificación de seguridad
Antes de ejecutar un comando que cambie 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 usa de forma predeterminada
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 actualización para obtener 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 del dispositivo, solicitan la acción de inmediato sin un aviso de confirmación.
