feat: initial gitops sample app with metadata dashboard

Author: moabdelazem

.dockerignore

@@ -0,0 +1,4 @@
+.git
+.gitignore
+bin/
+*.md

.env.example

@@ -0,0 +1,2 @@
+PORT=8080
+APP_ENV=development

.gitignore

@@ -0,0 +1,20 @@
+# Binary
+bin/
+
+# Environment
+.env
+*.exe
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Go
+vendor/

Dockerfile

@@ -0,0 +1,36 @@
+FROM golang:1.25-alpine AS builder
+
+ARG VERSION=dev
+ARG GIT_COMMIT=unknown
+ARG BUILD_TIME=unknown
+
+WORKDIR /src
+
+COPY go.mod go.sum ./
+RUN go mod download
+
+COPY . .
+
+RUN CGO_ENABLED=0 GOOS=linux go build \
+    -ldflags="-s -w \
+    -X github.com/moabdelazem/gitops-sample-app/pkg/version.Version=${VERSION} \
+    -X github.com/moabdelazem/gitops-sample-app/pkg/version.GitCommit=${GIT_COMMIT} \
+    -X github.com/moabdelazem/gitops-sample-app/pkg/version.BuildTime=${BUILD_TIME}" \
+    -o /bin/gitops-app ./cmd/main.go
+
+FROM alpine:3.21
+
+RUN apk --no-cache add ca-certificates \
+    && addgroup -S appgroup \
+    && adduser -S appuser -G appgroup
+
+WORKDIR /app
+
+COPY --from=builder /bin/gitops-app .
+COPY --from=builder /src/web ./web
+
+USER appuser
+
+EXPOSE 8080
+
+ENTRYPOINT ["./gitops-app"]

Makefile

@@ -0,0 +1,42 @@
+APP_NAME    := gitops-app
+VERSION     ?= $(shell git describe --tags --always --dirty 2>/dev/null || echo "dev")
+GIT_COMMIT  ?= $(shell git rev-parse --short HEAD 2>/dev/null || echo "unknown")
+BUILD_TIME  ?= $(shell date -u '+%Y-%m-%dT%H:%M:%SZ')
+LDFLAGS     := -s -w \
+               -X github.com/moabdelazem/gitops-sample-app/pkg/version.Version=$(VERSION) \
+               -X github.com/moabdelazem/gitops-sample-app/pkg/version.GitCommit=$(GIT_COMMIT) \
+               -X github.com/moabdelazem/gitops-sample-app/pkg/version.BuildTime=$(BUILD_TIME)
+
+DOCKER_USERNAME := "moabdelazem"
+DOCKER_IMG  := $(APP_NAME)
+DOCKER_TAG  := $(VERSION)
+
+.PHONY: build run clean docker-build docker-run help
+
+build:
+	@echo "Building $(APP_NAME) $(VERSION) ($(GIT_COMMIT))..."
+	go build -ldflags="$(LDFLAGS)" -o bin/$(APP_NAME) ./cmd/main.go
+	@echo "Binary: bin/$(APP_NAME)"
+
+run: build
+	@echo "Starting $(APP_NAME)..."
+	./bin/$(APP_NAME)
+
+clean:
+	@rm -rf bin/
+	@echo "Cleaned."
+
+docker-build:
+	@echo "Building Docker image $(DOCKER_IMG):$(DOCKER_TAG)..."
+	docker build \
+		--build-arg VERSION=$(VERSION) \
+		--build-arg GIT_COMMIT=$(GIT_COMMIT) \
+		--build-arg BUILD_TIME=$(BUILD_TIME) \
+		-t $(DOCKER_USERNAME)/$(DOCKER_IMG):$(DOCKER_TAG) \
+		-t $(DOCKER_USERNAME)/$(DOCKER_IMG):latest .
+
+docker-run:
+	@echo "Running $(DOCKER_IMG):$(DOCKER_TAG)..."
+	docker run --rm -p 8080:8080 \
+		-e APP_ENV=development \
+		$(DOCKER_USERNAME)/$(DOCKER_IMG):$(DOCKER_TAG)

README.md

@@ -0,0 +1,13 @@
+# GitOps Sample App
+
+This app is just for using it in ArgoCD.
+
+Manifests repo: [gitops-sample-app-manifests](https://github.com/moabdelazem/gitops-sample-app-manifests)
+
+## Endpoints
+
+| Endpoint        | Description         |
+| --------------- | ------------------- |
+| `GET /`         | HTML dashboard      |
+| `GET /healthz`  | Health check (JSON) |
+| `GET /api/info` | All metadata (JSON) |

cmd/main.go

@@ -0,0 +1,40 @@
+package main
+
+import (
+	"html/template"
+	"log"
+	"net/http"
+	"path/filepath"
+	"time"
+
+	"github.com/moabdelazem/gitops-sample-app/internal/config"
+	"github.com/moabdelazem/gitops-sample-app/internal/handler"
+)
+
+func main() {
+	cfg := config.Load()
+
+	templatePath := filepath.Join("web", "templates", "index.html")
+	tmpl, err := template.ParseFiles(templatePath)
+	if err != nil {
+		log.Fatalf("failed to parse template %s: %v", templatePath, err)
+	}
+
+	h := handler.New(cfg, tmpl)
+	mux := http.NewServeMux()
+	h.Register(mux)
+
+	log.Printf("server starting on :%s [env=%s]", cfg.Port, cfg.Environment)
+
+	server := &http.Server{
+		Addr:         ":" + cfg.Port,
+		Handler:      mux,
+		ReadTimeout:  5 * time.Second,
+		WriteTimeout: 10 * time.Second,
+		IdleTimeout:  30 * time.Second,
+	}
+
+	if err := server.ListenAndServe(); err != nil {
+		log.Fatalf("server failed: %v", err)
+	}
+}

go.mod

@@ -0,0 +1,5 @@
+module github.com/moabdelazem/gitops-sample-app
+
+go 1.25.7
+
+require github.com/joho/godotenv v1.5.1

go.sum

@@ -0,0 +1,2 @@
+github.com/joho/godotenv v1.5.1 h1:7eLL/+HRGLY0ldzfGMeQkb7vMd0as4CfYvUVzLqw0N0=
+github.com/joho/godotenv v1.5.1/go.mod h1:f4LDr5Voq0i2e/R5DDNOoa2zzDfwtkZa6DnEwAbqwq4=

internal/config/config.go

@@ -0,0 +1,43 @@
+package config
+
+import (
+	"log"
+	"os"
+
+	"github.com/joho/godotenv"
+)
+
+type Config struct {
+	Port        string
+	Environment string
+	PodName     string
+	NodeName    string
+}
+
+func Load() *Config {
+	if err := godotenv.Load(); err != nil {
+		log.Println("No .env file found, reading from environment")
+	}
+
+	return &Config{
+		Port:        getEnv("PORT", "8080"),
+		Environment: getEnv("APP_ENV", "development"),
+		PodName:     getEnv("POD_NAME", getHostname()),
+		NodeName:    getEnv("NODE_NAME", "unknown"),
+	}
+}
+
+func getEnv(key, fallback string) string {
+	if val, ok := os.LookupEnv(key); ok && val != "" {
+		return val
+	}
+	return fallback
+}
+
+func getHostname() string {
+	name, err := os.Hostname()
+	if err != nil {
+		return "unknown"
+	}
+	return name
+}