Shared release gate, verify and notify actions for scheduled release and automatic promote to prod
  • Python 54.6%
  • Shell 43.2%
  • Awk 1.9%
  • Dockerfile 0.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Robin Wieske c243efb9a8
All checks were successful
Test release-gate / pytest (push) Successful in 15s
Test shell actions / test (push) Successful in 1m12s
Merge pull request 'feat(env-diff): find the draft release itself' (#17) from feat/env-diff-find-draft into main
Reviewed-on: #17
2026-11-13 17:12:16 +01:00
.github/workflows chore(deps): Update Node.js to dc26ae9 2026-11-11 21:40:25 +00:00
docs docs: bring README and plan up to date with the rollout 2026-11-11 13:26:20 +01:00
env-diff feat(env-diff): find the draft release itself 2026-11-13 16:53:13 +01:00
notify feat: env-diff, verify-deploy and notify actions 2026-11-10 22:49:16 +01:00
release-gate Merge pull request 'chore(deps): Update dependency pytest to v9.2.0' (#12) from renovate/pytest-9.x into main 2026-11-11 14:38:47 +01:00
tests feat(env-diff): find the draft release itself 2026-11-13 16:53:13 +01:00
verify-deploy feat: env-diff, verify-deploy and notify actions 2026-11-10 22:49:16 +01:00
README.md docs: bring README and plan up to date with the rollout 2026-11-11 13:26:20 +01:00
renovate.json chore: set up Renovate 2026-11-11 14:03:19 +01:00

laravel-deploy-actions

Shared actions for scheduled releases and automatic promote to prod across the Laravel repos (and kima/kima).

  • docs/plan.md: the plan and the contract every repo implements. Source of truth.
  • docs/predeploy-backup.md: backup block for the Ploi deploy scripts.
  • Tracking issue: the pinned "Rollout: scheduled release and automatic promote" issue in this repo.

Actions

  • release-gate (Docker, Python): decides whether to publish the draft (mode: release), which tag to promote (mode: promote), and re-checks inside deploy_prod (mode: recheck).
  • env-diff: "Environment changes" section in the draft release body.
  • verify-deploy: polls <url>/version until it reports the expected tag.
  • notify: posts an event to the n8n "Deploy notify" webhook.

Use them with the full URL and pin them by commit SHA (Renovate bumps the digest):

- uses: https://forgejo.entwirr.me/Wi3eDigital/laravel-deploy-actions/release-gate@<sha>

Consumers

Repo Release (UTC) Promote (UTC)
Aevana/aevana Wed, Sat 06:00 Mon to Thu 07:05
slight-exposure/slight-exposure Wed, Sat 06:10 Mon to Thu 07:25
kima/portal Wed, Sat 06:20 Mon to Thu 07:35
Kardeema/kardeema Wed, Sat 06:30 none (no prod yet)
Wi3eDigital/homepage Wed, Sat 06:40 none (release goes straight to prod)
kima/kima Wed, Sat 06:50 Mon to Thu 07:45

Switches

Variable Level Values Effect
DEPLOYS_ENABLED repo true / anything else Hard off switch: deploy jobs only run when true.
AUTO_RELEASE repo off, dry-run, on Scheduled publishing.
AUTO_PROMOTE repo off, dry-run, on Scheduled promote to prod.
AUTOMATION_PAUSED org true / anything else true stops every scheduled release and promote in the org.

Enable a repo in this order: DEPLOYS_ENABLED=true, AUTO_RELEASE=dry-run, then AUTO_PROMOTE=dry-run once prod /version serves a tag. Switch to on after 1 to 2 clean weeks.

Tests

  • Shell actions: bash tests/run.sh (needs bash, git, jq, curl, python3), shellcheck -x */*.sh.
  • release-gate: pip install -r release-gate/requirements-dev.txt, then python -m pytest release-gate/tests.