datahub_watchtower 0.1.0

A service for log and event collection within a datahub deployment.

DataHub Watchtower

This application is part of the DataHub Project.
https://datahubproject.net

DataHub is a Cloud Development Ecosystem aiming to bring the power of Dart into the Cloud.

DataHub is still under development and is not to be considered production ready. Comprehensive documentation is yet to be released.

---

Configuration

This service requires at least one configuration file. Provide the configuration file as command line argument. You can split configuration files (f.e. config / secrets) into multiple files and provide every separate file as an argument.

You can find the debug configuration file here: resources/debug.yaml

Run Service in Dart VM

Dart code can be executed without compiling.

Requirements

• Dart ≥ 2.17 (Setup)

Get Dependencies

$ dart pub get

Run Code Generator

$ dart run build_runner build

Run

$ dart run bin/datahub_watchtower.dart resources/debug.yaml

Compile and Run

Compiled code runs faster, so this is the preferred method for deployment. The resulting executable will be named bin/datahub_watchtower.exe.
The file extension is exe on linux or mac too, don't worry about it.

Requirements

• Dart ≥ 2.17 (Setup)

Get Dependencies

$ dart pub get

Run Code Generator

$ dart run build_runner build

Compile

$ dart compile exe bin/datahub_watchtower.dart

Run

$ ./bin/datahub_watchtower.exe

Build Debug Docker Image

Requirements

• Docker ≥ 1.8 (Setup)

This image will run the service in the vm. Code generation must be done on the host machine first. The image will build very fast (no compile time) but the service itself will run a little slower.
This is only recommended for development / testing purposes.

The resulting docker image will use the debug configuration: resources/debug.yaml.

Get Dependencies

$ dart pub get

Build using DataHub CLI

DataHub CLI will run the code generator, build the debug docker image and automatically tag it as datahub_watchtower:debug.

Build

$ datahub build -d

Build using Docker CLI

When building debug images manually, make sure to run code generation first:

Run Code Generator

$ dart run build_runner build

Build

$ docker build -t datahub_watchtower:debug -f Dockerfile.debug .

Build Release Docker Container

Requirements

• Docker ≥ 1.8 (Setup)

The resulting docker image will expect a config file at /app/config.yaml. Best practice is to provide this config file via bind mount (Docker) or ConfigMap / Secrets (Kubernetes).

Build using DataHub CLI

DataHub CLI will build the release docker image and automatically and tag it as datahub_watchtower:latest and datahub_watchtower:{version}.

Build

$ datahub build

Build using Docker CLI

Build and Tag

$ docker tag datahub_watchtower:latest datahub_watchtower:{version}
$ docker build -t datahub_watchtower:latest .