22 KiB
Plan: ASF in productie op IIS en de productiepipeline
Status (2026-11-18): alleen een plan. Niets uitgevoerd, niets naar productie, geen release-branch, geen workflow-bestand gewijzigd. Opgesteld door SLP Software - SLS - Main omdat de ASF-sessie offline was en Bryan niet bij de computer; de ASF-sessie kan hierop doorbouwen. Alles wat onbekend is staat als aanname, te controleren (A1, A2, ...), de vragen voor Bryan staan onderaan (V1, V2, ...).
Uitgangspunten (Bryan): de pipeline-fix gebeurt in een feature-branch (feature/asf-production-iis), nooit in een release-branch tenzij Bryan dat vraagt. Productie alleen op zijn expliciete go. De CMS-host is het enige ingangspunt van de website (besluit 2026-11-15, docs/cms-integration.md, "Hosting").
1. Wat er nu staat (met bewijs)
| Onderdeel | Stand | Bewijs |
|---|---|---|
| ASF-test | Werkt: master-push bouwt dist-test, uploadt naar de Pi (scp), controleert na deploy. De CMS-host op de Pi bedient site, /admin en /api/v1. |
Laatste runs 782 t/m 789 op master/dispatch zijn groen. Run 761 faalde één keer op lighthouse (performance op de Pi, daarna groen). |
| ASF-productie (ASF-repo) | Job deploy-production bestaat: handmatig, alleen vanaf release/*, upload van dist met FTPS (web/deploy/upload-production.sh) en een gegenereerde web/deploy/iis/web.config die zelf statische bestanden serveert. |
.gitea/workflows/continuous_integration.yaml (job deploy-production), web/deploy/iis/web.config (rewrite naar {R:1}.html, 404.html, geen doorgeven aan de host). |
| Strijdig met het besluit | Dat ontwerp is van vóór 2026-11-15: de host moet álle verzoeken krijgen (pagina's, /admin, /api/v1), IIS doet alleen redirects en pass-through. Zonder dat toont productie de ingebakken snapshot en geeft elke pageview een 404 voor de API. |
docs/cms-integration.md ("Production: not in place yet"), docs/go-live-checklist.md ("Packages and banners"). |
| Geheimen/variabelen | Aanwezig: secrets PI_MAIN_*; variabelen DEPLOY_PATH_TEST, HEALTH_CHECK_URL_TEST, HEALTH_CHECK_URL_PRODUCTION, FTP_REMOTE_DIR, ASF_OFFERINGS_URL_TEST. Ontbreekt: FTP_HOST, FTP_USERNAME, FTP_PASSWORD. De productiejob kan dus niet draaien. |
Gitea API-lijst van secrets en variabelen (alleen namen). |
| CMS-pipeline (CMS-repo) | Inputs deploy_sls_test, deploy_sls_production, deploy_asf_test. Er is geen deploy_asf_production: "Test only: there is no production path for ASF". Publiceren is linux-arm64, --self-contained false; uitrollen is deploy-scp.yaml (SSH, releases/, symlink current, systemd user-unit). Voor IIS is geen van drie bruikbaar. |
CMS master, .gitea/workflows/continuous_integration.yaml (PUBLISH_RID: linux-arm64, publish-asf-test, deploy-asf-test). |
| Twee repo's, twee pipelines | De ASF-repo bouwt de site (dist), de CMS-repo bouwt de host. Op test regelt de ASF-pipeline dat dist-test in de prerendered-map van de host landt. Voor productie is niet beschreven hoe en in welke volgorde beide op de IIS-host komen. |
joint-release-checklist.md (SLS aidlc-docs/_shared): "ASF IIS publish pipeline exists (own feature: self-contained win-x64 publish, FTP upload, web.config, the CMS host as the single entry)". |
| Productie-artefact | dist uit job check: zonder OFFERINGS_URL (snapshot), zonder VITE_SITE_URL, formulier dicht. Bewust zo. |
docs/deploy-and-ci.md. |
Samengevat: de testpijplijn is gezond; wat ontbreekt of verkeerd is, is het hele productiepad (ontwerp, repo-overstijgende volgorde, secrets, CMS-kant, verificatie).
2. Doelarchitectuur op IIS (MijnHostingPartner)
flowchart LR
B[Bezoeker] -->|HTTPS| I[IIS, redirects www en HTTPS]
I -->|alle verzoeken| H[CMS-host Api.AndreaSlopFotografie]
H --> P[prerendered dist, host injecteert pakketten, banners, hero]
H --> A["/admin en /api/v1"]
H --> D[(Database)]
H --> M[Mediamap]
H --> S[SMTP, captcha uit]
classDef edge fill:#f6e05e,stroke:#c05621,color:#000;
classDef host fill:#63b3ed,stroke:#2b6cb0,color:#000;
classDef data fill:#9ae6b4,stroke:#2f855a,color:#000;
class I edge;
class H,P,A host;
class D,M,S data;
Tekstalternatief: de bezoeker komt bij IIS, dat alleen redirects doet en alles doorgeeft aan de CMS-host; de host serveert de pagina's, de admin en de API en gebruikt database, mediamap en mail.
- Host publiceren: self-contained
win-x64(de host hoeft dan geen runtime geïnstalleerd te hebben) metweb.configvoor de ASP.NET Core Module. In-process of out-of-process hangt af van wat het pakket biedt (A1). - Site (
dist) gaat naar de prerendered-map van de host (op testwwwroot-web; op IIS een map naast de app, A2). De host injecteert de live data (cache 60 s); een inhoudswijziging vraagt geen rebuild. - IIS-
web.config: nog steeds gegenereerd doorweb/config/serverConfig.ts(nooit met de hand), maar nieuw: alleen redirect www -> apex, HTTP -> HTTPS, en doorgeven aan de host. De bestaande canonieke redirects (index, hoofdletters, slash) doet de host op test ook; de eerste stap is te controleren welke de host al doet en wat IIS moet blijven doen. Beveiligingsheaders komen van de host, zoals op test. - Geheimen: als environment-variabelen, niet in de repo. Op IIS is dat
web.configof het hostingpaneel; wie FTP-toegang heeft ziet ze (risico R3). Aanname A3: het paneel ondersteunt dat. - Database: de CMS-host gebruikt MariaDB/MySQL. Aanname A4: het hostingpakket levert een MariaDB/MySQL-database en een back-upmogelijkheid. Is dat niet zo, dan is dit een blokkade en komt er een alternatief (V3).
- Mediamap: schrijfbare map buiten de gedeployde release, zodat een deploy foto's niet wist (zoals
shared/op de Pi). Hier is een persistent pad nodig (A2). - Mail: SMTP van MijnHostingPartner, afzender in
Email:AllowedFromAddresses, ontvanger via de omgeving, SPF/DKIM controleren met een echte mail (go-live-checklist). - Captcha: blijft uit bij go-live tot er een betaald Friendly Captcha-plan is; het formulier blijft dicht (
VITE_CONTACT_FORM_ENABLEDniet gezet) tot Bryans go. - HTTPS: certificaat via het hostingpakket, HSTS pas na een geslaagde proefperiode (A5).
- Client-IP/ratelimit:
ForwardedHeaders:KnownProxiesenClientPartitionKeyvoor de IIS-situatie (bestaande eis uitcontact-api-contract.md).
3. Pipeline-wijzigingen stap voor stap
Alles in feature-branches, geen release-branch. Elke stap die iets op productie raakt wacht op Bryans go.
Stap 0 - hostingfeiten vaststellen (geen code). Beantwoord A1 t/m A6 en V1 t/m V4 door het pakket te bekijken of een proef-upload te doen. De joint-release-checklist zegt: "open hosting questions are answered by trying it with ASF". Een proef op een tijdelijk subdomein (bijvoorbeeld staging.andreaslop.nl) is de veiligste manier (V2).
Stap 1 - CMS-repo (SMC, eigen feature-branch).
- Publiceer-job
publish-asf-production:dotnet publish -r win-x64 --self-contained true, adminbouw metVITE_APP_ENV=production,VITE_THEME=asf,VITE_DEFAULT_LANGUAGE=nl. - Deploy-job voor IIS: FTPS-upload in rondes (zoals
upload-production.sh), metapp_offline.htmtijdens het vervangen van de host-bestanden en een kopie van de vorige release voor terugdraaien. - Nieuwe input
deploy_asf_production, gate zoals SLS-productie (V5:release/*of vervangen door een goedkeuringsstap). scripts/smoke-site.shuitbreiden met eenasf-production-modus.- Voorlopig uit via een variabele (zoals
ASF_TEST_DEPLOY_ENABLED) zodat niets verandert tot alles klaar is.
Stap 2 - ASF-repo (deze branch, feature/asf-production-iis).
serverConfig.tsen de gegenereerdeweb/deploy/iis/web.configomzetten naar "redirects + pass-through"; de test die gegenereerd en gecommit vergelijkt blijft gelden.- Job
deploy-productionherschrijven:distvia FTPS naar de prerendered-map van de host (assets eerst, HTML als laatste, daarna opruimen; bestaand idee vanupload-production.sh, nieuw doelpad en géénweb.config-kopie), daarnaverify-deployment.sh ... --cmstegen de productie-URL (genormaliseerd vergelijken zoals op test). - Secrets/variabelen laten aanmaken door Bryan of SLS (feature-sessies wijzigen repo-variabelen niet):
FTP_HOST,FTP_USERNAME,FTP_PASSWORD,FTP_REMOTE_DIR,HEALTH_CHECK_URL_PRODUCTION. - Docs bijwerken in dezelfde wijziging (
docs/deploy-and-ci.md,docs/go-live-checklist.md,docs/cms-integration.md), zoalsAGENTS.mdeist. - Lighthouse op de Pi is flaky (run 761). Voorstel: performance blijft "melden" zoals nu; de overige categorieën blokkeren.
Stap 3 - repetitie op de proefomgeving (zonder productie).
- Beide pipelines draaien naar de proefomgeving (A6) met testwaarden (testpakketten,
noindex). - Controleren:
/health,/admin, een echte pagina, injectie van pakketten/banners/hero, headers (CSP), redirects, een upload (ook HEIC op win-x64, R4), een mail. - Terugdraaien oefenen (sectie 6).
Stap 4 - go-live (alleen met Bryans go, in de gezamenlijke release). Volgorde uit de joint-release-checklist.md: SLS-CMS-productie, daarna de SLS-website, daarna ASF. Zie sectie 7.
4. Hoe de mediabibliotheek-uitrol erin past
- CMS PR #29 (gemerged op master van het CMS, op test gedeployed): bij de start doet de host de kopie
HeroImages -> MediaAssets, controleert streng en dropt pas daarna; bij een weigering start de app niet (Critical-regel). Productie van SLS gaat dus in één release (production-rollout.mdin de CMS-repo). - ASF-productie begint zonder database (A7): er is nog geen ASF-productie-CMS met hero-foto's. De migraties lopen op een lege database en
HeroImagesis leeg; de guard laat een lege tabel door. Voor ASF is er dus geen kopie en geen drop met data. Het "verse herstelpunt" uitproduction-rollout.mdgeldt voor SLS-productie; voor ASF is een database-back-up vóór de eerste echte beheerdersdata genoeg, maar de back-upprocedure moet er wel zijn (V3). - Seeden: daarna eerst beheerder aanmaken (setup-token, verwijderen na gebruik), echte pakketten invoeren, hero seeden en
offerings.snapshot.jsonvullen met de echte pakketten (go-live-checklist). - Volgorde: de productie-CMS moet de echte pakketten hebben vóór er verkeer komt; het productie-artefact bevat de testprijzen nooit.
5. Privacyverklaring en JSON
- Tekst: het goedgekeurde concept van 17-11-2026 staat in
aidlc-docs/_shared/privacyverklaring-asf-concept-2026-11-17.txt(SLS-repo). Andrea controleert het nog; het is de basis voor livegang (Bryan, 2026-11-17). - Code: op
masteris/privacyverklaringnog een placeholder. De opzet (privacyContent.ts,PrivacyNote, tests) staat opfeature/privacy-statement(2 commits voor, 59 achter op master). Stap: die wijzigingen op master laten aansluiten en overnemen in deze branch. - JSON:
privacyContent.tswordt een JSON-bestand (bijvoorbeeldweb/src/content/privacy.nl.json), samen met de definitieve tekst. Behouden: dePLACEHOLDER_MARK-controle (unresolvedPlaceholders()), de captcha-sectie (onlyWithCaptcha, verborgen zolang captcha uit staat) en hun tests; plus een vormtest voor het JSON-bestand. Privacy blijft een eigen bestand en komt niet innl.json, omdat het juridische tekst met een eigen reviewproces is (A8). - Voorwaarden voor livegang (go-live-checklist): Bryan en Andrea keuren de tekst goed; MijnHostingPartner is vastgelegd als verwerker met verwerkersovereenkomst en verwerking in Nederland; de reactietermijn is bevestigd (het concept zegt "binnen vier weken"); de captcha-alinea klopt met de captchabeslissing; geen
[OPEN:-markers; de bewaartermijnen kloppen met de server (1 jaar, 30 dagen spam). - KvK-nummer: staat niet in het concept en moet zichtbaar zijn op de site (V6).
6. Terugdraaien
| Wat | Hoe |
|---|---|
Site (dist) |
Vorige dist terugzetten (artefacten blijven 7 dagen in Gitea; hoe lang we ze apart bewaren: V7). HTML wordt als laatste geüpload, dus een mislukte asset-ronde laat de oude site intact. |
| Host-app | Vorige release terugzetten (kopie van de vorige map) en app_offline.htm weghalen. Migraties zijn additief; voor terugdraaien van migraties geldt het databaseherstelpunt. |
| Database | Back-up vóór de eerste uitrol met data; terugzetten met de functie van de hoster (A4). |
| Formulier | VITE_CONTACT_FORM_ENABLED weglaten en opnieuw deployen, of Contact:Enabled uit op de server. |
| DNS/cutover | Zie V8: oude site bewaren tot de nieuwe site verifieerbaar werkt. |
7. Open punten (uit de go-live- en gezamenlijke releasechecklist)
- Echte HEIC-test (upload en verwerking op win-x64, R4).
- Captcha-provider kiezen (Gitea-issue #14 in de CMS-repo); tot dan uit.
- Gezamenlijke release: SLS-CMS -> SLS-site -> ASF, elke stap met go; daarna Sentry, smoke-tests, deelafbeelding, sitemap, een echt formulierbericht (alleen als het formulier open staat), cookies/statistiek zoals in de privacyverklaring.
- KvK-nummer zichtbaar op de site.
- Verwerkersovereenkomst met MijnHostingPartner.
- Eerste ASF-beheerder aanmaken en het setup-token verwijderen.
offerings.snapshot.jsonmet echte pakketten; testprijzen nooit in het productie-artefact.- Productie-CMS bevat de echte hero (zonder seed toont productie de ingebakken hero uit
heroContent.ts).
8. Risico's
| # | Risico | Maatregel |
|---|---|---|
| R1 | Het hostingpakket kan de .NET-host niet draaien (A1). | Stap 0 vóór alle bouwwerk; alternatief: host elders (bijvoorbeeld de Pi, zoals SLS) en IIS alleen als reverse proxy. |
| R2 | Twee losse uploads (host en site) lopen even uit de pas. | Volgorde: host eerst met app_offline.htm, dan site, dan app_offline weg; smoke-test erna. |
| R3 | Geheimen leesbaar voor wie FTP-toegang heeft. | Environment-variabelen via het paneel indien mogelijk; geen geheimen in repo of logs. |
| R4 | HEIC-verwerking werkt anders op Windows (native bibliotheken). | Echte HEIC-test op de proefomgeving vóór go-live. |
| R5 | Lighthouse-performance op de Pi is wisselend en blokkeert productie. | Performance blijft "melden"; andere categorieën blokkeren. |
| R6 | SEO-verlies bij de overstap van de oude site. | Redirectlijst van oude URL's (V8). |
| R7 | Een foute deploy raakt de testsites (zelfde CMS-pipeline). | Productiestappen achter een variabele en een eigen input; test blijft ongewijzigd. |
9. Aannames (te controleren)
- A1 MijnHostingPartner draait ASP.NET Core 10 (self-contained) achter IIS met de ASP.NET Core Module. Onbekend:
cms-api-foundation/requirements.mdzegt "whether the production host runs .NET is unknown". - A2 Er is een persistent, schrijfbaar pad buiten de release voor media en een map voor de prerendered pages.
- A3 Omgevingsvariabelen zijn instelbaar via het paneel of de
web.configvan de host. - A4 Het pakket bevat een MariaDB/MySQL-database met back-up en terugzetten.
- A5 Certificaat en HSTS regelt de hoster.
- A6 Een tijdelijk subdomein voor een proef is mogelijk.
- A7 Er bestaat nog geen ASF-productie-CMS met gegevens.
- A8 Privacytekst blijft een eigen JSON-bestand (niet in
nl.json).
10. Vragen voor Bryan
- V1 Wat is het hostingpakket precies (Windows/IIS, .NET 10 en de ASP.NET Core Module, FTP/FTPS, SSH)? Is er een paneel of documentatie die ik moet zien?
- V2 Mag er een tijdelijk subdomein (bijvoorbeeld
staging.andreaslop.nl) voor een proef-uitrol, en mag dat kosten? - V3 Welke database en welke back-upprocedure heeft het pakket; kunnen we daar een herstelpunt maken zoals op de Pi?
- V4 Welke SMTP-gegevens en welk afzenderadres voor het formulier?
- V5 Productie-gate: houden we
release/*(zoals SLS) of vervangen we dat door een handmatige goedkeuringsstap op master? Je wilde de pipeline in een feature-branch; eenrelease/*-branch zou dan alleen op jouw verzoek voor de uitvoering bestaan. - V6 Welk KvK-nummer en waar op de site (footer of contact)?
- V7 Hoe lang bewaren we
dist-artefacten van productieruns buiten Gitea (voor terugdraaien)? - V8 Wat draait er nu op andreaslop.nl (WordPress, waar?), en wanneer en hoe schakelen we DNS om? Is er een redirectlijst van oude URL's nodig?
- V9 Controleert Andrea de privacytekst voordat de definitieve tekst en JSON klaar zijn, en wie levert de verwerkersovereenkomst?
- V10 Captcha: laten we het uit bij go-live (formulier dicht), of eerst Friendly Captcha betaald?
11. Besluiten en antwoorden van Bryan (2026-11-18)
| Onderwerp | Besluit / antwoord | Gevolg voor het plan |
|---|---|---|
| A1 .NET 10 | Bevestigd: ASP.NET-optie "No managed code", ASP.NET Core Module, .NET 10 ondersteund. | A1 is vastgesteld. In-process of out-of-process blijft in stap 0 uit te zoeken; self-contained win-x64 blijft het uitgangspunt. |
| V2/A6 staging-subdomein | Nee: het pakket heeft ruimte voor één website. De testomgeving staat daarom op de Pi. | Stap 3 (repetitie op een subdomein) vervalt. Zie "Repetitie" hieronder. |
| V4 SMTP | Gegevens staan in de kennisbank van MijnHostingPartner (host-adressen voor e-mail). | Hostadressen overnemen in de configuratie (nog invullen). |
| V5 gate | release/* blijft de productiepoort; een goedkeuringsstap in de pipeline is later mogelijk. |
Geen wijziging t.o.v. SLS. |
| V6 KvK | Nog niet bekend; komt in de footer. Besluit: live zonder KvK-nummer. | Geen blokkade voor go-live. De footer toont het nummer pas zodra het bekend is; geen plaatsaanduiding op de live site. Privacytekst: geen [OPEN:]-markers in het live artefact. |
| V8 WordPress | Op het productiepakket draait een WordPress-site. De nieuwe site staat nu op de Pi. Vóór het uitschakelen een back-up van de laatste staat. | Back-up van WordPress (bestanden + database) wordt een verplichte stap vóór go-live. |
| Redirects | Korte lijst van belangrijkste oude URL's naar de nieuwe pagina's. | ASF-sessie brengt de WordPress-URL's in kaart (home, over mij, contact, portfolio, enz.) en legt de redirects vast in serverConfig.ts. |
| V9 privacy | Bryan heeft de eerste controle gedaan; Andrea controleert nog. Verwerkersovereenkomst: geen apart document van ons; hoster biedt meestal een standaard aan (art. 28 AVG). | Controleren of MijnHostingPartner een standaardverwerkersovereenkomst heeft; Andrea legt dat vast. |
| V10 captcha | Blijft uit bij go-live; formulier dicht. | Geen wijziging. |
Repetitie (vervangt stap 3). Besluit: direct live na back-up. Mogelijk wijst Bryan de domeinnaam tijdelijk naar de Pi; in die tijd wordt de nieuwe site op het pakket gezet. Daarna gaat de DNS naar het pakket en wordt getest of rechten, hostinstellingen, mail, uploads (HEIC) en media werken. Terugdraaien = DNS terug naar de Pi (of WordPress terugzetten uit de back-up).
Certificaat. Een tweede Let's Encrypt-certificaat voor hetzelfde domein via de hoster is toegestaan; certificaten zijn onafhankelijk en er geldt een ruime limiet. Voor de HTTP-01-controle moet het domein naar de aanvragende server wijzen: aanvragen bij de hoster kan dus pas ná de DNS-omzetting (of via DNS-01). Overbrugging: certificaat en sleutel van de Pi hergebruiken indien het pakket een eigen certificaat accepteert, of de omzetting plannen met een korte periode zonder HTTPS-certificaat (te vermijden). Nog uit te zoeken in stap 0.
Nog open: A2 (schrijfbaar pad), A3 (omgevingsvariabelen), A4 (MariaDB/MySQL met back-up), A5 (certificaat/HSTS door de hoster), V7 (bewaren artefacten).
Hostingfeiten van Bryan (2026-11-18, na de eerste antwoorden)
| Aanname | Antwoord / stand | Terugvaloptie |
|---|---|---|
| A2 schrijfbaar pad voor media | Bryan kan schrijfrechten instellen. Of een pad buiten wwwroot kan, weet hij niet; nog uit te zoeken. |
Map binnen wwwroot met een web.config die directe toegang tot de mapstructuur beperkt, of een niet-publiek pad via de hosterinstellingen. |
| A3 omgevingsvariabelen | Bryan moet nog controleren of het paneel ze ondersteunt. | appsettings.Production.json of de web.config van de host (geen geheimen in de repo). |
| A4 database | Er is een MariaDB beschikbaar. De connection string volgt van Bryan. Naam (besluit Bryan, 2026-11-18, voor consistentie met SLS): productie AndreaSlopFotografie, gebruiker AndreaSlopFotografie; test blijft AndreaSlopFotografieTest. Past het hostingpaneel een voorvoegsel toe of een naamlimiet, dan geldt de naam die het paneel toestaat; de naam staat alleen in de connection string. Niet verwarren met de oude WordPress-database andreaslop op de Pi. |
Nooit in de repo; als omgevingsvariabele of secret. |
| A5 certificaat | Bryan regelt het Let's Encrypt-certificaat zodra de site op de nieuwe host staat. | Zie het stuk over het certificaat hierboven. |
Oude URL's. De oude WordPress-site is vastgesteld en de redirects staan in oude-urls.md. Samenvatting: alleen de vijf echte pagina's (/, /over-mij, /portfolio, /soorten-fotoshoots, /contact; zelfde slugs als nu) en de sitemap-URL's gaan met 301 naar de nieuwe site; thema-demo en WordPress-systeemadressen krijgen 404/410. Op 2026-11-18 draait op andreaslop.nl nog WordPress.
Correctie (Bryan, 2026-11-18): productie heeft alleen FTP, geen FTPS
Het plan sprak van FTPS-upload; het productiepakket biedt alleen gewone FTP. Gevolgen:
- Gebruikersnaam, wachtwoord en alle bestanden gaan onversleuteld over het netwerk (risico R9). Maatregelen: een eigen FTP-account met rechten alleen op de site- en hostmappen, een uniek sterk wachtwoord, het wachtwoord alleen als Gitea-secret (
PROD_HOST_PASSWORDin de ASF-repo,ASF_PROD_HOST_PASSWORDin de CMS-repo), rouleren na de eerste uitrol, en bij de hoster navragen of SFTP of FTPS (explicit) op aanvraag beschikbaar is. - Uploaden uit de pipeline gebeurt vanaf onze runner via het internet; geen geheimen in logs. Mogelijk IP-beperking van het FTP-account (indien de hoster dat biedt).
- De uitrolscripts (
upload-production.shen de CMS-deploystap) moeten gewone FTP ondersteunen (passieve modus);lftp-opties dienovereenkomstig, zonderftps. - Het besluit over SFTP/FTPS-beschikbaarheid komt in de vragen voor Bryan (V1).