nuts-registry

Distributed registry for storing and querying health care providers their vendors and technical endpoints.

The registry is written in Go and should be part of nuts-go as an engine.

Dependencies

This projects is using go modules, so version > 1.12 is recommended. 1.10 would be a minimum.

Running tests

Tests can be run by executing

go test ./...

Building

This project is part of https://github.com/nuts-foundation/nuts-go. If you do however would like a binary, just use go build.

The server and client API is generated from the open-api spec:

oapi-codegen -generate types,server,client -package api docs/_static/nuts-registry.yaml > api/generated.go

Generating Mocks

These mocks are used by other modules

mockgen -destination=mock/mock_client.go -package=mock -source=pkg/registry.go
mockgen -destination=pkg/network/mock.go -package=network -source=pkg/network/ambassador.go
mockgen -destination=mock/mock_db.go -package=mock -source=pkg/db/db.go

README

The readme is auto-generated from a template and uses the documentation to fill in the blanks.

./generate_readme.sh

This script uses rst_include which is installed as part of the dependencies for generating the documentation.

Documentation

To generate the documentation, you'll need python3, sphinx and a bunch of other stuff. See :ref:`nuts-documentation-development-documentation` The documentation can be build by running

/docs $ make html

The resulting html will be available from docs/_build/html/index.html

Configuration

Sync modes

The registry supports two modes for updating the internal Db: a file system watcher (fs) or downloading from Github (github). When using Github, the registry checks every syncInterval minutes if anything has changed on Github. The syncAddress must point to a tar.gz with the needed registry files included. Github has a nice URL for this. By default it uses the config in the master branch.

Parameters

The following configuration parameters are available for the registry:

Key	Default	Description
address	localhost:1323	Interface and port for http server to bind to, default: localhost:1323
clientTimeout	10	Time-out for the client in seconds (e.g. when using the CLI), default: 10
datadir	./data	Location of data files, default: ./data
mode		server or client, when client it uses the HttpClient, default:
organisationCertificateValidity	365	Number of days organisation certificates are valid, default: 365
syncAddress	https://codeload.github.com/nuts-foundation/nuts-registry-development/tar.gz/master	The remote url to download the latest registry data from, default: https://codeload.github.com/nuts-foundation/nuts-registry-development/tar.gz/master
syncInterval	30	The interval in minutes between looking for updated registry files on github, default: 30
syncMode	fs	The method for updating the data, 'fs' for a filesystem watch or 'github' for a periodic download, default: fs
vendorCACertificateValidity	1095	Number of days vendor CA certificates are valid, default: 1095

As with all other properties for nuts-go, they can be set through yaml:

registry:
   datadir: ./data

as commandline property

./nuts --registry.datadir ./data

Or by using environment variables

NUTS_REGISTRY_DATADIR=./data ./nuts