40 lines
1.6 KiB
Markdown
40 lines
1.6 KiB
Markdown
# 🐳 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
|
||
|
||
```bash
|
||
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.
|