# Línea de comandos de dkle ``` dkle serve [-config dkle.json] servidor HTTP, HTTPS y FastCGI dkle run [opciones] [MÉTODO URI] una petición simulada, sin abrir puertos dkle check [--root ] valida programas, rutas y configuración dkle dkl [opciones] un programa en consola, como dkl de Devkron 2.0 dkle version dkle help ``` ## dkle serve Arranca el servidor con la configuración de `dkle.json` (por omisión, el de la carpeta actual): ``` dkle serve -config /opt/dkle/dkle.json ``` Al arrancar escribe en la bitácora qué atiende: ```json {"t":"2026-11-01T15:54:47.936Z","sitio":"","nivel":"info","msg":"dkle 2.0.1 atendiendo","escucha":["http://0.0.0.0:8090"],"raiz":"/opt/dkle","sitios":["conector.localhost"]} ``` Se detiene con Ctrl+C o `SIGTERM`: deja de aceptar conexiones y espera a que terminen las peticiones en curso. Los sitios nuevos, los programas, las rutas y la configuración de los sitios se recargan solos; un cambio en `dkle.json` requiere reiniciar. Configuración en [Configuración](/es/devkron/2.0/dkle/configuracion.md). ## dkle run Lanza una petición por el mismo camino que una real (rutas, `@http_context`, configuración del sitio y límites) sin abrir ningún puerto. Sirve para probar un conector mientras se escribe, en scripts y en pruebas automáticas. ``` dkle run --root /opt/dkle --host conectores.ejemplo.com POST /webhooks/proveedor \ -H "Content-Type: application/json" -H "X-Firma: Bmx2eg…" --body @evento.json ``` | Opción | Qué hace | |---|---| | `--root ` | Raíz de la instalación (`web/` y `_config/`); por omisión, la del `dkle.json` o la carpeta actual | | `-config ` | Un `dkle.json` (para `trusted_proxies`, `default_site`…); opcional | | `--request ` | La petición completa en un archivo JSON (ver abajo) | | `-H "Nombre: valor"` | Un encabezado; se puede repetir y reemplaza al del archivo | | `--body ` | El cuerpo; `@archivo` lo lee de un archivo y `-` de la entrada estándar | | `--host ` | El host de la petición; por omisión, el del archivo o el único sitio | | `--ip ` | La IP de la conexión; por omisión `127.0.0.1` | | `--https` | La petición llegó por HTTPS | | `--mock ` | Las llamadas salientes del conector van a `url` (un servidor de pruebas que imita a los destinos), con la misma ruta y el encabezado `Host` del destino original; `outbound` y `max_response_kb` se aplican igual. Sin `--mock`, las llamadas **salen en vivo** a los destinos reales | La respuesta (estado, encabezados y cuerpo) sale en la salida estándar y la bitácora en la salida de errores: ``` $ dkle run --root . GET /hola 2>/dev/null HTTP/1.1 200 OK Content-Length: 83 Content-Type: application/json;charset=utf-8 X-Powered-By: Devkron X-Request-Id: fe661395ce8fe9af40067ec1 {"mensaje":"Hola desde Devkron Edge","fecha":"2026-11-01T16:05:58Z","ruta":"/hola"} ``` Código de salida: 0 si la respuesta es menor que 500, 1 si es 5xx y 2 si hay un error de uso. ### Archivo de petición ```json { "method": "POST", "uri": "/webhooks/shopify?tienda=centro", "host": "conectores.ejemplo.com", "https": true, "ip": "203.0.113.10", "headers": { "Content-Type": "application/json", "X-Shopify-Hmac-Sha256": "Zm9vYmFy...", "X-Request-Id": "prueba-001" }, "cookies": { "sesion": "abc" }, "body": { "id": 820982911946154508, "total_price": "199.00" } } ``` `body` puede ser un objeto (se envía como JSON), una cadena (va tal cual), o se reemplaza por `"body_file": "pedido.json"` (lo lee `dkle run`, no el conector) o `"body_b64"` para un cuerpo binario. ``` dkle run --root /opt/dkle --request peticion.json ``` ## dkle check Revisa una instalación sin atender peticiones: programas (sintaxis, `#include` permitidos, funciones que no están en Edge, llamadas a funciones internas), archivos de rutas, configuración de cada sitio y `dkle.json`. ``` $ dkle check --root /opt/dkle error: web/c.localhost/malo.dkl:4: {9999} Error de sintaxis [...] - El encabezado 'functions.dkh' es de la distribución de Devkron 2 y no está disponible en Devkron Edge[Ln= 4] 1 errores, 0 avisos ``` Distingue **errores** (el sitio o el programa no funcionará) de **avisos** (llaves desconocidas en la configuración, un programa sin `#include "edge.dkh"`, una ruta que apunta a un archivo que no existe, un `_protected/routing.dk` que `dkle` no ejecuta…). Código de salida: 0 sin errores, 1 con alguno. Conviene correrlo antes de cada publicación, por ejemplo en el script de despliegue. ## dkle dkl Ejecuta un programa en la consola, con la misma interfaz y salida que `dkl programa.dkl` de Devkron 2.0. Sirve para probar funciones y fragmentos de la biblioteca Edge sin armar un sitio: ``` dkle dkl prueba.dkl -hide-log ``` | Opción | Qué hace | |---|---| | `-hide-log` | Sin la bitácora de la ejecución (Iniciado, ID de ejecución, Terminado, duración) | | `-hide-output` | No escribe la salida del programa | | `-hide-critical` | No escribe el error no manejado | | `-ninja` | `-hide-log` y `-hide-output` | | `-parse` | Muestra el árbol del programa sin ejecutarlo | | `-id:` | Identificador de la ejecución | | `-output:` | También escribe la salida en el archivo (`@id` se reemplaza por el identificador) | | `-log:` | Escribe la bitácora en el archivo | | `-encoding:` | `utf8`, `utf8bom`, `default` o `not-set`, para `-output` y `-log` | En la consola, `print` sí escribe en la salida estándar. `config.get` y `env.get` usan la configuración del sitio que indique la variable de entorno `DEVKRON_EDGE_HOST` (y la carpeta `_config/` del directorio actual). ## dkle version ``` $ dkle version dkle 2.0.1 ```