egutierrez
47fac22230
- .claude/CLAUDE.md - .claude/commands/subagentes.md - .claude/rules/INDEX.md - .mcp.json - bash/functions/cybersecurity/analyze_dns.md - bash/functions/cybersecurity/audit_http_headers.md - bash/functions/cybersecurity/audit_ssh_config.md - bash/functions/cybersecurity/check_firewall.md - bash/functions/cybersecurity/detect_suspicious_users.md - bash/functions/cybersecurity/encrypt_file.md - ... Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
67 lines
2.8 KiB
Markdown
67 lines
2.8 KiB
Markdown
---
|
|
name: e2e_run_checks
|
|
kind: function
|
|
lang: go
|
|
domain: infra
|
|
version: "1.0.0"
|
|
purity: impure
|
|
signature: "func E2ERunChecks(checks []E2ECheck, workDir string) ([]CheckResult, error)"
|
|
description: "Ejecuta una lista de E2ECheck en orden y retorna un CheckResult por check. Soporta comandos de shell (via bash -c), health checks HTTP, y referencias a otros artefactos (Ref, actualmente skip). Los checks individuales que fallan no abortan la ejecucion del resto."
|
|
tags: [e2e, testing, infra, checks, validation, monitoring, pipeline, pendiente-usar]
|
|
uses_functions: [health_check_http_go_infra]
|
|
uses_types: [E2ECheck_go_infra, CheckResult_go_infra]
|
|
returns: []
|
|
returns_optional: false
|
|
error_type: "error_go_core"
|
|
imports: [bytes, context, fmt, os/exec, strings, time]
|
|
tested: true
|
|
tests:
|
|
- "todos los checks pasan con exit 0"
|
|
- "check falla por exit code incorrecto"
|
|
- "check falla por stdout_contains no encontrado"
|
|
- "check falla por timeout de comando"
|
|
test_file_path: "functions/infra/e2e_run_checks_test.go"
|
|
file_path: "functions/infra/e2e_run_checks.go"
|
|
params:
|
|
- name: checks
|
|
desc: "Lista de E2ECheck declarados en app.md::e2e_checks. Se ejecutan en el orden del slice."
|
|
- name: workDir
|
|
desc: "Directorio de trabajo para los subprocesos. Usar string vacio para heredar el directorio del proceso actual."
|
|
output: "Slice de CheckResult con un resultado por cada check de entrada. El error solo indica fallo de infraestructura (imposible iniciar el proceso, workDir invalido), no fallos individuales de checks."
|
|
---
|
|
|
|
## Ejemplo
|
|
|
|
```go
|
|
zero := 0
|
|
checks := []infra.E2ECheck{
|
|
{ID: "api-alive", Health: "http://localhost:8080/health", TimeoutS: 30},
|
|
{ID: "data-ok", Cmd: "psql $DB_URL -c 'SELECT 1'", ExpectExit: &zero},
|
|
{ID: "schema-v3", Cmd: "migrate status", ExpectStdoutContains: "version: 3"},
|
|
}
|
|
|
|
results, err := infra.E2ERunChecks(checks, "/opt/apps/myapp")
|
|
for _, r := range results {
|
|
fmt.Printf("%s: %s (%dms)\n", r.ID, r.Status, r.DurationMs)
|
|
}
|
|
```
|
|
|
|
## Comportamiento por tipo de check
|
|
|
|
| Campo presente | Comportamiento |
|
|
|---|---|
|
|
| Solo `Cmd` (foreground) | Ejecuta con bash -c, captura stdout/stderr, evalua ExpectExit y ExpectStdoutContains |
|
|
| `Cmd` terminando en `&` | Lanza en background, no espera exit, pasa inmediatamente al paso Health |
|
|
| Solo `Health` | Sondea el endpoint HTTP hasta 200 o timeout |
|
|
| `Cmd` + `Health` | Ejecuta Cmd primero, luego sondea Health |
|
|
| Solo `Ref` | skip con error "ref handler not implemented" |
|
|
| Ninguno | skip |
|
|
|
|
## Notas
|
|
|
|
Los comandos background (terminan en `&`) son utiles para iniciar servicios y luego verificar su salud via `Health`. Se asume exit 0 inmediato; si el proceso no levanta antes del timeout del health check, el check falla.
|
|
|
|
Stdout y stderr se truncan a 4KB por check para evitar resultados excesivamente grandes.
|
|
|
|
La implementacion de `Ref` (cross-service checks) esta reservada para issue posterior.
|