Packages
Azure Artifacts
Url: https://dev.azure.com/infoprojectsnl/iprox.headless/_artifacts/feed/iprox.nuget
Voor het publiceren en installeren van packages van en naar Azure Artifacts bestaat de volgende feed: https://pkgs.dev.azure.com/infoprojectsnl/_packaging/iprox.nuget/nuget/v3/index.json. Naar Azure Artifacts worden alleen Iprox.Cms De packages worden in de pipeline gepubliceerd met Deploy-Package.ps1.
GitLab Package Registry
Url: https://gitlab.com/iprox/producten/iprox/-/packages
Het publiceren van NuGet packages naar een GitLab Package Registry moet gebeuren naar de feed van het project. Voor iprox.cms is dat https://gitlab.com/api/v4/projects/60718155/packages/nuget/index.json. De packages worden in de pipeline gepubliceerd met Deploy-Package.ps1.
Voor het installeren van packages kan dit op group niveau. Voor de Producten group is de feed https://gitlab.com/api/v4/groups/91688044/-/packages/nuget/index.json. Hoe een connectie gemaakt kan worden is te vinden op https://infoprojects.atlassian.net/wiki/spaces/DEV/pages/2751004673/NuGet
Iprox.Cms
Het Iprox.Cms NuGet package is een bundle met de www folder en de benodigde dll's. Dit geldt als basis voor het deployen van de headless cms omgeving. Deze package wordt daarvoor naast dat het naar GitLab wordt gepubliceerd ook naar Azure Artifacts gepubliceerd.
Iprox.OpenApi.Generator
Iprox.OpenApi.Generator is een dotnet tool waarmee een swagger server wordt gegenereerd. Deze tool kan geïnstalleerd worden door de volgende command: dotnet tool install --global iprox.openapi.generator
Om de generator via command line uit te voeren kan de volgende command gebruikt worden: iprox-generator, hierin kan een aantal options worden meegegeven:
| Optie | Omschrijving | Voorbeeld | Verplicht |
|---|---|---|---|
| --TargetDir | Folder waar de api wordt gegenereert | build | ja |
| --CmsUrl | De URL naar de CMS omgeving | https://app-naam-omgeving-cms.azurewebsites.net/ | ja |
| --EnvSyn | De "Synchronisatie identificatie" van de omgevingen in het cms die moeten worden meegenomen in het genereren. | api | ja |
| --DateFilters:activiteit:0:CodeName | date | nee | |
| --DateFilters:activiteit:0:Selector | "Pag.Inhoud.Datum" | nee | |
| --Authentication | Manier van authentiseren van de api | api | nee |
| --BundleSites | Bundelen van sites, dit zorgt ervoor dat een type per site endpoints krijgt, als deze type in meerdere sites beschikbaar is. Hierdoor zijn alle endpoints dus generiek van de site. | true | nee |
| --Preview | Stelt de preview endpoints beschikbaar | true | nee |