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.

🏗️ Built on Alpine Linux for a minimal, efficient footprint.

✅ 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, linux/arm/v7
✅ Minimal and reproducible container setup with Alpine Linux

🧪 Example Usage

🐚 Docker CLI

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

🐳 Docker Compose

Create a docker-compose.yml:

version: "3.9"
services:
  gorunner:
    image: tordarus/gorunner:latest
    environment:
      GIT_REPO: https://github.com/youruser/your-go-app.git
      GIT_USERNAME: yourusername   # Optional for public repos
      GIT_TOKEN: yourtoken         # Optional for public repos
      APP_PATH: .                  # Optional
      PACKAGES: curl               # Optional

Then run it with:

docker compose up

🔧 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

📦 Docker Hub

👉 Pull the image from Docker Hub: tordarus/gorunner

🔗 Source Repository

View the source code: 👉 https://git.tordarus.net/tordarus/gorunner

Found a bug or have an idea for improvement? 🛠️ Create an issue in the repository.

📄 License

MIT License – feel free to modify and use.

README.md Unescape Escape

🐳 Go Builder & Runner Docker Image