MOD Data Collection Consumer Specifications

This project provides a convenient way to control the lifecycle for different stream provider configurations and makes it easy to execute data collector specifications.

For more information about Data Collector, please refer to the Data Collector documentation.

Pre-requisite

Business SSL bundles are required for service authentication. The bundles must be placed under certs directory.

/certs
├── ske-test-certs (bundle)
│   ├── secret.properties
│   ├── testauth-key.pem
│   └── testauth-public.pem
├── toll-test-certs  (bundle)
│   ├── secret.properties
│   ├── testauthcert-key.pem
│   └── testauthcert-public.pem

🔑 Cert-bundles can be provided by Team Innsamling.

Use

Getting available targets

make

Run target

make TARGET

💡 tail the running container-log in a separate terminal window.

Docker Compose Lifecycle

⚠️ only one target provider can be run at a given time!

Filesystem Stream Provider

💡 Filesystem is a recommended provider for test purposes.

Target	Description
pull-filesystem	Pull images
start-filesystem	Start filesystem
stop-filesystem	Stop postgres
remove-filesystem	Remove postgres
collect-enheter-test	enhetsregister collection test

Postgres Stream Provider

💡 Postgres is a recommended provider for test purposes.

Target	Description
pull-postgres	Pull images
start-postgres	Start postgres
tail-postgres	Tail docker log
stop-postgres	Stop postgres
stop-postgres-clean	Stop postgres and remove anonymous volumes
remove-postgres	Remove postgres
open-postgres-adminer	Open a web based DB admin tool in your browser

GCS Stream Provider

💡 Copy profile/gcs/conf/application.properties.sample to profile/gcs/conf/application.properties and configure gcs.bucket-name. The GCS secret must be placed under certs/gcs-secret/gcs_sa_test.json.

Target	Description
pull-gcs	Pull images
start-gcs	Start gcs
tail-gcs	Tail docker log
stop-gcs	Stop gcs
stop-gcs-clean	Stop gcs and remove anonymous volumes
remove-gcs	Remove gcs
open-gcs-adminer	Open a web based DB admin tool in your browser

Kafka Stream Provider

⚠️ The Kafka provider IS NOT a deployment target for MOD Sirius.

Target	Description
pull-kafka	Pull images
start-kafka	Start kafka
tail-kafka	Tail docker log
stop-kafka	Stop kafka
stop-kafka-clean	Stop kafka and remove anonymous volumes
remove-kafka	Remove kafka

Build Data Collector Dev Image

Dev images requires full checkout of the data-collector-project repo.

Target	Description
build-data-collector-dev-image	Build data collector dev image

Postgres Dev Stream Provider

Target	Description
start-postgres-dev	Start postgres-dev
tail-postgres-dev	Tail docker log
stop-postgres-dev	Stop postgres-dev
stop-postgres-dev-clean	Stop postgres-dev and remove anonymous volumes
remove-postgres-dev	Remove postgres-dev

GCS Dev Stream Provider

💡 Copy profile/gcs/conf/application.properties.sample to profile/gcs/conf/application.properties and configure gcs.bucket-name. The GCS secret must be placed under certs/gcs-secret/gcs_sa_test.json.

Target	Description
start-gcs-dev	Start gcs-dev
tail-gcs-dev	Tail docker log
stop-gcs-dev	Stop gcs-dev
stop-gcs-dev-clean	Stop gcs-dev and remove anonymous volumes
remove-gcs-dev	Remove gcs-dev

Kafka Dev Stream Provider

Target	Description
start-kafka-dev	Start kafka-dev
tail-kafka-dev	Tail docker log
stop-kafka-dev	Stop kafka-dev
stop-kafka-dev-clean	Stop kafka-dev and remove anonymous volumes
remove-kafka-dev	Remove kafka-dev

Rawdata Producer (execute task)

Execute consumer specification on running data collector container

Target	Supplier	Description
collect-freg-playground	Skatteetaten	Collect freg playground
collect-freg-konsument-test	Skatteetaten	Collect freg konsument-test
collect-sirius-person-utkast	Skatteetaten	Collect sirius person utkast
collect-sirius-person-fastsatt	Skatteetaten	Collect sirius person fastsatt
collect-tvinn-test	Tolletaten	Collect tvinn test
collect-tvinn-test-api	Tolletaten	Collect tvinn test api (test backend #2)
collect-moveit-test	SSB	Collect files from MoveIt Automation Server (*)
collect-enheter-test	brreg	collect enheter from brreg open api

(*) MoveIt notice: copy and configure ./profile/postgres/conf/application-sample_moveit.properties to ./profile/postgres/conf/application-override.properties.

Management

Target	Description
list-tasks	List tasks
cancel-task	Cancel task
health	Health
health-all	Health all
health-alive	Health alive
health-ready	Health ready

Rawdata Consumer

Please refer to the Rawdata Client configuration in conf/application.properties for pub/sub details. Also refer to the Rawdata Client project for technical information.

References

• FREG documentation
• SIRIUS documentation