Racetrack

Racetrack is a framework for deploying, managing, and serving application workloads.

Features

Racetrack uses the notion of conventions to allow domain experts to produce operationally sound and effective workloads without understanding the underlying infrastructure.

It makes extensive use of plugins. Thus, the type of code which it can accept is broad and covers languages such as Python 3 or Go, and actual applications such as Sphinx, Drupal or even Quake 3.

These "jobs", in Racetrack lingo, can be deployed to different "infrastructure targets". We currently support Kubernetes and Docker. This is also pluggable and can be extended.

Code deployed via Racetrack gets free Swagger pages and Prometheus metrics endpoints.

What distinguishes Racetrack is:

• You only supply your function's logic. No need to write repetitive API code, setting up webservers, creating dockerfiles, kubernetes YAMLs, and so on. Racetrack takes care of that for you.
• Language agnostic. Deploy code written in Python 3, Go, Rust, or anything else encapsulated in a Dockerfile.
• Infrastructure independent. Deploy to either a Kubernetes cluster or a Docker environment in a single transparent step.

Example usage

Given a Python file like this:

class Meow:
    def perform(self, a, b):
        """Add numbers"""
        return a + b

And a YAML file like this:

name: adder
owner_email: meowmeow@example.com
lang: python3:latest

git:
  remote: https://www.github.com/path/to-repo.git

python:
  entrypoint_path: 'adder.py'
  entrypoint_class: 'Meow'

You can

racetrack deploy

And the result is a micro-service with an API:

which can be monitored on a dashboard:

or called with a curl command:

Getting started

Depending on your role, you may be insterested in different documents:

• Racetrack User:

  • Quickstart
  • User Manual
  • User Guide - Deploying a Job
  • Available plugins
  • Installing plugins
  • Job Manifest File Schema
  • Glossary

• Racetrack Admin:

  • Local Kubernetes Setup
  • Installation to standalone host
  • Installation to Kubernetes

• Racetrack Developer:

  • Developing plugins
  • Job type plugins
  • Developer manual

See the Documentation Pages for more details.

Currently supported

What can we deploy?

• Python 3
• Go
• Rust
• Any language wrapped in a Dockerfile
• HUGO framework
• Drupal
• Sphinx
• Quake III

Where can we deploy to?

• local Kubernetes
• local Docker
• remote Docker Daemon
• remote Kubernetes

About

This software is copyright Erhvervsstyrelsen. It is published under the Apache 2.0 License. See Copyright Notices.

This project is a collaboration between The Danish Business Authority and deepsense.ai.