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

  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 tiene como valor predeterminado 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 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.

¿Ha quedado contestada tu pregunta?