Databus Gitbook
Databus
Databus
  • Overview
  • Guides
    • Data Publishing
    • Data Download
  • Use Cases
    • Data Version Control
    • Populating Database with Data
    • Data Quality Control
    • Data Crawling
    • Automated Deployment
    • Building Data Repositories
  • Organising Your Data (Model)
    • How to Organise Your Data
    • URI Design
    • Versioning
    • Metadata
      • Group
      • Artifact
      • Version
      • Distribution
      • Collection
    • Content Variants
    • Persistence (HowTo)
  • Usage
    • Quickstart Examples (Publish, Download)
    • Web Interface
      • Publish
      • Collections
      • Auto-Completion
    • API
    • Databus Mods
    • Databus Client
    • Integration with CI (Jenkins)
  • Running Your Own Databus Server
    • Run with Docker
    • Configuration
    • HTTPS & Proxy Setup
  • Development Environment
Powered by GitBook
On this page
  • Requirements
  • Clone Repository & Prepare for Development
  • Building the Databus Docker Image
  • Starting the Databus Locally
  • Starting the Databus Environment
  • Starting the Databus Server

Development Environment

Requirements

  • node.js: v16.13.0 or higher

# see https://github.com/nodesource/distributions/blob/master/README.md
# Using Ubuntu
curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt-get install -y nodejs
  • npm: 7.24.0 or higher

sudo npm install -g npm@latest
  • docker: 20.10.2 or higher

  • docker-compose: 1.25.0 or higher

sudo apt-get install docker docker-compose
  • php: v8.1.0 or higher

sudo apt install php-cli
  • java

Clone Repository & Prepare for Development

git clone https://github.com/dbpedia/databus.git
cd databus
  • git hook to automatically add files (generated by model-docu/model.php) to commits

cd .git/hooks
ln -s ../../.githooks/pre-commit pre-commit
cd ../..

Building the Databus Docker Image

The following instructions will build the docker image for the Databus Server. Only do this if you want to run the Databus as a dockerized application. If you want to run the Databus without docker, you can skip this section.

bash build-docker-image.sh

The build-docker-image.sh script will install all npm dependencies for the server and webclient and build the docker image for the Databus application.

Starting the Databus Locally

Starting the Databus Environment

Go to the devenv directory of the repository and start the database and lookup search containers

make env-build
make env-start

You can restart these containers using make env-restart. Additionally, there is a make instruction for a restart with database wipe (make env-clean-start)

Starting the Databus Server

First, install all dependencies by running:

make srv-install

Then run either:

make srv-start-auth0

or

make srv-start_dbpedia_keycloak

Each script contains a different configuration for a specific OIDC provider (Auth0 with Google Auth or DBpedia Login)

PLEASE NOTE: The sample OIDC providers are a development setup and should never be used in production. Please use your own OIDC provider for authentication in production.

PreviousHTTPS & Proxy Setup

Last updated 1 year ago