This keeps the infrastructure that builds docker images for GraphDB

Check Docker Hub Images for information on how to use the images.

Building a docker image

You will need docker and make installed on your machine.

1. Checkout this repository
2. Run

make build-image VERSION=<the-version-that-you-want>

for example the most recent version as of this writing is 10.7.1 so run

make build-image VERSION=10.7.1

this will build an image that you can use called ontotext/graphdb:10.7.1 You can run the image now with

docker run -d -p 7200:7200 ontotext/graphdb:10.7.1

Consult the docker hub documentation for more information.

Preload a repository using preload tool (optional)

You can preload some data using the 'preload' tool. This tool and other command line tools (https://graphdb.ontotext.com/documentation/10.7/command-line-tools.html) can be used only when GraphDB is stopped. In order to use one of them in docker, stop your current GraphDB instance.

Mount a folder that you would like to use as a GraphDB home folder, using -v option, as well as the data that you would like to preload. As GraphDB's docker image endpoint by default is GraphDB's application it has to be overridden like so:

docker run -v ./graphdb-data:/opt/graphdb/home -v ./preload:/opt/graphdb-import --entrypoint /opt/graphdb/dist/bin/importrdf ontotext/graphdb:10.7.1 -Dgraphdb.home=/opt/graphdb/home preload --force --recursive -q /tmp -c /opt/graphdb-import/graphdb-repo.ttl /opt/graphdb-import/import

This will run the preload tool, create a repository and import the data from ./preload/import. After that, the same folder ./graphdb-data can be mounted in a container and used as a GraphDB's home folder.

Using docker-compose

Preload a repository using preload tool (optional)

Go to the preload folder to run the bulk load data when GraphDB is stopped.

cd preload

By default it will:

• Create or override a repository defined in the graphdb-repo-config.ttl file (can be changed manually in the file, default is demo)
• Upload a test ntriple file from the preload/import subfolder.

See the GraphDB preload documentation for more details.

When running the preload docker-compose various parameters can be provided in the preload/.env file:

GRAPHDB_VERSION=10.7.1
GRAPHDB_HEAP_SIZE=3g
GRAPHDB_HOME=../graphdb-data
REPOSITORY_CONFIG_FILE=./graphdb-repo.ttl

Build and run:

docker-compose build
docker-compose up -d

At this point the preload tool has preloaded the provided data in ../graphdb-data.

Go back to the root of the git repository to start GraphDB:

cd ..

Start GraphDB

To start GraphDB run the following from the root of the git repository:

docker-compose up -d --build

It will use the repo created by the preload in graphdb-data/

Feel free to add a .env file similar to the preload repository to define variables.

Issues

You can report issues in the GitHub issue tracker or at graphdb-support at ontotext.com

Contributing

You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.

Before you start to code, we recommend discussing your plans through a GitHub issue, especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.