Skip to content

RINF-54 Salud por commit y deploy-finish alineado con Core - #6

Merged
sergio-cortinas merged 3 commits into
mainfrom
RINF-54-health-commit
Nov 4, 2026
Merged

sergio-cortinas merged 3 commits into
mainfrom
RINF-54-health-commit

Conversation

@sergio-cortinas

@sergio-cortinas sergio-cortinas commented Nov 4, 2026 •

Copy link
Copy Markdown
Contributor

Resumen para Sergio

Esta PR trae dos arreglos pequeños que la hija 3 de RINF-54 necesita antes de llevar rasgo-core a los workflows de despliegue.

  1. Salud. Con la versión fusionada en RINF-54 Workflows de despliegue con la aprobación de Core: Laravel, WordPress y estático #5, la comprobación de salud daba por buena la release anterior si tenía el mismo número de versión. Ahora, si la respuesta trae un campo commit, como los version.json, solo cuenta ese commit.
  2. deploy-finish y deploy-start. Ahora se ajustan al código real de Core, rasgo-core#74 y #75:
    • deploy-finish: un 409 (Core ya lo había cerrado, por ejemplo cuando llega un reintento) avisa sin fallar, y un 404 dice que el despliegue no ha quedado registrado.
    • deploy-start: un 422 enseña el motivo de Core. Core lo da, por ejemplo, si el contrato lleva una clave con forma de secreto (PLN-11).

Comprobé el resto del contrato contra el DeploymentController de #74 y #75 y coincide: campos, 201 con deployment_id, 403 con reason y rule, y un contract sin claves de secreto, que Core guarda.

Tarea

  • Plane: RINF-54, preparación de la hija 3 (rasgo-core).
  • Spec: light, en la descripción de RINF-54.

Qué cambia

  • actions/deploy-core/core.sh: si la respuesta de salud es un JSON con commit, el despliegue está sano solo cuando ese commit es el de la ejecución, completo o con un prefijo de 7 caracteres o más. Si la respuesta no trae commit, se comprueba como hasta ahora: el commit o el número de versión.
  • core.sh, deploy-finish: el 409 avisa y deja el run como estaba; el 404 falla y lo dice. deploy-start: el 422 falla con el motivo de Core.
  • Diez pruebas nuevas, con 84 en total; una comprueba que el contrato enviado no lleva claves que Core rechace. Comprobé que dan rojo con el core.sh de antes de cada arreglo.
  • README, paso 5 «Health»: la regla nueva.

Por qué hace falta

rasgo-core registra en Core la versión de la API, pero su salud se mira en un host estático, que sirve /version.json con el commit. La API no lo trae: GET /version solo da la versión. Si la web de la release anterior tuviera el mismo número que la API nueva (por ejemplo, las dos en 1.0.0), el paso de salud acabaría en verde sin que la release nueva estuviera viva.

Cómo probarlo en 2 minutos

  1. Comprueba que el check test está en verde.
  2. Lee la prueba «health: the same version from another commit is the old release» en tests/deploy-core.test.sh.

Criterios de aceptación

  • Un version.json con otro commit no pasa la salud aunque tenga la misma versión.
  • Con el campo commit, cuenta el commit completo o un prefijo de 7 caracteres o más.
  • Una respuesta sin commit se comprueba como antes.
  • deploy-finish: un 409 no tumba el run y un 404 se explica.
  • deploy-start: un 422 se explica, y el contrato va sin claves con forma de secreto.
  • ShellCheck y las 84 pruebas, en verde.

Riesgos

  • Ninguno para los repositorios actuales: todavía nadie llama a estos workflows.

Capturas

No aplica.

Tiempo

  • Estimado: 1 h, dentro de la hija 3.
  • Usado: 0,75 h.

https://claude.ai/code/session_01Fk5Z87VM8EWrxKi79DrFju


Generated by Claude Code

…mmit

The health step accepted the version number as proof, so the release before
could pass when it carried the same number: rasgo-core records the API
version and checks a static host, whose version.json has another app's
version. A JSON answer with a commit field now counts only by that commit
(full, or a prefix of at least 7 characters).

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
Core answers deploy-finish with 409 when the deploy is no longer started,
as when a retry arrives after it closed it, and with 404 when it does not
know the deployment_id (rasgo-core#74). A 409 now warns and leaves the run
as it was; a 404 says the deploy was not recorded.

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 changed the title RINF-54 La salud del despliegue comprueba el commit cuando version.json lo trae RINF-54 Salud por commit y deploy-finish alineado con Core Nov 4, 2026
Core validates deploy-start and rejects a contract with any key that looks
like a secret with 422 (rasgo-core#75, PLN-11). The step now shows Core's
reason, and a test checks that the contract sent to Core has no such key.

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 798d93e into main Nov 4, 2026
1 check passed
@sergio-cortinas
sergio-cortinas deleted the RINF-54-health-commit 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