Gebruik een SPA met IPROX OpenApi

Het is mogelijk om een statische website toe te voegen aan een IPROX OpenApi installatie. In dit artikel leg ik in het kort uit hoe je dit kunt configureren.

Uitgangspunten Er is al een release-pipeline ingesteld voor de betreffende "frontend" omgeving met een IPROX OpenApi installatie.

Configuratie DevOps

Allereerst zul je de release-pipeline in DevOps moeten aanpassen, zodat hij de release uitrolt via "Web Deploy" en niet als package, daarnaast mag alles opgeschoond worden, behalve de /App_Data/ map. Deze moet blijven bestaan. Hier kun je in een later stadium de statische website plaatsen.

Vervolgens dien je een nieuwe release uit te rollen.

Plaatsen van statische website

Via FTPS (misschien moet je dit nog even toestaan in de Azure configuratie) kun je naar het productie-slot gaan. Ga vervolgens naar de map /site/wwwroot/App_Data. In deze App_Data map kun je een nieuwe map toevoegen waarin je de statische website plaatst. Tot slot dien je de Azure configuratie van de "App service" aan te passen. IproxSpa:Enabled moet op true staan, tevens dien je in IproxSpa:RootPath aan te geven waar je statische applicatie staat. Zie hier een voorbeeld:

Doordat je de settings heb aangepast, start de site opnieuw op en komt de nieuwe statische site beschikbaar. Mocht je het in een andere volgorde doen, dan zou het kunnen betekenen dat je de App Service nog even moet herstarten.

Ditzelfde zul je ook voor het 2e slot moeten doen (indien aanwezig natuurlijk). Daarna zijn beide deploy-sloten up-to-date en kan er zorgeloos een nieuwe release via DevOps uitgerold worden van de IPROX OpenApi software. De map met de statische site zou moeten blijven bestaan.

Statische website uit eigen DevOps

We hebben voor het "RWS Visueel Dataportaal" een statische site laten genereren vanuit ons eigen DevOps, dus dat is ook mogelijk. Dus dan kun je de statische site laten bouwen in DevOps om dit verderop in de uitrol weer te gebruiken, zie bijvoorbeeld RWS Visueel Dataportaal API.