RIALTO Entity Resolver

Use this service if you want to resolve some properties about an entity to a known URI. If the entity is not found in RIALTO, one will be created.

Generate server

NOTES:

• Only do this when you change swagger.yml!
• To install swagger: go get -u -v github.com/go-swagger/go-swagger/cmd/swagger

rm -r generated/*
swagger generate server -t generated --exclude-main

Run Server

Blazegraph

For local development, you'll need to install and run Blazegraph locally. To spin up Blazegraph as a local SPARQL endpoint, follow the Blazegraph quick start. It should be as simple as

java -server -Xmx4g -jar blazegraph.jar

Upon starting, Blazegraph should output some startup information to the console. You'll need to capture the serviceURL for use with RIALTO Entity Resolver, as referenced below. The default Blazegraph port, included in the serviceURL, is 9999.

Running a local (non-containerized) server

API_KEY=abc123 SPARQL_ENDPOINT=<serviceURL>/blazegraph/namespace/kb/sparql go run cmd/server/main.go --port 3001

If this command bombs out, you may need to run dep ensure first to ensure you've got all the resolver's dependencies in place.

Make a request

Make sure to pass in the API key specified in the API_KEY environment variable when the server was started.

curl -H "X-API-Key: abc123" "http://localhost:3001/person?last_name=Giarlo&first_name=Mike&orcid=0000-0002-2100-6108&sunetid=mjgiarlo"

Docker

Build

docker build -t suldlss/rialto-entity-resolver:latest .

Run

docker run -p 3000:3000 \
-e SPARQL_ENDPOINT=<serviceURL>/blazegraph/namespace/kb/sparql \
-e API_KEY=<key> \
suldlss/rialto-entity-resolver:latest

Deploy

docker push suldlss/rialto-entity-resolver:latest

Testing

go test ./...