Integraciones » Ejecutar un agente local

Ejecutar un agente local

¿Qué es el agente local?

El agente local de nuzur es un pequeño daemon que ejecutas donde vive tu base de datos — tu propia computadora durante el desarrollo, o un servidor (VPS) con una base de datos autoalojada en producción. Crea un túnel seguro entre esa base de datos y el Gestor de Datos de nuzur, para que puedas explorar, consultar y gestionar datos en nuzur sin exponer tu base de datos a internet ni almacenar credenciales fuera de la máquina.

Tu DSN nunca sale de la máquina donde corre el agente. Solo los resultados de las consultas se reenvían a través del túnel cifrado.

Requisitos

CLI de nuzur instalada (descargar)
Una cuenta de nuzur (el plan Starter gratuito incluye 1 conexión de base de datos; los planes Pro y Team tienen conexiones ilimitadas)
Una base de datos MySQL o PostgreSQL en la máquina donde corre el agente (tu computadora o un servidor/VPS)

Paso 1 — Instala la CLI

Descarga e instala la CLI de nuzur desde nuzur.com/cli y verifica la instalación:

nuzur-cli --version

Paso 2 — Agrega una conexión de base de datos

nuzur-cli agent connection add

La primera vez que lo ejecutas, la CLI inicia tu sesión (abriendo el navegador) y vincula esta máquina automáticamente — no hay un paso aparte de login ni de agent pair. Luego te pedirá:

Name — un nombre para esta conexión (p. ej. local-mysql)
Driver — mysql o postgres
Host / Port / User / Password — las credenciales de tu base de datos
Database (solo Postgres) — el nombre de la base de datos de destino
Default schema (solo Postgres) — normalmente public

Los metadatos de la conexión (nombre, driver, esquema) se publican en nuzur. Tu DSN permanece en disco, nunca en la nube.

Límite del plan: el plan Starter gratuito permite una sola conexión de base de datos. Los planes Pro y Team tienen conexiones ilimitadas.

Para ver todas las conexiones registradas:

nuzur-cli agent connection list

Para eliminar una conexión:

nuzur-cli agent connection remove <nombre-o-uuid>

Paso 3 — Inicia el agente

nuzur-cli agent start

El agente se ejecuta en primer plano y espera solicitudes de consulta entrantes desde nuzur. Deja este terminal abierto mientras uses el Gestor de Datos.

Detente en cualquier momento con Ctrl+C.

Opciones

Flag	Descripción
`--driver`	Driver de base de datos (`mysql` o `postgres`)
`--dsn`	Cadena DSN completa (omite el prompt interactivo)
`--reset-db`	Descarta el DSN/driver guardado y vuelve a preguntar
`--max-concurrent-queries`	Límite de consultas simultáneas (por defecto: 32)

También se aceptan las variables de entorno NUZUR_AGENT_DRIVER y NUZUR_AGENT_DSN.

Paso 4 — Inicio automático al iniciar sesión (opcional)

Para que el agente arranque automáticamente al iniciar sesión, instálalo como servicio del sistema operativo:

nuzur-cli agent install

Compatible con macOS (launchd) y Linux (systemd user service). En Windows, ejecuta nuzur-cli agent start manualmente por ahora — el inicio automático gestionado aún no está disponible.

Para detener y eliminar el servicio:

nuzur-cli agent uninstall

Verificar el estado

nuzur-cli agent status

Muestra el estado de vinculación, el DSN/driver guardado y si el servicio de inicio automático está instalado.

Verificar la conexión

Con el agente ejecutándose en un terminal, ejecuta el autotest en otro terminal:

nuzur-cli agent self-test

Esto envía un SELECT 1 a través del ciclo completo nube → agente → base de datos e imprime OK si todo funciona.

Gestionar máquinas vinculadas

La vinculación ocurre automáticamente la primera vez que agregas una conexión, así que rara vez necesitas hacerlo a mano. Si quieres vincular una máquina por adelantado (por ejemplo, para aprovisionarla antes de agregar conexiones), ejecuta:

nuzur-cli agent pair

En un servidor sin interfaz gráfica (VPS), donde abrir un navegador no es práctico, vincula con un token de aprovisionamiento de corta duración:

nuzur-cli agent pair --provisioning-token <token>

Esto es lo que nuzur-cli deploy usa internamente para vincular automáticamente los servidores desplegados.

Para listar todas las máquinas vinculadas a tu cuenta:

nuzur-cli agent list

Desvincular una máquina

Para revocar el agente de esta máquina en la nube y eliminar las credenciales locales:

nuzur-cli agent unpair

Si la entrada en la nube ya fue eliminada desde otro lugar, usa --keep-remote para borrar solo los archivos locales:

nuzur-cli agent unpair --keep-remote