Ir al contenido principal

Ejemplos y recetas de Level CLI

Use practical lvl examples to inspect devices, export data, run diagnostics, and preview automation changes safely.

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:

  1. Confirme la organización activa con lvl auth status.

  2. Confirme cada destino por ID, nombre o referencia calificada por grupo.

  3. Revise los scripts y las especificaciones JSON o YAML en su totalidad.

  4. Compruebe si el comando usa de forma predeterminada SYSTEM, instala actualizaciones, reinicia un dispositivo o reemplaza un archivo.

  5. Use --dry-run donde esté disponible.

  6. Use --yes solo después de revisar el conjunto completo de recursos seleccionados.

  7. 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.

¿Ha quedado contestada tu pregunta?