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%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| .github/workflows | ||
| docs | ||
| env-diff | ||
| notify | ||
| release-gate | ||
| tests | ||
| verify-deploy | ||
| README.md | ||
| renovate.json | ||
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 insidedeploy_prod(mode: recheck). - env-diff: "Environment changes" section in the draft release body.
- verify-deploy: polls
<url>/versionuntil 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, thenpython -m pytest release-gate/tests.