Helm commands

Hieronder kun je een voorbeeld implementatie vinden als bronorganisatie om te kunnen communiceren met de Vorderingenoverzicht Rijk demo omgeving.

In deze voorbeeldinstallatie (op basis van helm) gebruiken we als bronorganisatie Testorganisatie. Vervang alle testorganisatie waarden door die van je eigen bronorganisatie en vervang ook het organisatie-identificatienummer (OIN) in de componenten demo-source-system, session-process en bk-management-process door je eigen OIN.

Kubernetes operator voor PostgreSQL, CloudNativePG:

helm repo add cnpg https://cloudnative-pg.github.io/charts

helm upgrade --install cnpg \
    --namespace cnpg-system \
    --create-namespace \
    cnpg/cloudnative-pg

Vorderingenoverzicht Rijk componenten:

Gateway API in plaats van Ingress

De Helm charts gebruiken de Kubernetes Gateway API in plaats van Ingress; ingress.enabled staat standaard op false. Zorg dat er in je cluster een Gateway bestaat die TLS termineert voor de hieronder gebruikte hostnames.

Vervang de CHANGE_THE_GATEWAY_NAME, CHANGE_THE_GATEWAY_NAMESPACE en CHANGE_THE_GATEWAY_SECTION_NAME waarden door de naam en namespace van jouw Gateway en de naam van de listener (sectionName) waarop je wilt aansluiten. TLS wordt nu op de Gateway-listener geregeld en niet meer per component (ingress.tls).

Maak het bestand bk-configuration.json aan met daarin de json:

{
  "financialClaimRequestApi": {
    "v4": "https://financial-claim-request-api.testorganisatie.demo.mijn-betaaloverzicht.nl/v4"
  },
  "sessionApi": {
    "v3": "https://session-api.testorganisatie.demo.mijn-betaaloverzicht.nl/v3"
  }
}

Voer het onderstaande uit vanuit dezelfde folder met de bk-configuration.json.

Vergeet niet om de API key's, de scheme root public key en de gateway-gegevens aan te passen in het onderstaande script. (Vervang de CHANGE_THE_API_KEY, CHANGE_THE_SCHEME_ROOT_PUBLIC_KEY, CHANGE_THE_GATEWAY_NAME, CHANGE_THE_GATEWAY_NAMESPACE en CHANGE_THE_GATEWAY_SECTION_NAME waarden).

helm repo add vorijk https://blauwe-knop.gitlab.io/vorderingenoverzicht/charts

helm upgrade --install bk-config-db \
    --namespace testorganisatie \
    --create-namespace \
    --version 0.20.11 \ #version:bk-config-db
    vorijk/bk-config-db

helm upgrade --install financial-claim-request-db \
    --namespace testorganisatie \
    --version 0.19.0 \ #version:financial-claim-request-db
    vorijk/financial-claim-request-db

helm upgrade --install vhsm-db \
    --namespace testorganisatie \
    --create-namespace \
    --version 0.2.9 \ #version:vhsm-db
    vorijk/vhsm-db

helm upgrade --install bk-config-service \
    --namespace testorganisatie \
    --set apiKey.value="CHANGE_THE_API_KEY" \
    --version 0.22.0 \ #version:bk-config-service
    vorijk/bk-config-service

helm upgrade --install financial-claim-request-service \
    --namespace testorganisatie \
    --set apiKey.value="CHANGE_THE_API_KEY" \
    --version 0.20.1 \ #version:financial-claim-request-service
    vorijk/financial-claim-request-service

helm upgrade --install session-service \
    --namespace testorganisatie \
    --set apiKey.value="CHANGE_THE_API_KEY" \
    --version 0.19.0 \ #version:session-service
    vorijk/session-service

helm upgrade --install vhsm-service \
    --namespace testorganisatie \
    --set apiKey.value="CHANGE_THE_API_KEY" \
    --version 0.3.0 \ #version:vhsm-service
    vorijk/vhsm-service

helm upgrade --install demo-source-system \
    --namespace testorganisatie \
    --set apiKey.value="CHANGE_THE_API_KEY" \
    --set env[0].name=ORGANIZATION_OIN \
    --set env[0].value="CHANGE_THE_ORGANIZATION_OIN" \
    --set env[1].name=LOG_LEVEL \
    --set env[1].value=debug \
    --version 0.20.5 \ #version:demo-source-system
    vorijk/demo-source-system

helm upgrade --install session-process \
    --namespace testorganisatie \
    --set gateway.name=CHANGE_THE_GATEWAY_NAME \
    --set gateway.namespace=CHANGE_THE_GATEWAY_NAMESPACE \
    --set gateway.sectionName=CHANGE_THE_GATEWAY_SECTION_NAME \
    --set gateway.hostname=session-api.testorganisatie.demo.mijn-betaaloverzicht.nl \
    --set config.schemeDiscoveryUrl="https://api.stelsel.demo.mijn-betaaloverzicht.nl" \
    --set config.schemeRootPublicKey="CHANGE_THE_SCHEME_ROOT_PUBLIC_KEY" \
    --set config.organizationOin="CHANGE_THE_ORGANIZATION_OIN" \
    --version 0.22.1 \ #version:session-process
    vorijk/session-process

helm upgrade --install service-discovery-process \
    --namespace testorganisatie \
    --set gateway.name=CHANGE_THE_GATEWAY_NAME \
    --set gateway.namespace=CHANGE_THE_GATEWAY_NAMESPACE \
    --set gateway.sectionName=CHANGE_THE_GATEWAY_SECTION_NAME \
    --set gateway.hostnames[0]=testorganisatie.demo.mijn-betaaloverzicht.nl \
    --set-file bkConfigurationJson=bk-configuration.json \
    --version 0.21.0 \ #version:service-discovery-process
    vorijk/service-discovery-process

helm upgrade --install bk-management-process \
    --namespace testorganisatie \
    --set gateway.name=CHANGE_THE_GATEWAY_NAME \
    --set gateway.namespace=CHANGE_THE_GATEWAY_NAMESPACE \
    --set gateway.sectionName=CHANGE_THE_GATEWAY_SECTION_NAME \
    --set gateway.hostname=management-api.testorganisatie.demo.mijn-betaaloverzicht.nl \
    --set env[0].name=SCHEME_DISCOVERY_URL \
    --set env[0].value="https://api.stelsel.demo.mijn-betaaloverzicht.nl" \
    --set env[1].name=SCHEME_ROOT_PUBLIC_KEY \
    --set env[1].value="CHANGE_THE_SCHEME_ROOT_PUBLIC_KEY" \
    --set env[2].name=BK_CONFIG_SERVICE_ADDRESS \
    --set env[2].value="http://bk-config-service:8008" \
    --set env[3].name=ORGANIZATION_NAME \
    --set env[3].value="Testorganisatie [Demo]" \
    --set env[4].name=ORGANIZATION_OIN \
    --set env[4].value="CHANGE_THE_ORGANIZATION_OIN" \
    --set env[5].name=ORGANIZATION_DISCOVERY_URL \
    --set env[5].value="https://testorganisatie.demo.mijn-betaaloverzicht.nl/.well-known/bk-configuration.json" \
    --set env[6].name=ORGANIZATION_ROLE \
    --set env[6].value="SOURCE_ORGANIZATION" \
    --version 0.20.5 \ #version:bk-management-process
    vorijk/bk-management-process

helm upgrade --install citizen-financial-claim-process \
    --namespace testorganisatie \
    --set gateway.name=CHANGE_THE_GATEWAY_NAME \
    --set gateway.namespace=CHANGE_THE_GATEWAY_NAMESPACE \
    --set gateway.sectionName=CHANGE_THE_GATEWAY_SECTION_NAME \
    --set gateway.hostname=financial-claim-request-api.testorganisatie.demo.mijn-betaaloverzicht.nl \
    --version 0.23.2 \ #version:citizen-financial-claim-process
    vorijk/citizen-financial-claim-process

helm upgrade --install demo-simulation-process \
    --namespace testorganisatie \
    --set gateway.name=CHANGE_THE_GATEWAY_NAME \
    --set gateway.namespace=CHANGE_THE_GATEWAY_NAMESPACE \
    --set gateway.sectionName=CHANGE_THE_GATEWAY_SECTION_NAME \
    --set gateway.hostname=demo-simulation-api.testorganisatie.demo.mijn-betaaloverzicht.nl \
    --version 0.19.3 \ #version:demo-simulation-process
    vorijk/demo-simulation-process

helm upgrade --install hsm-process \
    --namespace testorganisatie \
    --set gateway.name=CHANGE_THE_GATEWAY_NAME \
    --set gateway.namespace=CHANGE_THE_GATEWAY_NAMESPACE \
    --set gateway.sectionName=CHANGE_THE_GATEWAY_SECTION_NAME \
    --set gateway.hostname=hsm-api.testorganisatie.demo.mijn-betaaloverzicht.nl \
    --version 0.2.0 \ #version:hsm-process
    vorijk/hsm-process

helm upgrade --install bk-management-ui \
    --namespace testorganisatie \
    --set gateway.name=CHANGE_THE_GATEWAY_NAME \
    --set gateway.namespace=CHANGE_THE_GATEWAY_NAMESPACE \
    --set gateway.sectionName=CHANGE_THE_GATEWAY_SECTION_NAME \
    --set gateway.hostname=beheer.testorganisatie.demo.mijn-betaaloverzicht.nl \
    --set config.bkManagementAddress="https://management-api.testorganisatie.demo.mijn-betaaloverzicht.nl/v1" \
    --set config.hsmAddress="https://hsm-api.testorganisatie.demo.mijn-betaaloverzicht.nl/v1" \
    --version 0.23.2 \ #version:bk-management-ui
    vorijk/bk-management-ui

Dit voorbeeld bevat 2 componenten die wij voor de demo omgeving gebruiken om data te simuleren. Deze componenten zijn demo-source-system en demo-simulation-process. In plaats hiervan dient elke bronorganisatie een eigen component welke de Financial claims information document retourneert. Dat component dient de OpenAPI specificatie van het mock-source-system te implementeren.

Toch aan de slag met de demo-source-system? Bekijk dan de volgende scripts om de demo-source-system te voorzien van data, inclusief de bijbehorende json bestanden:

• cjib-0-reset.sh
• cjib-1-initieel.sh
• cjib-2-achterstand.sh
• cjib-3-aanmaning.sh
• cjib-4-betaald.sh