2025-06-06 14:08:21 +02:00
2025-06-06 14:08:21 +02:00
2025-06-06 14:08:21 +02:00
2025-06-06 14:08:21 +02:00

🐳 Go Builder & Runner Docker Image

This Docker image is designed to download, compile, and run a Go program from a Git repository entirely at container runtime. It supports both public and private repositories and works seamlessly across multiple architectures (amd64, arm64).


Features

  • Clones a Go repository at runtime
  • Supports private Git repositories using .netrc-based auth
  • Builds and runs your Go application
  • Multi-architecture: linux/amd64, linux/arm64
  • Minimal and reproducible container setup

🧪 Example Usage

docker run --rm \
  -e GIT_REPO=https://github.com/youruser/your-go-app.git \
  -e GIT_USERNAME=yourusername \
  -e GIT_TOKEN=yourtoken \
  gorunner:latest

🔧 Environment Variables

Variable Required Description
GIT_REPO Yes The HTTPS Git URL of your Go project
GIT_USERNAME Optional Your Git username (required for private repos)
GIT_TOKEN Optional A personal access token or password (required for private repos)
APP_PATH Optional Relative path to the Go module directory inside the repo (default: .)
PACKAGES Optional Comma-separated list of packages to install with apk before execution

📄 License

MIT License feel free to modify and use.

Description
Clone, build, and execute Go code in a lightweight Alpine container
Readme MIT 37 KiB
Languages
Shell 80.6%
Dockerfile 19.4%