# 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
```