Adds Gitea Actions CI/CD for test and production
The pipeline runs lint, format, tests, build, dependency audit and Lighthouse (mobile and desktop, Playwright Chromium on the arm64 runner) on every pull request, push to master and manual run. Pushes to master deploy to test automatically, and any branch can be deployed to test manually. Test is a Raspberry Pi with nginx next to the current WordPress site; the deploy refuses folders containing WordPress. Production deploys are manual and only from release/* branches, over FTP with TLS to the IIS webhost. The IIS web.config and both nginx configs are generated from the same security header list as the Vite servers, with a test that fails when the generated files drift. Adds .gitattributes for LF line endings and pins pnpm through packageManager. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
+89
@@ -0,0 +1,89 @@
|
||||
# Deployment Clarification Questions — frontend-shell
|
||||
|
||||
Je antwoorden in [deployment-setup-plan.md](deployment-setup-plan.md) brengen een paar keuzes boven die ik niet zelf kan maken. Vul per vraag de letter in na `[Answer]:`.
|
||||
|
||||
Wat ik van de hoster weet ([pakketpagina](https://www.mijnhostingpartner.nl/pg/info/aspnet-core-hosting/)): Windows-hosting met **URL Rewrite**, dus IIS. Security headers en de SPA-fallback gaan daar via een `web.config` naast `index.html`. Over FTP/SFTP/SSH staat niets op de pagina.
|
||||
|
||||
---
|
||||
|
||||
## Vraag 1: Branchstrategie
|
||||
|
||||
Je vroeg om advies over gitflow tegenover trunk-based.
|
||||
|
||||
**Gitflow**: `develop` voor lopend werk, `release/x.y`-branches voor een release, en daarna terugmergen naar `develop` én `master`, met een tag. Bedacht voor teams die meerdere versies tegelijk onderhouden of op vaste momenten releasen. Voor één ontwikkelaar levert het vooral extra merges op, en kans op merge-conflicten tussen `develop` en `master`.
|
||||
|
||||
**Trunk-based (lichte variant)**: `master` is altijd releasebaar. Werk gebeurt in korte feature-branches die via een pull request naar `master` gaan, zoals je nu al doet. Een release is een **tag** op `master` (bv. `v1.2.0`).
|
||||
|
||||
Mijn advies voor jouw situatie (één ontwikkelaar, een test- en een productieomgeving) is **trunk-based met release-tags**. Het past bij hoe je nu werkt, en alles wat je met gitflow wilde blijft mogelijk:
|
||||
|
||||
| Jouw wens | Trunk-based met tags |
|
||||
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Altijd en snel naar test, ook een specifieke versie | Handmatige "Deploy naar test" in Gitea met keuze van branch, commit of tag. Daarnaast automatisch bij elke merge naar `master`. |
|
||||
| Productie alleen vanuit een release | Productie alleen vanaf een tag `v*`, handmatig gestart in Gitea |
|
||||
| Een vaste versie kunnen terugzetten | Elke tag is een vaste versie; terugzetten is die tag opnieuw deployen |
|
||||
|
||||
A) Trunk-based met release-tags **(aanbevolen)**
|
||||
B) Gitflow zoals je beschreef: `develop`, `release/*`, `master` met tags. Productie alleen vanaf `release/*`.
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: x, ik wil een mix welke volgens mij nog steeds dichter bij trunk-based ligt. Ik wil release en feature branches om het werk nog wel geisoleerd te houden. Mocht het helemaal kapot gaan kan je de branch weggooien en zo kan ik nog steeds PR's gebruiken als jij dingen oppakt. Dan kan ik makkelijker de PR checken voor de veranderingen en bij mergen van de PR kan een test-release gedaan worden. Maar ik wil dan de develop branch er tussenuit halen. Ik ben volgens mij vergeten aan te geven dat na het succesvol mergen van een PR een workflow moet worden gestart met een deploy naar test als automatische deploy. Een deploy naar test moet ook handmatig kunnen om op test te kunnen deployen om iets te testen voordat de PR wordt gemerged.
|
||||
|
||||
## Vraag 2: Wanneer gaat de nieuwe site live?
|
||||
|
||||
De eerste deployment naar productie vervangt wat er nu op `andreaslop.nl` staat. De nieuwe site heeft nog alleen placeholderpagina's ("in de maak").
|
||||
|
||||
A) De productie-pipeline nu bouwen en testen, maar de eerste echte productie-deployment pas starten als de pagina's inhoud hebben. Tot die tijd alleen de testomgeving. **(aanbevolen)** Door de handmatige start kan het niet per ongeluk gebeuren.
|
||||
B) Zodra de pipeline werkt live gaan, ook met placeholders
|
||||
C) De huidige site staat ergens anders; productie op deze hoster is nog leeg
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: A, mogelijk kan het eerder worden gedeployed, maar dat kan ook handmatig gestart worden. De huidige site staat op een andere host dus als ik de DNS daar nog naar toe verwijs zou het geen impact moeten hebben.
|
||||
|
||||
## Vraag 3: Hoe komen de bestanden bij de productiehoster?
|
||||
|
||||
Kijk in het hostingpaneel welke toegang je hebt.
|
||||
|
||||
A) SFTP **(aanbevolen als beschikbaar)** Versleuteld en eenvoudig vanuit de pipeline.
|
||||
B) Alleen FTP met TLS (FTPS)
|
||||
C) Alleen gewone FTP (onversleuteld). Werkt, maar dan gaat het wachtwoord onversleuteld over het internet; liever niet.
|
||||
D) Web Deploy (msdeploy), als de hoster dat aanbiedt
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: B, Meer info op: https://www.mijnhostingpartner.nl/client/knowledgebase/ftp/ftp-verbinding-opzetten/
|
||||
|
||||
## Vraag 4: Wat draait er op je testserver?
|
||||
|
||||
De testomgeving moet zich zoveel mogelijk als productie gedragen (headers, SPA-fallback).
|
||||
|
||||
A) Windows met IIS, net als productie. Dan gebruik ik dezelfde `web.config` en dezelfde deploymethode.
|
||||
B) Linux met een webserver (nginx, Apache of Caddy), bereikbaar via SSH. Dan stel ik een gelijkwaardige config op, en deploy ik via SSH/rsync.
|
||||
C) Linux, maar alleen via SFTP bereikbaar
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: B, maar dan een raspberry pi server met Nginx die weer achter een andere Raspberry pi zit die als reverse proxy is ingesteld.
|
||||
|
||||
## Vraag 5: Chrome voor Lighthouse in de pipeline
|
||||
|
||||
Je runner draait de jobs waarschijnlijk in **Docker-containers**; dat is de standaard bij `act_runner`. Een Chrome die op de server zelf staat, is dan in de container niet zichtbaar.
|
||||
|
||||
A) De pipeline installeert zelf Chromium in de job (één regel, vaste versie uit de Debian-repository). Werkt ongeacht wat er op de server staat. **(aanbevolen)**
|
||||
B) De runner draait jobs direct op de server (host-modus), en dan gebruik ik de Chrome die daar staat
|
||||
C) Weet ik niet. Ik zoek de runner-labels op in Gitea (Site Administration of Settings → Actions → Runners) en vul ze hieronder in.
|
||||
X) Anders (beschrijf hieronder na de [Answer]:-tag)
|
||||
|
||||
[Answer]: Ik denk B, De runner is `raspberry-pi-arm64` met versie v2.1.0, is een Global runner met de labels linux-arm64 en ubuntu-latest. Kijk in `K:\Development\SlpSoftware\Projects\SlpSoftware` en `K:\Development\Projects\SlpModularCms` hoe het dara gedaan is. Dat draait er nu ook, maar bedenk dat die wel volledig op de eigen server draaien dus nmiet alles klakkeloos overnemen.
|
||||
|
||||
---
|
||||
|
||||
## Ter info: databasemigraties en terugdraaien (je vraag bij Vraag 8)
|
||||
|
||||
Dit speelt pas als de API er is, maar het antwoord bepaalt nu al de aanpak:
|
||||
|
||||
- **Migraties via de pipeline kunnen.** Met Entity Framework Core maak je bij het bouwen een migratiescript of "migration bundle". De pipeline voert dat uit vóór de nieuwe API live gaat.
|
||||
- **Databasemigraties terugdraaien is riskant.** Een "down"-migratie kan data weggooien, bijvoorbeeld bij een verwijderde kolom. Gangbaar is daarom:
|
||||
- **Achterwaarts compatibele migraties** (expand/contract). Een kolom hernoemen gaat in twee releases: eerst de nieuwe kolom erbij, en pas later de oude weg. De vorige versie van de API werkt dan nog met de nieuwe database.
|
||||
- **Terugdraaien** = de vorige versie van de code deployen, met de database zoals die is (jouw keuze B).
|
||||
- **Echte fouten in data of schema** los je op met een nieuwe migratie vooruit ("roll forward"), niet door terug te draaien.
|
||||
- **Kleine database (50 MB)**: maak vóór elke productiemigratie een back-up of export; de pipeline kan dat aanroepen.
|
||||
|
||||
Dit neem ik op in het rollback-plan als richtlijn voor de API-feature. Voor de huidige statische site is terugdraaien simpelweg de vorige tag opnieuw deployen.
|
||||
Reference in New Issue
Block a user