Servicios systemd

¿Qué permite hacer?

• Listar todos los servicios del VPS y ver el detalle de uno: su archivo de unidad, si está activo y si arranca al inicio.
• Crear un servicio a partir del contenido completo de un archivo de unidad.
• Reemplazar el archivo de unidad de un servicio existente.
• Arrancar, detener, reiniciar, habilitar o deshabilitar un servicio.
• Borrar un servicio (salvo los protegidos) y leer sus logs.

¿Cuándo conviene usarlo?

• Un proceso que tiene que quedar corriendo siempre y que no pertenece a una app de ArduMaker: un worker, un bot, un exportador de métricas.
• Reiniciar un servicio después de cambiar su configuración.
• Revisar por qué un servicio se cae.

¿Cómo funciona en ArduMaker?

Crear

1. Se valida el nombre: minúsculas, y espacios y / pasan a guiones. Solo letras, números y _ . @ : -, hasta 200 caracteres; si no, nombre_invalido.
2. Si ya existe /etc/systemd/system/<nombre>.service, se guarda una copia .backup.
3. Se escribe el contenido tal cual llega (sin validación extra), con permisos 644.
4. systemctl daemon-reload, después systemctl start y systemctl enable.
5. Si cualquiera de esos pasos falla, se borra la unidad nueva, se restaura la copia y se recarga systemd. La respuesta dice en qué paso falló (Failed to start service, Failed to enable service…).

En la práctica, crear un servicio siempre lo deja corriendo y habilitado al inicio; un servicio que no arranca no queda creado.

Editar

Editar reemplaza el archivo completo con el mismo procedimiento, pero hace start y no restart: si el servicio ya estaba corriendo, sigue con la configuración anterior hasta que se lo reinicie con controlar_servicio_vps y la acción restart.

Controlar y borrar

• start, stop y restart actúan ahora; enable y disable solo cambian si arranca con el sistema.
• Controlar no tiene lista de protegidos: se puede detener nginx o docker.
• Borrar detiene, deshabilita, quita /etc/systemd/system/<nombre>.service y recarga systemd. Una unidad que vino con un paquete del sistema queda detenida y deshabilitada, pero su archivo no está en esa carpeta y no se borra.
• No se pueden borrar: ssh, sshd, networking, systemd-journald, systemd-logind, docker, containerd, nginx, apache2, mysql y postgresql.

¿Qué cambia realmente?

• /etc/systemd/system/<nombre>.service (644) y el enlace de enable en el arranque del sistema.
• El proceso en ejecución, con la salida estándar y de error en el journal.
• Una entrada en el registro de actividad del VPS por cada alta, edición, acción o borrado.

Ejemplo de unidad

Una unidad como la que arma ArduMaker para los procesos de un deploy:

[Unit]
Description=mi-worker
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/opt/mi-worker
Environment="MODO=produccion"
ExecStart=/opt/mi-worker/venv/bin/python worker.py
Restart=always
RestartSec=3
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target

• Restart=always lo vuelve a levantar si se cae.
• StandardOutput=journal hace que ver_logs_systemd_vps muestre su salida.
• WantedBy=multi-user.target es lo que permite enable.

Esquema

Resultado esperado

• Las respuestas de crear, editar y controlar traen status, is_active e is_enabled leídos después de la operación.
• ver_servicio_vps devuelve service_file, content, status, is_active, is_enabled y details.
• ver_logs_systemd_vps devuelve las últimas 500 líneas del journal del servicio.

systemctl status mi-worker
journalctl -u mi-worker -n 100 --no-pager

Errores y resolución

Crear y editar son seguros de repetir con el mismo contenido. controlar_servicio_vps no lo es en general (repetir un stop o un restart corta el servicio otra vez) y puede detener servicios críticos. Si el VPS no contesta, el error es reintentable (424).

Relación con MCP

Sí, en los perfiles /mcp y /mcp/vps. Un agente de solo lectura solo ve listar_servicios_vps, ver_servicio_vps y ver_logs_systemd_vps.

Para los procesos de una app de Git conviene ver_config_deploy_app y guardar_config_deploy_app en lugar de estas herramientas. Referencia en /mcp/docs y ejemplos en /mcp/servicios.

Funciones relacionadas

• Tareas programadas
• Deploy desde GitHub
• Monitorización
• Terminal web
• Servidores VPS