feat: add GitHub Actions workflow for building and releasing binaries

Author: zignd

.github/workflows/release.yml

@@ -0,0 +1,73 @@
+name: Build and Release
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        include:
+          - goos: linux
+            goarch: amd64
+            output_name: hoster
+
+          - goos: linux
+            goarch: arm64
+            output_name: hoster
+
+          - goos: darwin
+            goarch: amd64
+            output_name: hoster
+
+          - goos: darwin
+            goarch: arm64
+            output_name: hoster
+
+          - goos: windows
+            goarch: amd64
+            output_name: hoster.exe
+
+          - goos: windows
+            goarch: arm64
+            output_name: hoster.exe
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.24'
+
+      - name: Build binary
+        env:
+          GOOS: ${{ matrix.goos }}
+          GOARCH: ${{ matrix.goarch }}
+          CGO_ENABLED: 0
+        run: |
+          go build \
+            -ldflags="-X main.Version=${{ github.event.release.tag_name }}" \
+            -o ${{ matrix.output_name }} \
+            main.go
+
+      - name: Create archive (Linux/macOS)
+        if: matrix.goos != 'windows'
+        run: |
+          tar -czf hoster_${{ matrix.goos }}_${{ matrix.goarch }}.tar.gz ${{ matrix.output_name }}
+
+      - name: Create archive (Windows)
+        if: matrix.goos == 'windows'
+        shell: pwsh
+        run: |
+          Compress-Archive -Path ${{ matrix.output_name }} -DestinationPath hoster_${{ matrix.goos }}_${{ matrix.goarch }}.zip
+
+      - name: Upload to release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: |
+            hoster_${{ matrix.goos }}_${{ matrix.goarch }}.*
+        env:
+          GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}

README.md

@@ -22,11 +22,53 @@ Docker Hoster watches for container lifecycle events and automatically:
 
 ### Prerequisites
 
-- Go 1.16 or higher
 - Docker running on the system
 - Root/sudo access (required to modify `/etc/hosts`)
 
-### Build from Source
+### Option 1: Download Pre-built Binary (Recommended)
+
+Pre-built binaries are available for Linux, macOS, and Windows on the [releases page](https://github.com/zignd/hoster/releases).
+
+**For Linux/macOS:**
+
+```bash
+# Download the appropriate binary for your platform
+# For Linux x86_64:
+wget https://github.com/zignd/hoster/releases/download/vX.Y.Z/hoster_linux_amd64.tar.gz
+tar -xzf hoster_linux_amd64.tar.gz
+
+# For Linux ARM64:
+wget https://github.com/zignd/hoster/releases/download/vX.Y.Z/hoster_linux_arm64.tar.gz
+tar -xzf hoster_linux_arm64.tar.gz
+
+# For macOS Intel (x86_64):
+wget https://github.com/zignd/hoster/releases/download/vX.Y.Z/hoster_darwin_amd64.tar.gz
+tar -xzf hoster_darwin_amd64.tar.gz
+
+# For macOS Apple Silicon (ARM64):
+wget https://github.com/zignd/hoster/releases/download/vX.Y.Z/hoster_darwin_arm64.tar.gz
+tar -xzf hoster_darwin_arm64.tar.gz
+
+# Make it executable
+chmod +x hoster
+
+# Optionally, move to a location in your PATH
+sudo mv hoster /usr/local/bin/
+```
+
+**For Windows:**
+
+Download the `.zip` file for your architecture from the [releases page](https://github.com/zignd/hoster/releases), extract it, and place the executable in your preferred location or add it to your PATH.
+
+**Check the installed version:**
+
+```bash
+hoster --version
+```
+
+### Option 2: Build from Source
+
+Requires Go 1.16 or higher.
 
 ```bash
 git clone <repository-url>
@@ -42,27 +84,36 @@ go build -o hoster main.go
 Run with default settings (requires root):
 
 ```bash
-sudo ./hoster
+sudo hoster
 ```
 
+**Note:** If you haven't moved the binary to a directory in your PATH, use `./hoster` instead when running from the current directory.
+
 ### Command Line Options
 
 View all available options:
 
 ```bash
-./hoster --help
+hoster --help
+```
+
+Check the version:
+
+```bash
+hoster --version
 ```
 
 Available flags:
 
-- `--help` - Display help message and exit
+- `--help` - Show help message with usage examples and exit
+- `--version` - Display version information and exit
 - `--hosts <path>` - Path to the hosts file (default: `/etc/hosts`)
 - `--socket <path>` - Path to the Docker socket (default: `/var/run/docker.sock`)
 
 Example with custom paths:
 
 ```bash
-sudo ./hoster --hosts /custom/hosts --socket /var/run/docker.sock
+sudo hoster --hosts /custom/hosts --socket /var/run/docker.sock
 ```
 
 ### Running as a Service
@@ -226,14 +277,6 @@ docker run -d --name test nginx
 grep test /etc/hosts
 ```
 
-## License
-
-[Add your license here]
-
 ## Contributing
 
 Contributions are welcome! Please feel free to submit issues or pull requests.
-
-## Author
-
-[Add your name/contact here]

main.go

@@ -16,6 +16,8 @@ import (
 	"github.com/docker/docker/client"
 )
 
+var Version = "dev" // Will be overridden at build time
+
 const (
 	enclosingPattern = "#-----------Docker-Hoster-Domains----------\n"
 	defaultHostsPath = "/etc/hosts"
@@ -240,9 +242,15 @@ func main() {
 	hostsPath := flag.String("hosts", defaultHostsPath, "Path to the hosts file")
 	dockerSocket := flag.String("socket", defaultSocket, "Path to the Docker socket")
 	showHelp := flag.Bool("help", false, "Show help message")
+	showVersion := flag.Bool("version", false, "Display version and exit")
 
 	flag.Parse()
 
+	if *showVersion {
+		fmt.Println("hoster version", Version)
+		os.Exit(0)
+	}
+
 	if *showHelp {
 		fmt.Println("Docker Hoster - Automatically manage /etc/hosts entries for Docker containers")
 		fmt.Println()