Giter Club home page Giter Club logo

dn42regsrv's Introduction

dn42regsrv

A REST API for the DN42 registry, written in Go, to provide a bridge between interactive applications and registry data.

A public instance of the API and explorer web app can be accessed via:

Features

  • REST API for querying DN42 registry objects
  • Able to decorate objects with relationship information based on SCHEMA type definitions
  • Includes a simple webserver for delivering static files which can be used to deliver basic web applications utilising the API (such as the included DN42 Registry Explorer)
  • Automatic pull from the DN42 git repository to keep the registry up to date
  • Includes a responsive web app for exploring the registry
  • API endpoints for ROA data in JSON, and bird formats
  • API endpoint to support the creation of DNS root zone records

Building

Using locally installed go

Requires git and go

go get -insecure git.dn42.us/burble/dn42regsrv

Without installing go

Using container runtime to build with the golang container:

docker run -v ${PWD}:/go/bin golang go get -insecure git.dn42.us/burble/dn42regsrv

Or use the contrib/build.sh script after cloning the repo.

Running

As a service

Use --help to view configurable options

${GOPATH}/bin/dn42regsrv --help

The server requires access to a clone of the DN42 registry and for the git executable to be accessible.
If you want to use the auto pull feature then the registry must also be writable by the server.

cd ${GOPTH}/src/git.dn42.us/burble/dn42regsrv
git clone http://git.dn42.us/dn42/registry.git
${GOPATH}/dn42regsrv

A sample service file is included for running the server under systemd

Within a container

A container build script (contrib/buildah.sh) is included in the contrib directory. The script uses buildah.

See the contrib/entrypoint.sh script for environment variables that can be set when running the container.

Using

By default the server will be listening on port 8042.
See the API.md file for a detailed description of the API.

Support

Please feel free to raise issues or create pull requests for the project git repository.

#ToDo

Server

  • Add WHOIS interface

DN42 Registry Explorer Web App

  • Allow for attribute searches

dn42regsrv's People

Contributors

elburb avatar doxzbob avatar

Stargazers

Minty avatar Brandon Lopez avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.