sandbox

sandbox

A toy Go microservice intended for use as reference material.

Features

• Uses a directory structure (mostly) adherent to clean architecture.
• API provided by ConnectRPC, validation using protovalidate, Buf generated, reflection enabled.
• Database provided by PostgreSQL, UUIDv7 for primary keys, Jet for SQL query building.
• OpenTelemetry Metrics and Tracing, standardised metrics and attributes whenever possible.
• Logging using log/slog.
• Runtime configuration via Koanf.
• Grafana (with version-controlled dashboards), VictoriaMetrics and Jaeger for observability.
• CI using GitHub actions, with Zizmor for linting.
• Vulnerability and License scanning using Trivy.
• Secret scanning using Gitleaks.
• Dependency updates from Dependabot.
• Packaged using Docker containers, developed with Docker Compose.

Sanity tests

# success
echo '{}' | grpc-client-cli -a localhost:5000 -s Health -m Check

# invalid argument
echo '{}' | grpc-client-cli -a localhost:5000 -s ExampleService -m CreateResource

# success (create)
echo '{"resource":{"name":"example"}}' | \
	grpc-client-cli -a localhost:5000 -s ExampleService -m CreateResource

# success (bulk create)
for i in {1..100}; do
	echo "{\"resource\":{\"name\":\"example-$i\"}}" | \
		grpc-client-cli -a localhost:5000 -s ExampleService -m CreateResource
done

# success (list)
echo '{}' | grpc-client-cli -a localhost:5000 -s ExampleService -m ListResources