go-init

🚀 A production-ready Golang microservice starter kit.

📁 Project Structure

• cmd/ - Entrypoint binaries
• internal/ - Internal application logic
• pkg/ - Shared packages (e.g., logger)
• configs/ - Configuration files
• deployments/ - Docker, K8s manifests
• scripts/ - Dev or CI automation
• vendor/ - Vendored dependencies (if using go mod vendor)

🚀 Quick Start (Local)

make run

🐳 Docker

Build and Run:

docker build -t go-init .
docker run -p 8080:8080 go-init

Or use Docker Compose:

docker-compose up --build

App will be available at http://localhost:8080

Prometheus

Prometheus is included and scrapes metrics from /metrics.

• Prometheus UI: http://localhost:9090
• App metrics: http://localhost:8080/metrics

⚙️ Config

Settings are loaded from a .env file.

Example .env

PORT=8080
LOG_LEVEL=debug

🧪 Health

GET /healthz

Returns 200 OK with body ok.

📈 Metrics

GET /metrics

Prometheus-compatible metrics including:

• http_requests_total
• http_request_duration_seconds