CyberAgent/typebook

Name: typebook

Owner: CyberAgent

Description: An Avro Schema Registry with MySQL backend.

Created: 2017-09-06 11:11:10.0

Updated: 2018-05-03 11:02:01.0

Pushed: 2018-04-30 18:07:36.0

Homepage:

Size: 154

Language: Scala

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

typebook

Registry server for persisting and managing data schemas defined in Avro's schema format.

Features

• Finagle/Finch based RestAPI implementation hosted on a Twitter HTTP Server
• store and retrieve schemas
• evolve schemas (supports semantic versioning, evolution rule definition and enforcement)
• RDBMS storage backend
• MySQL
• MariaDB

Requirements

• MySQL or MariaDB (Tested versions: MySQL 5.7 and MariaDB 10)

Quickstart

The easiest way to get started is running the service in a Docker container as follows:

cker-compose -f docker/docker-compose.yml up -d

This will start the typebook server in a container with Twitter Server Admin and MySQL server, exposing the service on port 8888. Once the service is up, interact with typebook using curl or any other HTTP clients.

Configurations

You can configure the connection to the backend database via the following environment variables.

| name | description | default | | ————– | ——————————————- | —————————- | | MYSQL_SERVERS | comma-separated database hostname and port | backend-db:3306 | | MYSQL_USER | database username | typebook | | MYSQL_PASSWORD | database user password | | | MYSQL_DATABASE | database name | registry

Deployment

Kubernetes

A helm chart is provided - please refer to chart/typebook for more details.

Marathon

An example marathon service spec file is available here. To deploy on DC/OS, use the following command:

os marathon app add examples/deploy/marathon/typebook.json

Please note that a backend database needs to be available and configured via environment variables beforehand.

API

API documentation for the typebook API are available here. A Swagger UI is provided as well - see here for more details.

Testing

To execute the test suite, run the following command in the directory containing build.sbt.

t test

Contributors

Thanks to all contributors!

• aberey
• potix2
• tsukaby
• saint1991

License

typebook is Open Source and available under the MIT License.