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>
93 lines
9.7 KiB
Markdown
93 lines
9.7 KiB
Markdown
# 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:
|
|
1. een handmatige run (`workflow_dispatch`) met **`deploy_asf_production`** aangevinkt;
|
|
2. die run staat op een branch **`release/*`**;
|
|
3. de Gitea-variabele **`ASF_PROD_DEPLOY_ENABLED`** is `true` (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`):
|
|
1. Verbinding en doelmap controleren.
|
|
2. `app_offline.htm` uploaden: IIS zet de app stil en geeft de DLL's vrij; vijf seconden wachten.
|
|
3. Map voor map uploaden (één lftp-sessie per stap, stoppen bij een fout). **Alleen `wwwroot/admin` wordt opgeruimd** (verwijderen van bestanden die niet meer in de release zitten); nergens anders `--delete`.
|
|
4. De bestanden in de root, de `web.config` als laatste.
|
|
5. `app_offline.htm` verwijderen: de app start (op de eerste uitrol maakt de eerste start de database-tabellen, zie 5).
|
|
6. 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/web` uit; de website-upload raakt niets buiten `wwwroot/web` aan en zet er zelf geen `web.config` neer.
|
|
- **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 30` en `net:reconnect-interval-base 5` toe, de website-upload heeft die niet nodig.
|
|
|
|
## 5. De eerste uitrol op een lege database
|
|
|
|
Alleen na Bryans go. Vooraf, door Bryan:
|
|
1. **Back-up** van de WordPress-site en de database `andreaslop` (WordPress mag daarna weg; de database blijft ongemoeid).
|
|
2. De oude WordPress-bestanden uit de hostmap halen (`index.php`, `wp-*`, de oude `web.config` met rewrite-regels), **behalve** de nieuwe map `uploads`. Een oude WordPress-`web.config` zou botsen met de nieuwe.
|
|
3. In de hostmap een map `logs` maken (schrijfrechten voor de application pool-identiteit); schrijfrechten voor `uploads` zetten.
|
|
4. `appsettings.Production.json` met de hand naast de plek van de `.exe` zetten, volgens sectie 3 van de configuratiedoc (databasegegevens, JWT-sleutel, setup-token, mail, `Media:Directory`, Sentry). `Website:NoIndex` blijft `true`.
|
|
5. In Gitea de variabelen controleren (`ASF_PROD_DEPLOY_PATH` is nu het echte hosterpad; test eerst `DRY_RUN=1`), en `ASF_PROD_DEPLOY_ENABLED=true` zetten.
|
|
|
|
De uitrol:
|
|
1. Release-branch `release/...` van `master`, dispatch met `deploy_asf_production` aangevinkt.
|
|
2. 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"), op `Image library Magick.NET self-test passed` en op de Hero-melding; controleer daarna `/api/v1/System/capabilities`.
|
|
3. Open `https://andreaslop.nl/admin`: de setuppagina vraagt het **setup-token** en maakt de **eerste beheerder** aan.
|
|
4. Haal daarna `Identity:Setup:Token` uit `appsettings.Production.json` (herlaad of recycle de pool).
|
|
5. Test de mediamap: een foto uploaden, controleren dat er een bestand in `uploads` staat en dat de map niet via de browser bereikbaar is (zie 1e van de configuratiedoc).
|
|
6. De website-upload van het ASF-project naar `<hostmap>/wwwroot/web` laten draaien; controleer de homepage, `/sitemap.xml` en dat `/redirects.json` een 404 geeft.
|
|
7. Pas op het release-moment, na Bryans go: `Website:NoIndex` naar `false`, en pas dan de domeinwissel/DNS. Haal `ASF_PROD_DEPLOY_ENABLED` weer 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-x64` van 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.htm` uploaden (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), daarna `app_offline.htm` verwijderen. 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.md` van 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/` en `wwwroot/web`.
|
|
|
|
## 7. Open punten voor Bryan en SLS
|
|
|
|
1. Het echte hosterpad voor `ASF_PROD_DEPLOY_PATH` (en daarmee of de website-map `wwwroot/wwwroot/web` wordt).
|
|
2. Heeft het FTP-account schrijfrechten in de hostmap voor `app_offline.htm`? Faalt de eerste proefupload hier, meld het.
|
|
3. Is `lftp` op de Gitea-runner aanwezig (of mag de job het installeren)? De job probeert `apt-get`; anders de runner-image aanpassen.
|
|
4. Wat doet de hoster al aan HTTP naar HTTPS en www naar apex (zie 2a van de configuratiedoc)?
|