Docker commands en configuratie

Postgres database server

De postgres database server kan als volgt worden opgestart. De postgres docker image biedt ook mogelijkheden voor optionele configuratie.

docker run \
    -e POSTGRES_PASSWORD=SECRET_POSTGRES_PASSWORD \
    postgres

bk-config-db

Het bk-config-db kan geconfigureerd worden met een aantal environment variables

Het bk-config-db component kan gestart worden met behulp van docker:

docker run \
    -e PGHOST="postgres-host" \
    -e PGPORT="5432" \
    -e PGSSLMODE="require" \
    -e PGUSER="postgres-user" \
    -e PGPASSWORD="SECRET_POSTGRES_PASSWORD" \
    -e PGDATABASE="bk_config_db" \
    registry.gitlab.com/blauwe-knop/vorderingenoverzicht/bk-config-db

Toelichting op de configuratie:

Parameter	Toelichting
PGHOST	Moet ingesteld staan op het intern adres waar de postgres database server van de bronorganisatie bereikbaar is.
PGPORT	Moet ingesteld staan op de poort waar de postgres database server van de bronorganisatie bereikbaar is.
PGSSLMODE	Moet ingesteld staan op de SSL mode waarmee er ingelogd kan worden op de postgres database server van de bronorganisatie. Mogelijke waarden: require,disable,verify-ca,verify-full
PGUSER	Moet ingesteld staan op de gebruikersnaam waarmee er ingelogd kan worden op de postgres database server van de bronorganisatie.
PGPASSWORD	Moet ingesteld staan op het wachtwoord waarmee er ingelogd kan worden op de postgres database server van de bronorganisatie.
PGDATABASE	Moet ingesteld staan op `bk_config_db`.

Een voorbeeld helm chart is beschikbaar op GitLab

bk-config-service

Het bk-config-service kan geconfigureerd worden met een aantal environment variables

Het bk-config-service component kan gestart worden met behulp van docker:

docker run -p 8082:80 \
    -e API_KEY="SECRET_API_KEY" \
    -e BK_CONFIG_DB_HOST="postgres-host" \
    -e BK_CONFIG_DB_USERNAME="postgres-user" \
    -e BK_CONFIG_DB_PASSWORD="SECRET_POSTGRES_PASSWORD" \
    registry.gitlab.com/blauwe-knop/vorderingenoverzicht/bk-config-service

Toelichting op de configuratie:

Parameter	Toelichting
API_KEY	Moet ingesteld staan op een geheime API key waarmee de andere componenten toegang kunnen krijgen tot deze service.
BK_CONFIG_DB_HOST	Moet ingesteld staan op het intern adres waar de postgres database server van de bronorganisatie bereikbaar is.
BK_CONFIG_DB_USERNAME	Moet ingesteld staan op de gebruikersnaam waarmee er ingelogd kan worden op de postgres database server van de bronorganisatie.
BK_CONFIG_DB_PASSWORD	Moet ingesteld staan op het wachtwoord waarmee er ingelogd kan worden op de postgres database server van de bronorganisatie.

Een voorbeeld helm chart is beschikbaar op GitLab

bk-management-process

Het bk-management-process kan geconfigureerd worden met een aantal environment variables

Het bk-management-process component kan gestart worden met behulp van docker:

docker run -p 8080:80 \
    -e SCHEME_DISCOVERY_URL="https://demo-scheme-manager-scheme-process" \
    -e BK_CONFIG_SERVICE_ADDRESS="http://bk-config-service" \
    -e BK_CONFIG_SERVICE_API_KEY="SECRET_BK_CONFIG_SERVICE_API_KEY" \
    -e ORGANIZATION_NAME="Demo Organization" \
    -e ORGANIZATION_OIN="00000000000000000001" \
    -e ORGANIZATION_DISCOVERY_URL="https://demo-organization-service-discovery-process" \
    -e ORGANIZATION_LOGO_URL="https://demo-organization-logo-url" \
    registry.gitlab.com/blauwe-knop/vorderingenoverzicht/bk-management-process

Toelichting op de configuratie:

Parameter	Toelichting
SCHEME_DISCOVERY_URL	Moet ingesteld staan op het extern adres waar het `scheme-process` component van de stelselbeheerder bereikbaar is. De url van de Vorderingenoverzicht Rijk Demo omgeving is `https://api.stelsel.vorijk-demo.blauweknop.app/v1`.
BK_CONFIG_SERVICE_ADDRESS	Moet ingesteld staan op het interne adres waar het `bk-config-service` component van de bronorganisatie bereikbaar is.
BK_CONFIG_SERVICE_API_KEY	Moet ingesteld staan op de API key waarmee `bk-management-process` toegang kan krijgen tot het `bk-config-service` van de bronorganisatie.
ORGANIZATION_NAME	Moet ingesteld staan op de naam van de bronorganisatie.
ORGANIZATION_OIN	Moet ingesteld staan op het organisatie-identificatienummer (OIN) van de bronorganisatie.
ORGANIZATION_DISCOVERY_URL	Moet ingesteld staan op het extern adres waar het `service-discovery-process` component van de bronorganisatie bereikbaar is.
ORGANIZATION_LOGO_URL	Moet ingesteld staan op de een url naar de logo van de bronorganisatie.

Helm chart

Een voorbeeld helm chart is beschikbaar op GitLab

bk-management-ui

Het bk-management-ui kan geconfigureerd worden met een aantal environment variables

Het bk-management-ui component kan gestart worden met behulp van docker:

docker run -p 8081:80 \
    -e BK_MANAGEMENT_URL="https://demo-organization-bk-management-process" \
    registry.gitlab.com/blauwe-knop/vorderingenoverzicht/bk-management-ui

Toelichting op de configuratie:

Parameter	Toelichting
BK_MANAGEMENT_URL	Moet ingesteld staan op het extern adres (intranet) waar het `bk-management-process` component van de bronorganisatie bereikbaar is.

Een voorbeeld helm chart is beschikbaar op GitLab

service-discovery-process

Het service-discovery-process kan geconfigureerd worden met een json bestand.

Creëer een map config, met daarin een bestand genaamd bk-configuration.json:

{
  "financialClaimRequestApi": {
    "v3": "https://demo-organization-citizen-financial-claim-process"
  },
  "sessionApi": {
    "v1": "https://demo-organization-session-process"
  }
}

Het service-discovery-process component kan gestart worden met behulp van docker:

docker run -p 8088:80 \
    -v "$PWD/config":/var/www/.well-known \
    registry.gitlab.com/blauwe-knop/vorderingenoverzicht/service-discovery-process

Een voorbeeld helm chart is beschikbaar op GitLab

session-service

Het session-service kan geconfigureerd worden met een aantal environment variables

Het session-service component kan gestart worden met behulp van docker:

docker run -p 8083:80 \
    -e API_KEY="SECRET_API_KEY" \
    registry.gitlab.com/blauwe-knop/vorderingenoverzicht/session-service

Toelichting op de configuratie:

Parameter	Toelichting
API_KEY	Moet ingesteld staan op een geheime API key waarmee de andere componenten toegang kunnen krijgen tot deze service.

Een voorbeeld helm chart is beschikbaar op GitLab

session-process

Het session-process kan geconfigureerd worden met een aantal environment variables

Het session-process component kan gestart worden met behulp van docker:

docker run -p 8084:80 \
    -e SESSION_SERVICE_ADDRESS="http://demo-organization-session-service" \
    -e SESSION_SERVICE_API_KEY="SECRET_SESSION_SERVICE_API_KEY" \
    -e BK_CONFIG_SERVICE_ADDRESS="http://demo-organization-bk-config-service" \
    -e BK_CONFIG_SERVICE_API_KEY="SECRET_BK_CONFIG_SERVICE_API_KEY" \
    registry.gitlab.com/blauwe-knop/vorderingenoverzicht/session-process

Toelichting op de configuratie:

Parameter	Toelichting
SESSION_SERVICE_ADDRESS	Moet ingesteld staan op het interne adres waar het `session-service` component van de bronorganisatie bereikbaar is.
SESSION_SERVICE_API_KEY	Moet ingesteld staan op de API key waarmee `session-process` toegang kan krijgen tot het `session-service` van de bronorganisatie.
BK_CONFIG_SERVICE_ADDRESS	Moet ingesteld staan op het interne adres waar het `bk-config-service` component van de bronorganisatie bereikbaar is.
BK_CONFIG_SERVICE_API_KEY	Moet ingesteld staan op de API key waarmee `session-process` toegang kan krijgen tot het `bk-config-service` van de bronorganisatie.

Een voorbeeld helm chart is beschikbaar op GitLab

financial-claim-request-db

Het financial-claim-request-db kan geconfigureerd worden met een aantal environment variables

Het financial-claim-request-db component kan gestart worden met behulp van docker:

docker run \
    -e PGHOST="postgres-host" \
    -e PGUSER="postgres-user" \
    -e PGPASSWORD="SECRET_POSTGRES_PASSWORD" \
    -e PGDATABASE="financial_claim_request_db" \
    registry.gitlab.com/blauwe-knop/vorderingenoverzicht/financial-claim-request-db

Toelichting op de configuratie:

Parameter	Toelichting
PGHOST	Moet ingesteld staan op het intern adres waar de postgres database server van de bronorganisatie bereikbaar is.
PGUSER	Moet ingesteld staan op de gebruikersnaam waarmee er ingelogd kan worden op de postgres database server.
PGPASSWORD	Moet ingesteld staan op het wachtwoord waarmee er ingelogd kan worden op de postgres database server.
PGDATABASE	Moet ingesteld staan op `financial_claim_request_db`.

Een voorbeeld helm chart is beschikbaar op GitLab

financial-claim-request-service

Het financial-claim-request-service kan geconfigureerd worden met een aantal environment variables

Het financial-claim-request-service component kan gestart worden met behulp van docker:

docker run -p 8085:80 \
    -e API_KEY="SECRET_API_KEY" \
    -e FINANCIAL_CLAIM_REQUEST_DB_HOST="postgres-host" \
    -e FINANCIAL_CLAIM_REQUEST_DB_USERNAME="postgres-user" \
    -e FINANCIAL_CLAIM_REQUEST_DB_PASSWORD="SECRET_POSTGRES_PASSWORD" \
    registry.gitlab.com/blauwe-knop/vorderingenoverzicht/financial-claim-request-service

Toelichting op de configuratie:

Parameter	Toelichting
API_KEY	Moet ingesteld staan op een geheime API key waarmee de andere componenten toegang kunnen krijgen tot deze service.
FINANCIAL_CLAIM_REQUEST_DB_HOST	Moet ingesteld staan op het intern adres waar de postgres database server van de bronorganisatie bereikbaar is.
FINANCIAL_CLAIM_REQUEST_DB_USERNAME	Moet ingesteld staan op de gebruikersnaam waarmee er ingelogd kan worden op de postgres database server van de bronorganisatie.
FINANCIAL_CLAIM_REQUEST_DB_PASSWORD	Moet ingesteld staan op het wachtwoord waarmee er ingelogd kan worden op de postgres database server van de bronorganisatie.

Een voorbeeld helm chart is beschikbaar op GitLab

mock-source-system (Voorbeeld van een bronsysteem API)

Het mock-source-system kan geconfigureerd worden met een aantal environment variables

Het mock-source-system component kan gestart worden met behulp van docker:

docker run -p 8087:80 \
    registry.gitlab.com/blauwe-knop/vorderingenoverzicht/mock-source-system

Toelichting op de configuratie:

Parameter	Toelichting

Een voorbeeld helm chart is beschikbaar op GitLab

citizen-financial-claim-process

Het citizen-financial-claim-process kan geconfigureerd worden met een aantal environment variables

Het citizen-financial-claim-process component kan gestart worden met behulp van docker:

docker run -p 8086:80\
    -e SCHEME_DISCOVERY_URL="https://demo-scheme-manager-scheme-process" \
    -e FINANCIAL_CLAIM_REQUEST_SERVICE_ADDRESS="http://demo-organization-financial-claim-request-service" \
    -e FINANCIAL_CLAIM_REQUEST_SERVICE_API_KEY="SECRET_FINANCIAL_CLAIM_REQUEST_SERVICE_API_KEY" \
    -e SESSION_SERVICE_ADDRESS="http://demo-organization-session-service" \
    -e SESSION_SERVICE_API_KEY="SECRET_SESSION_SERVICE_API_KEY" \
    -e BK_CONFIG_SERVICE_ADDRESS="http://demo-organization-bk-config-service" \
    -e BK_CONFIG_SERVICE_API_KEY="SECRET_BK_CONFIG_SERVICE_API_KEY" \
    -e SOURCE_SYSTEM_ADDRESS="https://demo-organization-discovery-url" \
    registry.gitlab.com/blauwe-knop/vorderingenoverzicht/citizen-financial-claim-process

Toelichting op de configuratie:

Parameter	Toelichting
SCHEME_DISCOVERY_URL	Moet ingesteld staan op het extern adres waar het `scheme-process` component van de stelselbeheerder bereikbaar is. De url van de Vorderingenoverzicht Rijk Demo omgeving is `https://api.stelsel.vorijk-demo.blauweknop.app/v1`.
FINANCIAL_CLAIM_REQUEST_SERVICE_ADDRESS	Moet ingesteld staan op het interne adres waar het `financial-claim-request-service` component van de bronorganisatie bereikbaar is.
FINANCIAL_CLAIM_REQUEST_SERVICE_API_KEY	Moet ingesteld staan op de API key waarmee `citizen-financial-claim-process` toegang kan krijgen tot het `financial-claim-request-service` van de bronorganisatie.
SESSION_SERVICE_ADDRESS	Moet ingesteld staan op het interne adres waar het `session-service` component van de bronorganisatie bereikbaar is.
SESSION_SERVICE_API_KEY	Moet ingesteld staan op de API key waarmee `citizen-financial-claim-process` toegang kan krijgen tot het `session-service` van de bronorganisatie.
BK_CONFIG_SERVICE_ADDRESS	Moet ingesteld staan op het interne adres waar het `bk-config-service` component van de bronorganisatie bereikbaar is.
BK_CONFIG_SERVICE_API_KEY	Moet ingesteld staan op de API key waarmee `session-process` toegang kan krijgen tot het `bk-config-service` van de bronorganisatie.
SOURCE_SYSTEM_ADDRESS	Moet ingesteld staan op het interne adres waar het `source-system` component van de bronorganisatie bereikbaar zijn.

Een voorbeeld helm chart is beschikbaar op GitLab

Postgres database server​

bk-config-db​

bk-config-service​

bk-management-process​

Helm chart​

bk-management-ui​

service-discovery-process​

session-service​

session-process​

financial-claim-request-db​

financial-claim-request-service​

mock-source-system (Voorbeeld van een bronsysteem API)​

citizen-financial-claim-process​

Postgres database server

bk-config-db

bk-config-service

bk-management-process

Helm chart

bk-management-ui

service-discovery-process

session-service

session-process

financial-claim-request-db

financial-claim-request-service

mock-source-system (Voorbeeld van een bronsysteem API)

citizen-financial-claim-process