GHOST

Go High-level Open Service Templater

GHOST creates in output dir fully functional microservice code with basic functionality:

• Ready to use Makefile with help target
• Ready to use docker-compose with override template
• Ready to use security checks by trivy, semgrep and govulncheck
• Kubernetes lifecycle compatible health checks
• Log level changing by HTTP-request
• Easy configurable logs (plain text|JSON)
• Mask sensitive config data in logs
• Graceful shutdown

Usage

Note

Output directory (relative or absolute). Files will be created at paths relative to this directory. Existing files at target paths will be overwritten.

Help

$ ghost -h
Usage: ghost [options...] [arguments...]

OPTIONS
  -d, --description        <string>    (default: Go microservice)                Project short description
  -g, --go-image           <string>    (default: nafigat0r/go:1.26.0)            Go docker image
  -c, --govulncheck-image  <string>    (default: nafigat0r/govulncheck:1.1.4)    Govulncheck docker image
  -h, --help                                                                     display this help message
  -l, --linter-image       <string>    (default: nafigat0r/golangci-lint:2.9.0)  Linter docker image
  -m, --module-name        <string>    (default: github.com/test/test)           Go module name
  -n, --name               <string>    (default: test)                           Project short name
  -t, --shutdown-timeout   <duration>  (default: 10s)                            Timeout for graceful shutdown
  -v, --version                                                                  display version
  -r, --with-rest          <bool>      (default: false)                          Add HTTP server with REST API functionality

ENVIRONMENT
  GHOST_DESCRIPTION        <string>    (default: Go microservice)                Project short description
  GHOST_GO_IMAGE           <string>    (default: nafigat0r/go:1.26.0)            Go docker image
  GHOST_GOVULNCHECK_IMAGE  <string>    (default: nafigat0r/govulncheck:1.1.4)    Govulncheck docker image
  GHOST_LINTER_IMAGE       <string>    (default: nafigat0r/golangci-lint:2.9.0)  Linter docker image
  GHOST_MODULE_NAME        <string>    (default: github.com/test/test)           Go module name
  GHOST_NAME               <string>    (default: test)                           Project short name
  GHOST_SHUTDOWN_TIMEOUT   <duration>  (default: 10s)                            Timeout for graceful shutdown
  GHOST_WITH_REST          <bool>      (default: false)                          Add HTTP server with REST API functionality

Create REST microservice in dir

$ ghost -r dir
2026-09-19 15:26:46.005	INFO	config/config.go:60	Initial config:
    --args=[dir]
    --build=develop
    --desc=GHOST (Go High-level Open Service Templater)
    --description=Go microservice
    --go-image=nafigat0r/go:1.26.0
    --govulncheck-image=nafigat0r/govulncheck:1.1.4
    --linter-image=nafigat0r/golangci-lint:2.9.0
    --module-name=github.com/test/test
    --name=test
    --shutdown-timeout=10s
    --with-rest=true
2026-09-19 15:26:46.005	INFO	app/app.go:33	ghost start
2026-09-19 15:26:46.007	INFO	app/app.go:40	ghost shutdown

Docker

Run via docker

docker run \
    -u $(id -u):$(id -g) --rm -ti \
    -v "$(pwd):/var/ghost" \
    nafigat0r/ghost --help

Versioning

This software follows "Semantic Versioning" specifications. The signature of exported package functions is used as a public API. Read more on SemVer.org.