egutierrez
55c907a3ac
Agregar 4 skills de ejemplo funcionales y README del sistema: Skills de ejemplo: - devops/deploy-service: deploy completo con rollback - analysis/log-analyzer: analisis de logs con metricas - communication/daily-report: reportes diarios automaticos - system/health-check: verificacion de salud multi-servicio Cada skill incluye: - SKILL.md con frontmatter YAML + instrucciones markdown - Descripcion de parametros y proceso paso a paso - Ejemplos de uso y consideraciones de seguridad skills/README.md documenta: - Diferencia entre tools (atomicas) y skills (flujos multi-paso) - Formato de SKILL.md y carga progresiva (3 niveles) - Categorias disponibles y uso desde agentes Las skills son contenido declarativo, no codigo Go.
2.6 KiB
2.6 KiB
name, description
| name | description |
|---|---|
| deploy-service | Deploy de un servicio via SSH a un servidor remoto. Verifica que el servicio este corriendo, hace backup de la version anterior, actualiza el binario, reinicia el servicio y valida que responda correctamente. |
Deploy Service Skill
Esta skill guia el proceso completo de deploy de un servicio a produccion via SSH.
Prerequisitos
- Acceso SSH al servidor de destino
- El servicio debe estar configurado como systemd unit
- El binario compilado debe estar disponible localmente o via URL
Proceso de deploy
1. Verificar estado del servicio
Usa ssh_command para verificar el estado actual del servicio:
systemctl status <service-name>
Si el servicio no existe, pregunta al usuario si debe crearlo.
2. Crear backup de la version anterior
cp /path/to/service /path/to/service.backup.$(date +%Y%m%d-%H%M%S)
3. Detener el servicio
systemctl stop <service-name>
4. Actualizar el binario
Opciones:
- Si el binario esta local: usa
scpossh_commandcon heredoc - Si el binario esta en URL: usa
ssh_commandconwgetocurl
# Ejemplo con URL
wget -O /path/to/service <binary-url>
chmod +x /path/to/service
5. Reiniciar el servicio
systemctl start <service-name>
6. Verificar que el servicio responde
Espera 5 segundos y verifica:
systemctl is-active <service-name>
Si el servicio expone un endpoint HTTP, usa http_get para verificar que responde:
curl -f http://localhost:<port>/health
7. Rollback en caso de error
Si el servicio no arranca o no responde:
- Detener el servicio
- Restaurar el backup
- Reiniciar con la version anterior
- Notificar al usuario del error
Parametros requeridos
El usuario debe proporcionar:
host: servidor de destino (ej: "prod-server-01")service_name: nombre del systemd unit (ej: "myapp.service")service_path: ruta al binario en el servidor (ej: "/usr/local/bin/myapp")binary_source: "local" o URL del binario
Parametros opcionales:
health_endpoint: endpoint HTTP para verificar salud (ej: "http://localhost:8080/health")post_deploy_command: comando adicional a ejecutar despues del deploy
Seguridad
- Valida que el host este en la allowlist de SSH del agente
- Valida que el binario tenga checksum correcto (si se proporciona)
- Nunca ejecutes comandos arbitrarios sin validar
Ejemplo de uso
Usuario: "Haz deploy de myapp a prod-server-01"
Agente:
- skill_search("deploy service")
- skill_load("deploy-service")
- Preguntar parametros faltantes
- Ejecutar el proceso paso a paso
- Reportar resultado