go-microservice-mongo

Golang archetype oriented to microservices.

Dependencies

Golang, Docker, Make, Swag tool

Features

• Architecture
  • Handlers, respositories and services
  • Custom Messages and Errors
  • Pagination and Ordering
• Go 1.23 (at the moment)
• Libraries
  • Web: Fiber
  • OAuth2: Gocloak
  • Validations: Go Playground Validator
  • Unit Test: Testify
  • DB: MongoDB
  • Tracing: Opentelemetry
  • Test: Testcontainers
  • OpenAPI: Fiber Swagger
  • Environment: Godot
• Keycloak as Auth Server
• Distributed tracing
  • OpenTelemetry, Micrometer and Jaeger
• Swagger
  • Swaggo & Fiber Swagger
  • Customized with command make swagger (OAuth2 server by parameter and not static)
• Custom Auditory
• Database
  • MongoDB for the app
  • Testcontainers for testing

Files

• Dockerfile
• Ship files
  • For those using Neovim and this plugin

Usage

• Executing make help all the available commands will be listed.
• Also the standard Go commands could be used, like go run main.go
• To use this archetype with a different name, execute this command to replace the names:

find . -type f -exec sed -i 's/go-microservice-mongo/your-project-name/g' {} +

Postgres instead of MongoDB

• Postgres repo contains version with Postgres

Donate

• Bitcoin (QR) 1GqdJ63RDPE4eJKujHi166FAyigvHu5R7v
• Paypal