Skip to content

RINF-54 Workflows de despliegue con la aprobación de Core: Laravel, WordPress y estático - #5

Merged
sergio-cortinas merged 1 commit into
mainfrom
RINF-54-deploy-workflows
Nov 4, 2026
Merged

sergio-cortinas merged 1 commit into
mainfrom
RINF-54-deploy-workflows

Conversation

@sergio-cortinas

Copy link
Copy Markdown
Contributor

Resumen para Sergio

Esta PR es la hija 2 de RINF-54. Son los tres workflows reutilizables de despliegue: leen rasgo.deploy.yml y solo tocan el servidor cuando Core confirma la aprobación. Todavía no los usa nadie. Los adoptarán rasgo-core en la hija 3, rasgo-wp-base en la hija 4 y TMST01ALX en la hija 5. Despliegan de verdad cuando Core tenga deploy-start (RCOR-42: la spec 003 está fusionada y el código, pendiente).

Tarea

  • Plane: RINF-54 (épica del incremento 4), hija 2, «Workflows reutilizables de despliegue».
  • Spec: light, en la descripción de RINF-54. El contrato HTTP de deploy-start y deploy-finish es el de specs/003-approvals-deploy/plan.md de rasgo-core (#59).

Qué cambia

  • Los tres workflows: deploy-laravel.yml (laravel-ploi y monorepo-ploi), deploy-wordpress.yml (webhook de Ploi, como elegiste hoy) y deploy-static.yml (Cloudflare Pages con wrangler). Los tres siguen el mismo orden y se detienen en el primer paso que falla:
    1. contrato;
    2. secretos;
    3. deploy-start;
    4. despliegue;
    5. salud;
    6. deploy-finish.
  • actions/deploy-core: los pasos comunes están en un script, core.sh, con 74 pruebas. El workflow test pasa ShellCheck y esas pruebas en cada PR.
  • README: sección nueva «Deploy workflows» y ejemplos del contrato ajustados:
    • WordPress usa PLOI_DEPLOY_WEBHOOK.
    • La web estática comprueba /version.json.
    • Los contratos de Ploi llevan rollback: none.

Decisiones que tomé (revísalas)

  1. Ploi despliega la cabeza de su rama, no un commit concreto. Para que llegue lo aprobado, los workflows de Ploi se paran antes de deploy-start si la rama no está en el commit de la ejecución. Esto tiene tres consecuencias:
    • Producción se despliega justo después de fusionar la release.
    • Volver a una etiqueta anterior no se puede hacer a través de Ploi: se hace con un revert en main o con el rollback del panel.
    • Por eso los contratos de Ploi dicen rollback: none. El ejemplo de Laravel de la hija 1 decía previous-tag y lo he cambiado.
  2. Producción se lanza con workflow_dispatch sobre la etiqueta, con el approval_id (Clarify 4 de la spec 003): gh workflow run deploy.yml --ref <etiqueta> -f environment=production -f approval_id=<id>. Staging puede desplegar en cada push a su rama.
  3. Cómo se cierra cada despliegue: un rollback que pasa la salud se cierra como rolled_back, y uno que no la pasa, como failure. Si el hilo de Core lo entiende de otra forma, se cambia en una línea.
  4. Al contrato que se envía a Core le quito los nombres de los secretos. Así la regla del 422 de la tabla contracts no lo rechaza.
  5. La web estática sube con Direct Upload, mediante wrangler 4.151.0 (versión fija, del 14 de octubre). El proyecto de Pages no debe desplegar producción por su cuenta desde Git.
    • Dependencia nueva: wrangler, la CLI oficial de Cloudflare, que ya es proveedor nuestro.
    • Alternativa nativa descartada: el deploy hook de Pages, porque construye la cabeza de la rama y no el commit aprobado.

Cómo probarlo en 2 minutos

  1. Comprueba que el check test está en verde: son 74 pruebas con Core, Ploi y los sitios simulados.
  2. Lee la cabecera de deploy-laravel.yml: es la llamada que copiará cada repositorio.

Criterios de aceptación

  • Hay tres workflows (deploy-laravel, deploy-wordpress y deploy-static), junto a los ci-*.
  • Cada uno lee el contrato, llama a deploy-start con el approval_id, se detiene si Core no confirma, despliega y llama a deploy-finish con el resultado.
  • El servidor y la clave llegan como secretos del entorno del repositorio que llama, y nada de eso queda escrito en estos archivos (DEV-02.2, DEV-07).
  • El README.md explica cómo llamarlos.
  • Un despliegue aprobado y otro rechazado: se prueban en las hijas 3 y 5, cuando Core tenga deploy-start.

Riesgos

  • Hasta que Core tenga deploy-start: un repositorio que llame a estos workflows no despliega, porque se para en ese paso. Hoy no los llama ninguno.
  • Se llaman desde @main: un fallo aquí afecta a todos los repositorios a la vez (es un riesgo de la épica). Por eso el script lleva pruebas y el check test.
  • La salud con expect: status (WordPress): solo prueba que el sitio responde, no que el código nuevo esté puesto. rasgo-wp-base (hija 4) puede servir un /version.json.
  • CI propio: este repositorio no tenía y test es el primero. Si quieres que sea obligatorio, hay que añadirlo a su ruleset, y eso lo haces tú.

Orden de merge

  1. Esta PR.
  2. La PR del manual que cambia WPR-08 (rasgo-knowledge, rama os/WPR-08-ploi-deploy).

Capturas

No aplica.

Tiempo

  • Estimado: 4 h (hija 2).
  • Usado: 2,5 h.

Generated by Claude Code

deploy-laravel.yml (laravel-ploi and monorepo-ploi), deploy-wordpress.yml
(Ploi deploy webhook, chosen by Sergio on 4 Nov) and deploy-static.yml
(Cloudflare Pages, Direct Upload) follow one order: contract, secrets,
deploy-start in Core, deploy, health and deploy-finish. Production only
deploys with an approval_id that Core confirms; without Core nothing deploys.
The Ploi workflows stop when the branch the site pulls is not at the commit
of the run. The steps live in actions/deploy-core with 74 tests, run by the
new test workflow with ShellCheck.

OS-Ref: WFA-01.1
Refs: RINF-54
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Fk5Z87VM8EWrxKi79DrFju
@sergio-cortinas
sergio-cortinas merged commit 0897eea into main Nov 4, 2026
1 check passed
@sergio-cortinas
sergio-cortinas deleted the RINF-54-deploy-workflows branch November 9, 2026 09:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants