Lokale setup

Concept

De lokale setup is bedoeld voor configuratoren en developers die in teamverband willen samenwerken aan de ontwikkeling van een applicatie. De lokale setup biedt volgende basiscomponenten:

Lokale configuratie- en ontwikkelingstools: een IDE (IntelliJ) en lokale Studio.
Git client (Fork) om samen te werken aan configuratie-items, extensies en customizaties.
Lokaal geïnstalleerde versie van de applicatie voor testdoeleinden.

Diagram

Stap	Uitleg
Stap 1: Installeer alle tools	Check enkele requirements: hardware, systeemvereisten, skills, accounts. Installeer alle tools gerelateerd aan de Skryv-applicatie (zie ook infrastructuur schema). Voor Mac gebruik je Homebrew (package manager). Voor Windows installeer je alle tools handmatig. Frontoffice, backoffice & lokale Studio: voor deze JavaScript gebaseerde webapplicaties gebruiken we Node.js als runtime environment. De dependencies worden onder de vorm van npm-packages gedownload vanuit de Skrvy npm repository. Spring boot app: voor deze Java gebaseerde applicatie gebruiken we JDK als runtime environment. De dependencies worden onder de vorm van Maven-packages gedownload vanuit de Skryv Maven repository. Technische componenten zoals RabbitMQ, ElasticSearch, SQL database, DocMod, KeyCloak worden uitgevoerd in Docker containers. Aansturing van en coördinatie tussen de containers gebeurt via Docker Compose. De benodigde images worden gedownload vanuit de Skryv repository. Installeer de niet-Skryv tools zoals een IDE (IntelliJ) en git client (Fork).
Stap 2: Configuratie van de lokale setup	Eenmaal alle tools geïnstalleerd zijn, kan je van start gaan met de configuratie van een specifieke Skryv-applicatie. De principes zijn in grote lijnen dezelfde als bij een cloud setup. Hier zijn evenwel twee mogelijkheden: ofwel haal je alle configuratie-items, extensies en customizaties voor een bestaande Skryv applicatie binnen vanuit een centrale git repository; ofwel gebruik je Cookiecutter om zelf lokaal een nieuwe Skryv applicatie met de bijhorende configuratie-items te creëren en deze vervolgens toe te voegen aan de centrale git repository.
Stap 3: Operationeel beheer van de lokale setup	Handleiding met instructies om de lokale setup te bedienen op een dagdagelijkse basis. We tonen hoe je de verschillende componenten van een applicatie kan opstarten. Ook het samenspel tussen lokale Studio, de IDE (IntelliJ), de git client (Fork) en de centrale git repository krijgt de nodige toelichting.

Detail instructies

Neem contact op met het Skryv team voor gedetailleerde instructies en toegang tot de juiste repositories.