The check after a deploy compared the server's answer with dist byte for byte, which fails once the host writes current data into the markers. Both sides are now normalised first (regions, data block, offers, inline prices, site address); everything else still has to match. The stand-in host no longer injects the 404 page, like the real one. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
6.6 KiB
Deploy and CI
Pipeline: .gitea/workflows/continuous_integration.yaml. Branch strategy and rollback are in aidlc-docs/features/frontend-shell/operations/deployment/ and aidlc-docs/features/prerendering/.
Triggers
| Trigger | Result |
|---|---|
| Pull request | Checks only, no deploy. |
Push to master |
Checks, then deploy to test. |
Every night, 03:15 UTC (schedule) |
Test build with the packages and banners from the test CMS, deploy to test, no Lighthouse. Gitea runs schedules only from the default branch, so this works after the packages feature is merged to master. Never production. |
Manual (workflow_dispatch), any branch |
Checks, and a deploy to test if deploy_test is on. |
Manual from a release/* branch |
Deploy to production if deploy_production is on. |
Workflow inputs
deploy_test(boolean, default false): "Deploy to Test". Builds the test artifact and deploys it to ASF test.deploy_production(boolean, default false): "Deploy to Production". Only works from arelease/*branch and only with Bryan's explicit go.
Dispatch from the CLI (the token comes from your git credentials, never print it): POST /api/v1/repos/SLP_Software/AndreaSlopFotografie/actions/workflows/continuous_integration.yaml/dispatches with {"ref": "<branch>", "inputs": {"deploy_test": "true"}}.
Jobs
check: lint, format, unit/property/axe tests (coverage threshold 100% onsrc/lib/**), build withoutOFFERINGS_URL(so with the committed snapshot), audit. Uploads artifactdist(this is what production gets).build-test: builds again withOFFERINGS_URL=${{ vars.ASF_OFFERINGS_URL_TEST }}(packages and banners from the test CMS) andVITE_SITE_URL=https://test.andreaslop.nl(see "Own address of the test site") and uploadsdist-test.deploy-test: needscheckandbuild-test, downloadsdist-test, uploads to the ASF test host and runs the deployment check (served by the CMS host, admin files, POST status).lighthouse: against the built site with the preview stub (--audit-route --contact-stub); skipped onschedule.deploy-production: manual, fromrelease/*only, uses artifactdist.
There is one Raspberry Pi runner plus a desktop runner, so jobs can wait in the queue for a long time (for example 30 minutes before build-test); a deploy that only just started is not hung. Check started_at (UTC) before cancelling anything.
Deploying a feature branch to test
Committing, pushing and deploying a feature branch to test is allowed for the sessions that work on it. Merging, deploying to production and changing repo variables are not (Bryan decides). After a test deploy, check the page in a real browser against the real test CMS; web/e2e/ holds the checks that run in CI.
TEST ONLY commit (must go before the merge)
feature/contact-form-cms carries commit d449e76 "TEST ONLY: enable the contact form for the ASF test deploy", which sets contactForm.enabled: true in web/src/content/siteContent.ts so the ASF test host shows the real form. It must not reach master (the form stays off in production until Bryan gives an explicit go). Before merging, revert it (git revert d449e76, or drop it from the branch) and confirm enabled is false again. The packages branch is based on the contact-form branch, so the merge order is contact-form-cms first, then asf-packages-cms. Both merges need Bryan's go.
The check after a deploy and the host injection
deploy/verify-deployment.sh compares what the server sends with the files in dist. Once the CMS host injects (packages, banners, prices, JSON-LD price, site address), the pages differ from dist by design, so both sides are first normalised with config/normalizeInjected.ts (the contents of the CMS regions, the data block, offers in structured data, inline prices and the site address are taken out). Everything else must still be equal byte for byte, so an old build or a wrong server config is still caught; the 404 page is not injected and is compared as it is. The preview server can stand in for the host (node config/previewServer.ts --cms-data=<json>), which is how the script is tried locally.
Own address of the test site
The test site stands on its own: in the test build VITE_SITE_URL is https://test.andreaslop.nl, so canonical, og:url, og:image, the JSON-LD ids and urls and sitemap.xml all point to the test host. A link shared from the test site (WhatsApp, Discord) therefore shows its own picture, not one from production. The production artifact (job check) is built without the variable and keeps https://andreaslop.nl. src/lib/siteUrl.ts only accepts an origin (https, or http on localhost); anything else falls back to production, so a typo cannot move production to another domain. This is a build setting, not TEST ONLY code: nothing has to be reverted before a merge. robots.txt on the test host is the nginx one (Disallow: /, plus X-Robots-Tag: noindex), not public/robots.txt, so the test site stays out of search engines. To try it locally: VITE_SITE_URL=http://localhost:4173 pnpm build.
Generated files
web/deploy/iis/web.config and web/deploy/nginx/*.conf are generated by pnpm server-config from web/config/serverConfig.ts. Change the generator, rerun it and commit the result; a test checks that they match.