Instalación de agente remoto¶

Guía paso a paso para instalar un agente remoto en tu infraestructura.

Métodos de instalación¶

Método	Recomendado para
Docker	Instalación rápida, desarrollo
Docker Compose	Producción simple
Kubernetes	Producción escalable
Binario	Sin contenedores

Prerrequisitos¶

Cuenta en Nexus con permisos de administrador
Token de registro (se genera en Nexus)
Servidor con requisitos mínimos

Generar token de registro¶

Ve a Configuración > Agentes remotos
Haz clic en + Nuevo agente
Copia el token generado

┌─────────────────────────────────────────────────────────────────┐
│ Registrar nuevo agente                                          │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│ Token de registro:                                              │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ nxs_agent_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0      │ │
│ └─────────────────────────────────────────────────────────────┘ │
│                                                  [📋 Copiar]    │
│                                                                 │
│ ⚠️ Este token expira en 24 horas.                              │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Instalación con Docker¶

1. Pull de la imagen¶

docker pull nexusai/agent:latest

2. Ejecutar el agente¶

docker run -d \
  --name nexus-agent \
  --restart unless-stopped \
  -e NEXUS_TOKEN="nxs_agent_..." \
  -e AGENT_NAME="mi-agente" \
  -v /var/nexus-agent:/data \
  nexusai/agent:latest

3. Verificar estado¶

docker logs nexus-agent

Deberías ver:

[INFO] Connecting to Nexus...
[INFO] Registration successful
[INFO] Agent "mi-agente" is now online

Instalación con Docker Compose¶

1. Crear archivo docker-compose.yml¶

version: '3.8'

services:
  nexus-agent:
    image: nexusai/agent:latest
    container_name: nexus-agent
    restart: unless-stopped
    environment:
      - NEXUS_TOKEN=${NEXUS_TOKEN}
      - AGENT_NAME=${AGENT_NAME:-nexus-agent}
      - LOG_LEVEL=${LOG_LEVEL:-info}
    volumes:
      - agent-data:/data
      - /var/run/docker.sock:/var/run/docker.sock  # Opcional: para Docker-in-Docker
    networks:
      - internal  # Tu red interna

volumes:
  agent-data:

networks:
  internal:
    external: true

2. Crear archivo .env¶

NEXUS_TOKEN=nxs_agent_...
AGENT_NAME=prod-agent-1
LOG_LEVEL=info

3. Iniciar¶

docker-compose up -d

Instalación en Kubernetes¶

1. Crear Secret¶

apiVersion: v1
kind: Secret
metadata:
  name: nexus-agent-secret
  namespace: nexus
type: Opaque
stringData:
  token: "nxs_agent_..."

2. Crear Deployment¶

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nexus-agent
  namespace: nexus
spec:
  replicas: 1
  selector:
    matchLabels:
      app: nexus-agent
  template:
    metadata:
      labels:
        app: nexus-agent
    spec:
      containers:
      - name: agent
        image: nexusai/agent:latest
        env:
        - name: NEXUS_TOKEN
          valueFrom:
            secretKeyRef:
              name: nexus-agent-secret
              key: token
        - name: AGENT_NAME
          value: "k8s-agent"
        resources:
          requests:
            memory: "512Mi"
            cpu: "250m"
          limits:
            memory: "2Gi"
            cpu: "1000m"
        volumeMounts:
        - name: data
          mountPath: /data
      volumes:
      - name: data
        persistentVolumeClaim:
          claimName: nexus-agent-pvc

3. Aplicar¶

kubectl apply -f nexus-agent.yaml

Verificar instalación¶

Una vez instalado, verifica en Nexus:

Ve a Agentes remotos
El agente debería aparecer con estado "Online"

┌─────────────────────────────────────────────────────────────────┐
│ mi-agente                                          ✅ Online    │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│ ID: agent-12345                                                 │
│ Versión: 1.5.0                                                  │
│ Conectado desde: 192.168.1.100                                  │
│ Última actividad: Ahora                                         │
│                                                                 │
│ Recursos disponibles:                                           │
│ • CPU: 4 cores                                                  │
│ • RAM: 8 GB                                                     │
│ • Disco: 45 GB libres                                           │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Actualizar agente¶

Docker¶

docker pull nexusai/agent:latest
docker-compose down
docker-compose up -d

Kubernetes¶

kubectl rollout restart deployment/nexus-agent -n nexus

Desinstalar¶

Docker¶

docker stop nexus-agent
docker rm nexus-agent

En Nexus: 1. Ve a Agentes remotos 2. Selecciona el agente 3. Haz clic en Eliminar

Siguiente: Configuración - Opciones de configuración.