Skip to main content

CI/CD — GitHub Actions (tokens, secrets, dispatch, runbook 401/403)

1) Tokens y permisos

  • GITHUB_TOKEN vs PAT: cuándo usar cada uno; scopes requeridos repo + workflow.
  • Header: Authorization: token ... (o Bearer si tu política lo exige).

2) Secrets

  • Secret name ≠ valor del token; cómo referenciarlo en YAML (secrets.MI_PAT).
  • Gestión/listado de nombres de secrets con gh secret list.

3) Triggers entre repos

  • Preferencia: repository_dispatch si mismo owner; alternativa workflow_dispatch con dispatches. Reglas de ownership/permisos.

4) Runbook de errores (401/403)

  • 401 Bad credentials: nombre del secret, scopes, token expirado.
  • 403 Resource not accessible / Forbidden: owner distinto, branch protection, políticas org.
  • Paso a paso con curl y Octokit para aislar causa.

Contrato mínimo

  • Secrets: GH_AUTH_TOKEN (PAT con repo,workflow).
  • Workflow: job “notify-atlas” con POST dispatches + payload event_type.
  • Verificación: Actions de origen y destino marcan green y evento recibido.