https://github.com/ericbutera/amalgam

Tech demo featuring microservices, golang, orchestration and observability
https://github.com/ericbutera/amalgam

devx golang graphql grpc k6 lgtm microservices mysql nextjs observability orchestration tilt

Last synced: 20 days ago
JSON representation

Tech demo featuring microservices, golang, orchestration and observability

• Host: GitHub
• URL: https://github.com/ericbutera/amalgam
• Owner: ericbutera
• Created: 2024-10-09T22:58:24.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2024-10-24T21:52:00.000Z (2 months ago)
• Last Synced: 2024-10-24T22:22:54.964Z (2 months ago)
• Topics: devx, golang, graphql, grpc, k6, lgtm, microservices, mysql, nextjs, observability, orchestration, tilt
• Language: Go
• Homepage:
• Size: 4.64 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Amalgam

Tech demo of a modern web application stack.

## Goals

- Developer Experience: Spin up the entire stack with a single command.

- Local-First Development: Everything runs locally for true production parity—no surprises.

- Integrated Observability: Built-in o11y from the start, not an afterthought.

## Technologies

- Kubernetes: The backbone for modern orchestration.

- GraphQL: A powerful API layer for flexible, efficient data fetching.

- Golang: Performance and simplicity at scale.

- Temporal: Resilient workflows made easy.

- Grafana LGTM Stack: Observe, debug, and improve with confidence.

- Next.js + TypeScript: A delightful developer experience for building blazing-fast, modern UIs.

- MySQL: The trusted relational database powering countless applications.

## Prerequisites

1. [docker](https://docs.docker.com/get-docker/)

2. [tilt.dev](https://tilt.dev/)

## Run

```sh

tilt up

# open tilt ui @ http://localhost:10350

```

## Development

[Development](./docs/development.md) contains an overview of how to develop the various components of the application.

## Architecture

[Architecture](./docs/architecture.md) contains an overview of how to convert a project from a monolith to a microservices architecture.

## Code Generation

One of the major goals of this project is to show how to quickly build integrations. Part of that is utilizing code generation to lower the amount of code that needs to be written and maintained. More information can be found in the [Code Generation](./docs/code-generation.md) document.

## Testing

[Testing](./docs/testing.md) contains an overview of how to test the various components of the application.

## CI/CD

Github Actions can be found in the [.github/workflows](./.github/workflows) directory. You can run them locally using [act](https://github.com/nektos/act).