publish-asf-production: self-contained win-x64, web.config-sjabloon, artefactcontrole, artefact 30 dagen. deploy-asf-production: drie sloten (dispatch-input, release/*, ASF_PROD_DEPLOY_ENABLED), expliciete FTPS, app_offline.htm, geen delete behalve wwwroot/admin, nooit appsettings.Production.json/uploads/logs/wwwroot/web. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
9.7 KiB
ASF productie op IIS: bouwen, uploaden, eerste uitrol, terugdraaien
Status: de pijplijn is gebouwd maar staat uit. Er is niets naar productie gezet; dat gebeurt alleen met Bryans expliciete go. Voor wie: Bryan (eerste uitrol) en wie de pijplijn beheert. De configuratiesleutels, de web.config en de database staan in aidlc-docs/features/andreaslop-site-hosting/asf-iis-production-config.md; dit document gaat over de uitrol zelf.
1. Wat er is
| Onderdeel | Waar | Doet |
|---|---|---|
Job publish-asf-production |
.gitea/workflows/continuous_integration.yaml |
Bouwt de ASF-host self-contained voor win-x64 (de runtime zit erbij; alleen de IIS-module uit de Hosting Bundle is op de server nodig), met de admin-frontend (ASF-thema, Nederlands) en het web.config-sjabloon. Bewaart het resultaat 30 dagen als pijplijnartefact app-asf-production-win-x64. |
deploy/asf-iis/web.config |
repo | Het sjabloon: handler inprocess, stdout-log aan voor de eerste start, uploadlimiet 30 MB, requestFiltering (configbestanden en programmabestanden nooit rechtstreeks downloadbaar), ASPNETCORE_ENVIRONMENT=Production, de hosterstandaard. Geen instellingen, geen geheimen. |
scripts/check-asf-publish.sh |
repo | Controle van het artefact; laat de job falen als er appsettings.Production.json, uploads/, logs/, wwwroot/web, andere appsettings.*.json, sleutel- of certificaatbestanden in zitten, of als het sjabloon-web.config, het win-x64-Magick-bestand of de admin ontbreekt, of als de web.config iets geheimachtigs bevat. |
Job deploy-asf-production |
idem | Uploadt het artefact via FTPS met scripts/deploy-asf-iis-ftps.sh. Standaard uit (zie 2). |
scripts/deploy-asf-iis-ftps.sh |
repo | De upload: expliciete FTPS (AUTH TLS), TLS afgedwongen voor besturing en data, certificaat gecontroleerd, passief, wachtwoord alleen via LFTP_PASSWORD; dezelfde stijl als de website-upload van het ASF-project. |
Een push naar master of een pull request bouwt of uploadt hier nooit iets.
2. Wanneer de upload draait (drie sloten)
deploy-asf-production draait alleen als alle drie gelden:
- een handmatige run (
workflow_dispatch) metdeploy_asf_productionaangevinkt; - die run staat op een branch
release/*; - de Gitea-variabele
ASF_PROD_DEPLOY_ENABLEDistrue(standaard niet aanwezig; pas zetten op Bryans go en na afloop weer weghalen).
Alleen bouwen (zonder upload): dispatch met build_asf_production aangevinkt, op elke branch. Zo is de zip te controleren zonder dat er iets naar een server gaat.
Instellingen (de variabelen en secrets bestaan al in de CMS-repo; het hosterpad staat nu nog op een plaatshouder):
| Naam | Soort | Betekenis |
|---|---|---|
ASF_PROD_HOST_ADDRESS, ASF_PROD_HOST_PORT (optioneel), ASF_PROD_HOST_USERNAME, ASF_PROD_HOST_PASSWORD |
secrets | FTPS-account van de hoster. |
ASF_PROD_DEPLOY_PATH |
variabele | De hostmap (de map met de .exe, de web.config en de wwwroot), relatief aan de FTP-thuismap. Alleen A-Za-z0-9._/-. Niet wwwroot/web. Nu wwwroot als plaatshouder: leg dit met Bryan vast zodra het echte hosterpad bekend is. Is de IIS-sitemap de wwwroot van het account, dan wordt de website-map <account>/wwwroot/wwwroot/web; leg dat bij de eerste uitrol vast. |
ASF_PROD_HEALTH_URL |
variabele | https://andreaslop.nl/health (health-check na de upload). |
ASF_PROD_SENTRY_DSN |
variabele (optioneel) | DSN voor de admin-frontend. |
ASF_PROD_DEPLOY_ENABLED |
variabele | Het derde slot, zie boven. |
3. Wat de upload doet en nooit doet
Volgorde (scripts/deploy-asf-iis-ftps.sh):
- Verbinding en doelmap controleren.
app_offline.htmuploaden: IIS zet de app stil en geeft de DLL's vrij; vijf seconden wachten.- Map voor map uploaden (één lftp-sessie per stap, stoppen bij een fout). Alleen
wwwroot/adminwordt opgeruimd (verwijderen van bestanden die niet meer in de release zitten); nergens anders--delete. - De bestanden in de root, de
web.configals laatste. app_offline.htmverwijderen: de app start (op de eerste uitrol maakt de eerste start de database-tabellen, zie 5).- Health-check (tot ongeveer twee minuten, voor de eerste start).
Nooit aangeraakt of geüpload: appsettings.Production.json (alleen op de server, door Bryan), uploads/ (de mediamap), logs/ (stdout-log) en wwwroot/web (de prerendered website; die uploadt het ASF-project zelf met --delete binnen die map). Het script weigert te lopen als de doelmap wwwroot/web is of als het artefact een van die dingen bevat.
Faalt de upload halverwege, dan blijft app_offline.htm staan: bezoekers krijgen de onderhoudspagina in plaats van een half bijgewerkte app. Los het op en draai de upload opnieuw (hij is herhaalbaar), of draai terug (zie 6).
Lokaal proberen zonder iets te wijzigen: DRY_RUN=1 scripts/deploy-asf-iis-ftps.sh <map> toont wat er zou worden geüpload (met dezelfde variabelen als in de job; lftp moet geïnstalleerd zijn).
4. Samenwerking met de website-upload van het ASF-project
Het ASF-project uploadt de prerendered website (inclusief redirects.json) met FTPS naar <hostmap>/wwwroot/web, in drie rondes met een eigen --delete alleen in die map. Afspraken:
- De host-upload sluit
wwwroot/webuit; de website-upload raakt niets buitenwwwroot/webaan en zet er zelf geenweb.configneer. - Nooit tegelijk draaien: op dezelfde FTP-account en in dezelfde mapstructuur. Eerst de host, dan de website.
- Een host-release hoeft de website niet opnieuw te uploaden, en andersom ook niet.
- Beide gebruiken dezelfde FTPS-instellingen (zie het script); de host voegt
net:timeout 30ennet:reconnect-interval-base 5toe, de website-upload heeft die niet nodig.
5. De eerste uitrol op een lege database
Alleen na Bryans go. Vooraf, door Bryan:
- Back-up van de WordPress-site en de database
andreaslop(WordPress mag daarna weg; de database blijft ongemoeid). - De oude WordPress-bestanden uit de hostmap halen (
index.php,wp-*, de oudeweb.configmet rewrite-regels), behalve de nieuwe mapuploads. Een oude WordPress-web.configzou botsen met de nieuwe. - In de hostmap een map
logsmaken (schrijfrechten voor de application pool-identiteit); schrijfrechten vooruploadszetten. appsettings.Production.jsonmet de hand naast de plek van de.exezetten, volgens sectie 3 van de configuratiedoc (databasegegevens, JWT-sleutel, setup-token, mail,Media:Directory, Sentry).Website:NoIndexblijfttrue.- In Gitea de variabelen controleren (
ASF_PROD_DEPLOY_PATHis nu het echte hosterpad; test eerstDRY_RUN=1), enASF_PROD_DEPLOY_ENABLED=truezetten.
De uitrol:
- Release-branch
release/...vanmaster, dispatch metdeploy_asf_productionaangevinkt. - De pijplijn bouwt, controleert en uploadt (sectie 3). De eerste start maakt alle tabellen (migraties van Core, Identity, Availability, Offerings, Hero, Media, Contact) op de lege MariaDB. Controleer het stdout-log (
logs/stdout_*.log) op fouten ("Fout bij het activeren van module"), opImage library Magick.NET self-test passeden op de Hero-melding; controleer daarna/api/v1/System/capabilities. - Open
https://andreaslop.nl/admin: de setuppagina vraagt het setup-token en maakt de eerste beheerder aan. - Haal daarna
Identity:Setup:Tokenuitappsettings.Production.json(herlaad of recycle de pool). - Test de mediamap: een foto uploaden, controleren dat er een bestand in
uploadsstaat en dat de map niet via de browser bereikbaar is (zie 1e van de configuratiedoc). - De website-upload van het ASF-project naar
<hostmap>/wwwroot/weblaten draaien; controleer de homepage,/sitemap.xmlen dat/redirects.jsoneen 404 geeft. - Pas op het release-moment, na Bryans go:
Website:NoIndexnaarfalse, en pas dan de domeinwissel/DNS. HaalASF_PROD_DEPLOY_ENABLEDweer weg.
Het stdout-log uit: na de eerste succesvolle start (stap 2 en 3 zijn gelukt) zet Bryan in de web.config op de server stdoutLogEnabled="false". Anders groeien de bestanden in logs/ onbeperkt. Let op: een volgende deploy zet de web.config uit het sjabloon terug en dus stdoutLogEnabled weer op true. Zet het sjabloon daarom na de eerste uitrol in een aparte, kleine PR op false; tot die PR er is, zet Bryan het na elke deploy handmatig uit.
6. Terugdraaien
- De vorige release is het artefact
app-asf-production-win-x64van de vorige run (30 dagen bewaard in Gitea). Elke run bewaart zijn eigen artefact; noteer bij elke uitrol welke run live staat. - Terugzetten:
app_offline.htmuploaden (of de upload-job draaien met het oude artefact), de oude release uploaden met hetzelfde script (scripts/deploy-asf-iis-ftps.sh <uitgepakte map>met de FTPS-variabelen uit de job), daarnaapp_offline.htmverwijderen. Het script doet dit hele traject; je hoeft alleen het oude artefact te downloaden en uit te pakken. - Database: de host draait migraties vooruit en niet terug. Voor een release met een migratie die iets verwijdert is vooraf een database-back-up (herstelpunt) verplicht; zie
production-rollout.mdvan de mediabibliotheek. Een code-rollback van een release zonder migratie vraagt niets van de database. - Wat een rollback niet raakt:
appsettings.Production.json,uploads/,logs/enwwwroot/web.
7. Open punten voor Bryan en SLS
- Het echte hosterpad voor
ASF_PROD_DEPLOY_PATH(en daarmee of de website-mapwwwroot/wwwroot/webwordt). - Heeft het FTP-account schrijfrechten in de hostmap voor
app_offline.htm? Faalt de eerste proefupload hier, meld het. - Is
lftpop de Gitea-runner aanwezig (of mag de job het installeren)? De job probeertapt-get; anders de runner-image aanpassen. - Wat doet de hoster al aan HTTP naar HTTPS en www naar apex (zie 2a van de configuratiedoc)?