beaker

README

Overview

Beaker is a demonstration project that shows how to build a production-ready microservice API. It includes structured request handling, streaming support, service discovery, health checks, and observability features, giving teams a practical foundation for building scalable systems.

Project Goals

• Showcase the components needed to build and run a modern production quality microservice.
• Build our system in go using the NATS service protocol, and a Postgres database.
• Discuss use of standards, and how they help guide our development.
• Demonstrate tooling used to help accelerate developer productivity when building with these tools
• Provide observability hooks for health checks and metrics.
• Show best practice developer-friendly local development via Github Codespaces and devcontainers.

Each episode covers one of the following topics

• High Level architecture
• Devlopment environment
• Open Telemetry Setup
• Database Layer
• API Layer

Development environment setup

• Start a codespace
• After startup complete run make bootstrap